303 lines
8.4 KiB
HTML
303 lines
8.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XBIFF</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XBIFF</H1>
|
|
Section: User Commands (1)<BR>Updated: xbiff 1.0.4<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xbiff - mailbox flag for X
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xbiff</B>
|
|
|
|
[ -<I>toolkitoption</I> ... ] [ <I>-option</I> ... ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<I>xbiff</I>
|
|
|
|
program displays a little image of a mailbox. When there is no mail,
|
|
the flag on the mailbox is down. When mail arrives, the flag goes up
|
|
and the mailbox beeps. By default, pressing any mouse button in the
|
|
image forces <I>xbiff</I> to remember the current size of the mail file
|
|
as being the ``empty'' size and to lower the flag.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<I>Xbiff</I>
|
|
|
|
accepts all of the standard X Toolkit command line options along with the
|
|
additional options listed below:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-help</B>
|
|
|
|
<DD>
|
|
This option indicates that a brief summary of the allowed options should be
|
|
printed on the standard error.
|
|
<DT id="2"><B>-update </B><I>seconds</I>
|
|
|
|
<DD>
|
|
This option specifies the frequency in seconds at which <I>xbiff</I>
|
|
should update its display. If the mailbox is obscured and then exposed,
|
|
it will be updated immediately. The default is 30 seconds.
|
|
<DT id="3"><B>-file </B><I>filename</I>
|
|
|
|
<DD>
|
|
This option specifies the name of the file which should be monitored. By
|
|
default it watches your inbox in the default location for your
|
|
system (some examples are
|
|
/var/mail/<I>username</I>,
|
|
|
|
/usr/spool/mail/<I>username</I>,
|
|
|
|
/var/spool/mail/<I>username</I>
|
|
|
|
(where
|
|
<I>username</I>
|
|
|
|
is your login name). If the MAIL environment variable is set,
|
|
the file specified by it will be monitored.
|
|
<DT id="4"><B>-volume </B><I>percentage</I>
|
|
|
|
<DD>
|
|
This option specifies how loud the bell should be rung when new mail
|
|
comes in. The percentage is relative to the current volume in <I>xset</I>.
|
|
So 0 is normal volume, negative percentages are towards minimum (-100
|
|
is silent), and positive percentages are towards maximum volume (100
|
|
is loudest).
|
|
<DT id="5"><B>-shape</B>
|
|
|
|
<DD>
|
|
This option indicates that the mailbox window should be shaped if masks for
|
|
the empty or full images are given.
|
|
</DL>
|
|
<P>
|
|
|
|
The following standard X Toolkit command line arguments are commonly used with
|
|
<I>xbiff:</I>
|
|
|
|
<DL COMPACT>
|
|
<DT id="6"><B>-display </B><I>display</I>
|
|
|
|
<DD>
|
|
This option specifies the X server to contact.
|
|
<DT id="7"><B>-geometry </B><I>geometry</I>
|
|
|
|
<DD>
|
|
This option specifies the preferred size and position of the mailbox window.
|
|
The mailbox is 48 pixels wide and 48 pixels high and will be centered in
|
|
the window.
|
|
<DT id="8"><B>-bg </B><I>color</I>
|
|
|
|
<DD>
|
|
This option specifies the color to use for the background of the window.
|
|
<DT id="9"><B>-bd </B><I>color</I>
|
|
|
|
<DD>
|
|
This option specifies the color to use for the border of the window.
|
|
<DT id="10"><B>-bw </B><I>number</I>
|
|
|
|
<DD>
|
|
This option specifies the width in pixels of the border surrounding the window.
|
|
<DT id="11"><B>-fg </B><I>color</I>
|
|
|
|
<DD>
|
|
This option specifies the color to use for the foreground of the window.
|
|
<DT id="12"><B>-rv</B>
|
|
|
|
<DD>
|
|
This option indicates that reverse video should be simulated by swapping
|
|
the foreground and background colors.
|
|
<DT id="13"><B>-xrm </B><I>resourcestring</I>
|
|
|
|
<DD>
|
|
This option specifies a resource string to be used. This is especially
|
|
useful for setting resources that do not have separate command line options.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>X DEFAULTS</H2>
|
|
|
|
The application class name is XBiff.
|
|
This program uses the
|
|
<I>Mailbox</I>
|
|
|
|
widget.
|
|
It understands all of the core resource names and
|
|
classes as well as:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14"><B>checkCommand (</B>class<B> CheckCommand)</B>
|
|
|
|
<DD>
|
|
Specifies a shell command to be executed to check for new mail rather than
|
|
examining the size of <B>file</B>. The specified string value is used as the
|
|
argument to a <I><A HREF="/cgi-bin/man/man2html?3+system">system</A></I>(3) call and may therefore contain i/o redirection.
|
|
An exit status of 0 indicates that new mail is waiting, 1 indicates that there
|
|
has been no change in size, and 2 indicates that the mail has been cleared.
|
|
By default, no shell command is provided.
|
|
<DT id="15"><B>file (</B>class<B> File)</B>
|
|
|
|
<DD>
|
|
Specifies the name of the file to monitor. The default is as described
|
|
above for the
|
|
<B>-file</B>
|
|
|
|
command line option.
|
|
<DT id="16"><B>onceOnly (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies that the bell is only rung the first time new mail is found
|
|
and is not rung again until at least one interval has passed with
|
|
no mail waiting. The window will continue to indicate the presence
|
|
of new mail until it has been retrieved. The default is false.
|
|
<DT id="17"><B>width (</B>class<B> Width)</B>
|
|
|
|
<DD>
|
|
Specifies the width of the mailbox.
|
|
<DT id="18"><B>height (</B>class<B> Height)</B>
|
|
|
|
<DD>
|
|
Specifies the height of the mailbox.
|
|
<DT id="19"><B>update (</B>class<B> Interval)</B>
|
|
|
|
<DD>
|
|
Specifies the frequency in seconds at which the mail should be checked.
|
|
The default is 30.
|
|
<DT id="20"><B>volume (</B>class<B> Volume)</B>
|
|
|
|
<DD>
|
|
Specifies how loud the bell should be rung. The default is 33 percent.
|
|
Note that this is a percentage of the current <I>xset</I> volume.
|
|
To reduce the volume, specify a negative percentage.
|
|
<DT id="21"><B>foreground (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
Specifies the color for the foreground.
|
|
<DT id="22"><B>reverseVideo (</B>class<B> ReverseVideo)</B>
|
|
|
|
<DD>
|
|
Specifies that the foreground and background should be reversed.
|
|
<DT id="23"><B>flip (</B>class<B> Flip)</B>
|
|
|
|
<DD>
|
|
Specifies whether or not the image that is shown when mail has arrived
|
|
should be inverted. The default is ``true.''
|
|
<DT id="24"><B>fullPixmap (</B>class<B> Pixmap)</B>
|
|
|
|
<DD>
|
|
Specifies a bitmap to be shown when new mail has arrived.
|
|
The default is flagup.
|
|
<DT id="25"><B>emptyPixmap (</B>class<B> Pixmap)</B>
|
|
|
|
<DD>
|
|
Specifies a bitmap to be shown when no new mail is present.
|
|
The default is flagdown.
|
|
<DT id="26"><B>shapeWindow (</B>class<B> ShapeWindow)</B>
|
|
|
|
<DD>
|
|
Specifies whether or not the mailbox window should be shaped to the
|
|
given fullPixmapMask and emptyPixmapMask. The default is false.
|
|
<DT id="27"><B>fullPixmapMask (</B>class<B> PixmapMask)</B>
|
|
|
|
<DD>
|
|
Specifies a mask for the bitmap to be shown when new mail has arrived.
|
|
The default is none.
|
|
<DT id="28"><B>emptyPixmapMask (</B>class<B> PixmapMask)</B>
|
|
|
|
<DD>
|
|
Specifies a mask for the bitmap to be shown when no new mail is present.
|
|
The default is none.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ACTIONS</H2>
|
|
|
|
The <I>Mailbox</I> widget provides the following actions for use in event
|
|
translations:
|
|
<DL COMPACT>
|
|
<DT id="29"><B>check()</B>
|
|
|
|
<DD>
|
|
This action causes the widget to check for new mail and display the flag
|
|
appropriately.
|
|
<DT id="30"><B>unset()</B>
|
|
|
|
<DD>
|
|
This action causes the widget to lower the flag until new mail comes in.
|
|
<DT id="31"><B>set()</B>
|
|
|
|
<DD>
|
|
This action causes the widget to raise the flag until the user resets it.
|
|
</DL>
|
|
<P>
|
|
|
|
The default translation is
|
|
<P>
|
|
<PRE>
|
|
<ButtonPress>: unset()
|
|
</PRE>
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="32"><B>DISPLAY</B>
|
|
|
|
<DD>
|
|
to get the default host and display number.
|
|
<DT id="33"><B>XENVIRONMENT</B>
|
|
|
|
<DD>
|
|
to get the name of a resource file that overrides the global resources
|
|
stored in the RESOURCE_MANAGER property.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7),
|
|
<A HREF="/cgi-bin/man/man2html?1+xrdb">xrdb</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?2+stat">stat</A>(2)
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
The mailbox bitmaps are ugly.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Jim Fulton, MIT X Consortium
|
|
<BR>
|
|
|
|
Additional hacks by Ralph Swick, DEC/MIT Project Athena
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="34"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="35"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="36"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="37"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="38"><A HREF="#lbAF">X DEFAULTS</A><DD>
|
|
<DT id="39"><A HREF="#lbAG">ACTIONS</A><DD>
|
|
<DT id="40"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="41"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="42"><A HREF="#lbAJ">BUGS</A><DD>
|
|
<DT id="43"><A HREF="#lbAK">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:30 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|