223 lines
7.8 KiB
Groff
223 lines
7.8 KiB
Groff
.\" $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: xc/programs/xbiff/xbiff.man,v 1.3 2001/01/27 18:21:08 dawes Exp $
|
|
.\"
|
|
.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. The percentage is relative to the current volume in \fIxset\fP.
|
|
So 0 is normal volume, negative percentages are towards minimum (-100
|
|
is silent), and positive percentages are towards maximum volume (100
|
|
is loudest).
|
|
.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(__libmansuffix__) 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.
|
|
Note that this is a percentage of the current \fIxset\fP volume.
|
|
To reduce the volume, specify a negative percentage.
|
|
.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
|
|
<ButtonPress>: 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(__appmansuffix__),
|
|
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
|