.\" $XConsortium: xbiff.man,v 1.22 94/04/17 20:43:28 gildea Exp $ .\" Copyright (c) 1988 X Consortium .\" .\" Permission is hereby granted, free of charge, to any person obtaining .\" a copy of this software and associated documentation files (the .\" "Software"), to deal in the Software without restriction, including .\" without limitation the rights to use, copy, modify, merge, publish, .\" distribute, sublicense, and/or sell copies of the Software, and to .\" permit persons to whom the Software is furnished to do so, subject to .\" the following conditions: .\" .\" The above copyright notice and this permission notice shall be included .\" in all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. .\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR .\" OTHER DEALINGS IN THE SOFTWARE. .\" .\" Except as contained in this notice, the name of the X Consortium shall .\" not be used in advertising or otherwise to promote the sale, use or .\" other dealings in this Software without prior written authorization .\" from the X Consortium. .\" .\" $XFree86$ .\" .TH XBIFF 1 __xorgversion__ .SH NAME xbiff \- mailbox flag for X .SH SYNOPSIS .B xbiff [ \-\fItoolkitoption\fP ... ] [ \fI\-option\fP ... ] .SH DESCRIPTION The .I 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 \fIxbiff\fP to remember the current size of the mail file as being the ``empty'' size and to lower the flag. .SH OPTIONS .I Xbiff accepts all of the standard X Toolkit command line options along with the additional options listed below: .TP 8 .B \-help This option indicates that a brief summary of the allowed options should be printed on the standard error. .TP 8 .B \-update \fIseconds\fP This option specifies the frequency in seconds at which \fIxbiff\fP should update its display. If the mailbox is obscured and then exposed, it will be updated immediately. The default is 30 seconds. .TP 8 .B \-file \fIfilename\fP 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 .RI /var/mail/ username , .RI /usr/spool/mail/ username , .RI /var/spool/mail/ username (where .I username is your login name). If the MAIL environment variable is set, the file specified by it will be monitored. .TP 8 .B \-volume \fIpercentage\fP This option specifies how loud the bell should be rung when new mail comes in. .TP 8 .B \-shape This option indicates that the mailbox window should be shaped if masks for the empty or full images are given. .PP The following standard X Toolkit command line arguments are commonly used with .I xbiff: .TP 8 .B \-display \fIdisplay\fP This option specifies the X server to contact. .TP 8 .B \-geometry \fIgeometry\fP 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. .TP 8 .B \-bg \fIcolor\fP This option specifies the color to use for the background of the window. .TP 8 .B \-bd \fIcolor\fP This option specifies the color to use for the border of the window. .TP 8 .B \-bw \fInumber\fP This option specifies the width in pixels of the border surrounding the window. .TP 8 .B \-fg \fIcolor\fP This option specifies the color to use for the foreground of the window. .TP 8 .B \-rv This option indicates that reverse video should be simulated by swapping the foreground and background colors. .TP 8 .B \-xrm \fIresourcestring\fP This option specifies a resource string to be used. This is especially useful for setting resources that do not have separate command line options. .SH X DEFAULTS The application class name is XBiff. This program uses the .I Mailbox widget. It understands all of the core resource names and classes as well as: .PP .TP 8 .B checkCommand (\fPclass\fB CheckCommand) Specifies a shell command to be executed to check for new mail rather than examining the size of \fBfile\fP. The specified string value is used as the argument to a \fIsystem\fP(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. .TP 8 .B file (\fPclass\fB File) Specifies the name of the file to monitor. The default is as described above for the .B \-file command line option. .TP 8 .B onceOnly (\fPclass\fB Boolean) 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. .TP 8 .B width (\fPclass\fB Width) Specifies the width of the mailbox. .TP 8 .B height (\fPclass\fB Height) Specifies the height of the mailbox. .TP 8 .B update (\fPclass\fB Interval) Specifies the frequency in seconds at which the mail should be checked. The default is 30. .TP 8 .B volume (\fPclass\fB Volume) Specifies how loud the bell should be rung. The default is 33 percent. .TP 8 .B foreground (\fPclass\fB Foreground) Specifies the color for the foreground. .TP 8 .B reverseVideo (\fPclass\fB ReverseVideo) Specifies that the foreground and background should be reversed. .TP 8 .B flip (\fPclass\fB Flip) Specifies whether or not the image that is shown when mail has arrived should be inverted. The default is ``true.'' .TP 8 .B fullPixmap (\fPclass\fB Pixmap) Specifies a bitmap to be shown when new mail has arrived. The default is flagup. .TP 8 .B emptyPixmap (\fPclass\fB Pixmap) Specifies a bitmap to be shown when no new mail is present. The default is flagdown. .TP 8 .B shapeWindow (\fPclass\fB ShapeWindow) Specifies whether or not the mailbox window should be shaped to the given fullPixmapMask and emptyPixmapMask. The default is false. .TP 8 .B fullPixmapMask (\fPclass\fB PixmapMask) Specifies a mask for the bitmap to be shown when new mail has arrived. The default is none. .TP 8 .B emptyPixmapMask (\fPclass\fB PixmapMask) Specifies a mask for the bitmap to be shown when no new mail is present. The default is none. .SH ACTIONS The \fIMailbox\fP widget provides the following actions for use in event translations: .TP 8 .B check() This action causes the widget to check for new mail and display the flag appropriately. .TP 8 .B unset() This action causes the widget to lower the flag until new mail comes in. .TP 8 .B set() This action causes the widget to raise the flag until the user resets it. .PP The default translation is .sp .nf : unset() .fi .sp .SH ENVIRONMENT .PP .TP 8 .B DISPLAY to get the default host and display number. .TP 8 .B XENVIRONMENT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. .SH "SEE ALSO" X(__miscmansuffix__), xrdb(1), stat(2) .SH BUGS The mailbox bitmaps are ugly. .SH AUTHOR Jim Fulton, MIT X Consortium .br Additional hacks by Ralph Swick, DEC/MIT Project Athena