XLBIFF(1)                UNIX System V(4 October 1991)                XLBIFF(1)


NAME
      xlbiff - mailbox message previewer for X

SYNOPSIS
      xlbiff [ -option ... ]

DESCRIPTION
      The xlbiff program lurks in the background, watching your mailbox file,
      waiting for new mail.  When mail arrives, it invokes the MH scan(1)
      command and pops up a window with the results.  Clicking the left mouse
      button anywhere in this window makes it go away.  The window will also
      disappear if iconified or if the mailbox size drops to zero.

OPTIONS
      Xlbiff accepts all of the standard X Toolkit command line options along
      with the additional options listed below:

      -help   This option indicates that a brief summary of the allowed options
              should be printed on standard output.

      -bottom This option tells xlbiff to realize/unrealize() the output window
              instead of using XtPopup/down().  This has the effect of causing
              the window manager to reposition the window each time it pops up,
              and is useful for when you specify negative Y coordinates, ie, at
              the bottom of the screen.  Running xlbiff in this situation
              without -bottom would cause new lines to run off the bottom edge
              of the screen.

      +bottom Opposite of -bottom.

      -file filename
              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.

      -rows height
              This option specifies the maximum height, in lines of text, of
              the xlbiff window.  The default is 20.

      -columns width
              This option specifies the maximum width, in characters, of the
              xlbiff window.  The default is 80.

      -resetSaver
              If this option is set, xlbiff will reset the screen saver when
              new mail comes in.  This is useful if you're doing something near
              your workstation but not on it.

      +resetSaver
              Opposite of -resetSaver.




10/89                                                                    Page 1

XLBIFF(1)                UNIX System V(4 October 1991)                XLBIFF(1)


      -update seconds
              This option specifies the frequency in seconds at which xlbiff
              should update its display.  The default is 15 seconds.

      -volume percentage
              This option specifies how loud the bell should be rung when new
              mail comes in.

      The following standard X Toolkit command line arguments are commonly used
      with xlbiff:

      -display display
              This option specifies the X server to contact.

      -geometry +x+y
              This option specifies the preferred position of the scan window.

      -bg color
              This option specifies the color to use for the background of the
              window.

      -fg color
              This option specifies the color to use for the foreground of the
              window.

      -xrm resourcestring
              This option specifies a resource string to be used.  This is
              especially useful for setting resources that do not have separate
              command line options.

RESOURCES
      The application class name is XLbiff.  It understands all of the core
      resource names and classes as well as:

      bottom (class Bottom)
              Same as the -bottom option.

      file (class File)
              Same as the -file option.

      scanCommand (class ScanCommand)
              Specifies a shell command to be executed to list the contents of
              mailbox file.  The specified string value is used as the argument
              to a system(3) call and may therefore contain i/o redirection.
              The command's stdout is used to generate the window. Internally,
              the command is generated as

                            sprintf(buf, scanCommand, file, columns)

              so a %s and %d respectively in scanCommand will generate the
              values of file and columns.



Page 2                                                                    10/89

XLBIFF(1)                UNIX System V(4 October 1991)                XLBIFF(1)


      resetSaver (class ResetSaver)
              Same as the -resetSaver option.

      update (class Interval)
              Same as the -update option.

      columns (class Columns)
              Same as the -columns option.

      rows (class Rows)
              Specifies the maximum height, in lines, of the xlbiff window.
              The default is 20.

      volume (class Volume)
              Same as the -volume option.

ACTIONS
      Xlbiff provides the following actions for use in event translations:

      popdown()
              This action causes the window to vanish.

      exit()  This action causes xlbiff to exit.

      The default translations are

              <Button1Press>:  popdown()
              <Button3Press>:  exit()


ENVIRONMENT
      DISPLAY is used to get the default host and display number.

FILES
      /usr/spool/mail/username
              default mail file to check.

SEE ALSO
      X(1), scan(1)

BUGS
      specifying dimensions in -geometry causes badness.

COPYRIGHT
      Copyright 1991, Digital Equipment Corporation.  See the source code for a
      full statement of rights and permissions.

AUTHOR
      Ed Santiago, santiago@pa.dec.com





10/89                                                                    Page 3

XLBIFF(1)                UNIX System V(4 October 1991)                XLBIFF(1)


ACKNOWLEDGEMENTS
      Xlbiff took shape around the xgoodbye sample program in the O'Reilly X
      Toolkit Intrinsics Programming Manual.  A lot of code was stolen from
      xbiff, including this man page.  Thanks also to Stephen Gildea
      (gildea@expo.lcs.mit.edu) for the many, many contributions that made
      xlbiff grow from a midnight hack to a more mature product.
















































Page 4                                                                    10/89