xbiff(X) X Version 11 (11 July 1990) xbiff(X)
NAME
xbiff - mailbox flag for X
SYNOPSIS
xbiff [-options...]
DESCRIPTION
The xbiff program displays a little image of a mailbox.
When the mailbox is empty, the flag on the mailbox is down.
When mail arrives, the flag goes up and the mailbox beeps.
By default, if you press any mouse button in the image,
xbiff remembers the current size of the mail file as being
empty and lowers the flag.
OPTIONS
xbiff accepts all of the standard X Toolkit command-line
options along with the additional options listed below:
-help
Prints a brief summary of the allowed options on the
standard error.
-update seconds
Specifies how frequently in seconds xbiff updates its
display. If the mailbox is obscured and then exposed,
it is updated immediately. The default is 30 seconds.
-file filename
Specifies the file to be monitored. By default, xbiff
watches /usr/spool/mail/username, where username is
your login name.
-volume percentage
Specifies how loud the bell should ring when new mail
comes in.
The following standard X Toolkit command-line arguments are
commonly used with xbiff:
-display display
This option specifies the X server to contact.
-geometry geometry
Specifies the preferred size and position of the
mailbox window. By default, the mailbox is 48 pixels
wide, 48 pixels high and centered in the window.
-bg color
Specifies the color for the window background. The
default is "white."
-bd color
Page 1 (printed 7/3/90)
xbiff(X) X Version 11 (11 July 1990) xbiff(X)
Specifies the color for the window border. The default
is "black."
-bw number
Specifies the width of the window border in pixels.
The default is 2.
-fg color
Specifies the color for the window foreground. The
default is "black."
-rv Simulates reverse video by swapping the foreground and
background colors.
-xrm resourcestring
Specifies a resource string to use. This is especially
useful for setting resources that do not have separate
command-line options.
X DEFAULTS
This program uses the Mailbox widget in the X Toolkit. It
understands all of the core resource names and classes as
well as the following:
checkCommand (class CheckCommand)
Specifies a shell command to check for new mail rather
than examining the size of file. The specified string
value is used as the argument to a system(3) call and
may contain I/O redirection. A successful (zero) exit
status indicates when new mail is waiting.
file (class File)
Specifies the name of the file to monitor. The default
is to watch /usr/spool/mail/username, where username is
your login name.
onceOnly (class Boolean)
Specifies that the bell rings only the first time new
mail is found and does not ring again until at least
one interval has passed with no mail waiting. The
window continues to indicate the presence of new mail
until you retrieve it.
width (class Width)
Specifies the width of the mailbox.
height (class Height)
Specifies the height of the mailbox.
update (class Interval)
Specifies how frequently in seconds the mail should be
checked.
Page 2 (printed 7/3/90)
xbiff(X) X Version 11 (11 July 1990) xbiff(X)
volume (class Volume)
Specifies how loud the bell should ring. The default
is 33 percent.
foreground (class Foreground)
Specifies the foreground color. The default is "black"
since the core default for background is "white."
reverseVideo (class ReverseVideo)
Switches the foreground and background colors.
ACTIONS
The Mailbox widget provides the following actions for event
translations:
check()
Causes the widget to check for new mail and display the
flag appropriately.
unset()
Causes the widget to lower the flag until new mail
comes in.
set()
Causes the widget to raise the flag until you reset it.
The default translation is as follows:
<ButtonPress>: unset()
ENVIRONMENT
DISPLAY
Gets the default host and display number.
XENVIRONMENT
Gets the name of a resource file that overrides the
global resources stored in the RESOURCE_MANAGER
property.
SEE ALSO
X(X)
xrdb(X)
COPYRIGHT
Copyright 1988, Massachusetts Institute of Technology.
See X(X) for a full statement of rights and permissions.
AUTHOR
Jim Fulton, MIT X Consortium; Ralph Swick, DEC/MIT Project
Athena.
Page 3 (printed 7/3/90)