xbiff(1X)																 xbiff(1X)

NAME

       xbiff - mailbox flag for X

SYNOPSIS

       xbiff [-toolkitoption...] [-option ...]

OPTIONS

       xbiff accepts all of the standard X Toolkit command line options along with the additional options listed below: This option indicates that
       a brief summary of the allowed options should be printed on the standard error.	This option specifies the frequency in	seconds  at  which
       xbiff  should update its display.  If the mailbox is obscured and then exposed, it will be updated immediately.	The default is 30 seconds.
       This option specifies the name of the file which should be monitored.  By default, it watches /usr/spool/mail/username, where  username	is
       your  login  name.   This option specifies how loud the bell should be rung when new mail comes in.  This option indicates that the mailbox
       window should be shaped if masks for the empty or full images are given.

       The following standard X Toolkit command line arguments are commonly used with xbiff: This option specifies the X server to contact.   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 cen-
       tered in the window.  This option specifies the color to use for the background of the window.  This option specifies the color to use  for
       the border of the window.  This option specifies the width in pixels of the border surrounding the window.  This option specifies the color
       to use for the foreground of the window.  This option indicates that reverse video should be simulated by swapping the foreground and back-
       ground colors.  This option specifies a resource string to be used.  This is especially useful for setting resources that do not have sepa-
       rate command line options.

DESCRIPTION

       The xbiff 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 xbiff to remember the current size of the
       mail file as being the "empty" size and to lower the flag.

X DEFAULTS

       The application class name is XBiff. This program uses the Mailbox widget. It understands all of the core resource  names  and  classes	as
       well as: Specifies a shell command to be executed 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 therefore contain i/o redirection. An exit status of 0 indicates that new mail is wait-
       ing,  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.  Specifies the name of the file to monitor.  The default is to watch /usr/spool/mail/username, where username is your login name.
       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.  Specifies
       the  width  of  the mailbox.  Specifies the height of the mailbox.  Specifies the frequency in seconds at which the mail should be checked.
       The default is 30.  Specifies how loud the bell should be rung.	The default is 33 percent.  Specifies the color for the foreground.  Spec-
       ifies that the foreground and background should be reversed.  Specifies whether or not the image that is shown when mail has arrived should
       be inverted.  The default is "true."  Specifies a bitmap to be shown when new mail has arrived.	The default is flagup.	Specifies a bitmap
       to  be  shown  when  no new mail is present.  The default is flagdown.  Specifies whether or not the mailbox window should be shaped to the
       given fullPixmapMask and emptyPixmapMask.  The default is false.  Specifies a mask for the bitmap to be shown when new  mail  has  arrived.
       The default is none.  Specifies a mask for the bitmap to be shown when no new mail is present. The default is none.

ACTIONS

       The  Mailbox  widget  provides the following actions for use in event translations: This action causes the widget to check for new mail and
       display the flag appropriately.	This action causes the widget to lower the flag until new mail comes in.  This action causes the widget to
       raise the flag until the user resets it.

       The default translation is
	    <ButtonPress>:  unset()

ENVIRONMENT

       to  get	the  default  host  and  display  number.   to	get  the name of a resource file that overrides the global resources stored in the
       RESOURCE_MANAGER property.

BUGS

       The mailbox bitmaps are ugly.

SEE ALSO

       X(1X), xrdb(1X), stat(2)

AUTHOR

       Jim Fulton, MIT X Consortium

       Additional hacks by Ralph Swick, DEC/MIT Project Athena

																	 xbiff(1X)