NAME

xbiff - mailbox flag for X

SYNOPSIS

xbiff [ -_t_o_o_l_k_i_t_o_p_t_i_o_n ... ] [ _-_o_p_t_i_o_n ... ]

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 _x_b_i_f_f to remember the current size of the mail file as being the ``empty'' size and to lower the flag.

OPTIONS

Xbiff 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 the standard error.
-update _s_e_c_o_n_d_s
This option specifies the frequency in seconds at which _x_b_i_f_f should update its display. If the mailbox is obscured and then exposed, it will be updated immediately. The default is 30 seconds.
-file _f_i_l_e_n_a_m_e
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 (where username is your login name). If the MAIL environment variable is set, the file specified by it will be monitored.
-volume _p_e_r_c_e_n_t_a_g_e
This option specifies how loud the bell should be rung when new mail comes in.
-shape
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:

-display _d_i_s_p_l_a_y
This option specifies the X server to contact.
-geometry _g_e_o_m_e_t_r_y
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.
-bg _c_o_l_o_r
This option specifies the color to use for the background of the window.
-bd _c_o_l_o_r
This option specifies the color to use for the border of the window.
-bw _n_u_m_b_e_r
This option specifies the width in pixels of the border surrounding the window.
-fg _c_o_l_o_r
This option specifies the color to use for the foreground of the window.
-rv
This option indicates that reverse video should be simulated by swapping the foreground and background colors.
-xrm _r_e_s_o_u_r_c_e_s_t_r_i_n_g
This option specifies a resource string to be used. This is especially useful for setting resources that do not have separate command line options.

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:

checkCommand (_c_l_a_s_s CChheecckkCCoommmmaanndd))<> <> SSppeecciiffiieess aa sshheellll ccoommmmaanndd ttoo bbee eexxeeccuutteedd ttoo cchheecckk ffoorr nneeww mmaaiill rraatthheerr tthhaann eexxaammiinniinngg tthhee ssiizzee ooff ffiillee.. TThhee ssppeecciiffiieedd ssttrriinngg vvaalluuee iiss uusseedd aass tthhee aarrgguummeenntt ttoo aa _s_y_s_t_e_m((33)) ccaallll aanndd mmaayy tthheerreeffoorree ccoonnttaaiinn ii//oo rreeddiirreeccttiioonn.. AAnn eexxiitt ssttaattuuss ooff 00 iinnddiiccaatteess tthhaatt nneeww mmaaiill iiss wwaaiittiinngg,, 11 iinnddiiccaatteess tthhaatt tthheerree hhaass bbeeeenn nnoo cchhaannggee iinn ssiizzee,, aanndd 22 iinnddiiccaatteess tthhaatt tthhee mmaaiill hhaass bbeeeenn cclleeaarreedd.. BByy ddeeffaauulltt,, nnoo sshheellll ccoommmmaanndd iiss pprroovviiddeedd.. <> <>ffiillee ((_c_l_a_s_s FFiillee))<> <> SSppeecciiffiieess tthhee nnaammee ooff tthhee ffiillee ttoo mmoonniittoorr.. TThhee ddeeffaauulltt iiss aass ddeessccrriibbeedd aabboovvee ffoorr tthhee <>--ffiillee<> ccoommmmaanndd lliinnee ooppttiioonn.. <> <>oonncceeOOnnllyy ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess tthhaatt tthhee bbeellll iiss oonnllyy rruunngg tthhee ffiirrsstt ttiimmee nneeww mmaaiill iiss ffoouunndd aanndd iiss nnoott rruunngg aaggaaiinn uunnttiill aatt lleeaasstt oonnee iinntteerrvvaall hhaass ppaasssseedd wwiitthh nnoo mmaaiill wwaaiittiinngg.. TThhee wwiinnddooww wwiillll ccoonnttiinnuuee ttoo iinnddiiccaattee tthhee pprreesseennccee ooff nneeww mmaaiill uunnttiill iitt hhaass bbeeeenn rreettrriieevveedd.. TThhee ddeeffaauulltt iiss ffaallssee.. <> <>wwiiddtthh ((_c_l_a_s_s WWiiddtthh))<> <> SSppeecciiffiieess tthhee wwiiddtthh ooff tthhee mmaaiillbbooxx.. <> <>hheeiigghhtt ((_c_l_a_s_s HHeeiigghhtt))<> <> SSppeecciiffiieess tthhee hheeiigghhtt ooff tthhee mmaaiillbbooxx.. <> <>uuppddaattee ((_c_l_a_s_s IInntteerrvvaall))<> <> SSppeecciiffiieess tthhee ffrreeqquueennccyy iinn sseeccoonnddss aatt wwhhiicchh tthhee mmaaiill sshhoouulldd bbee cchheecckkeedd.. TThhee ddeeffaauulltt iiss 3300.. <> <>vvoolluummee ((_c_l_a_s_s VVoolluummee))<> <> SSppeecciiffiieess hhooww lloouudd tthhee bbeellll sshhoouulldd bbee rruunngg.. TThhee ddeeffaauulltt iiss 3333 ppeerrcceenntt.. <> <>ffoorreeggrroouunndd ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> SSppeecciiffiieess tthhee ccoolloorr ffoorr tthhee ffoorreeggrroouunndd.. <> <>rreevveerrsseeVViiddeeoo ((_c_l_a_s_s RReevveerrsseeVViiddeeoo))<> <> SSppeecciiffiieess tthhaatt tthhee ffoorreeggrroouunndd aanndd bbaacckkggrroouunndd sshhoouulldd bbee rreevveerrsseedd.. <> <>fflliipp ((_c_l_a_s_s FFlliipp))<> <> SSppeecciiffiieess wwhheetthheerr oorr nnoott tthhee iimmaaggee tthhaatt iiss sshhoowwnn wwhheenn mmaaiill hhaass aarrrriivveedd sshhoouulldd bbee iinnvveerrtteedd.. TThhee ddeeffaauulltt iiss ````ttrruuee..'''' <> <>ffuullllPPiixxmmaapp ((_c_l_a_s_s PPiixxmmaapp))<> <> SSppeecciiffiieess aa bbiittmmaapp ttoo bbee sshhoowwnn wwhheenn nneeww mmaaiill hhaass aarrrriivveedd.. TThhee ddeeffaauulltt iiss ffllaagguupp.. <> <>eemmppttyyPPiixxmmaapp ((_c_l_a_s_s PPiixxmmaapp))<> <> SSppeecciiffiieess aa bbiittmmaapp ttoo bbee sshhoowwnn wwhheenn nnoo nneeww mmaaiill iiss pprreesseenntt.. TThhee ddeeffaauulltt iiss ffllaaggddoowwnn.. <> <>sshhaappeeWWiinnddooww ((_c_l_a_s_s SShhaappeeWWiinnddooww))<> <> SSppeecciiffiieess wwhheetthheerr oorr nnoott tthhee mmaaiillbbooxx wwiinnddooww sshhoouulldd bbee sshhaappeedd ttoo tthhee ggiivveenn ffuullllPPiixxmmaappMMaasskk aanndd eemmppttyyPPiixxmmaappMMaasskk.. TThhee ddeeffaauulltt iiss ffaallssee.. <> <>ffuullllPPiixxmmaappMMaasskk ((_c_l_a_s_s PPiixxmmaappMMaasskk))<> <> SSppeecciiffiieess aa mmaasskk ffoorr tthhee bbiittmmaapp ttoo bbee sshhoowwnn wwhheenn nneeww mmaaiill hhaass aarrrriivveedd.. TThhee ddeeffaauulltt iiss nnoonnee.. <> <>eemmppttyyPPiixxmmaappMMaasskk ((_c_l_a_s_s PPiixxmmaappMMaasskk))<> <> SSppeecciiffiieess aa mmaasskk ffoorr tthhee bbiittmmaapp ttoo bbee sshhoowwnn wwhheenn nnoo nneeww mmaaiill iiss pprreesseenntt.. TThhee ddeeffaauulltt iiss nnoonnee.. <> <> AACCTTIIOONNSS <> TThhee _M_a_i_l_b_o_x wwiiddggeett pprroovviiddeess tthhee ffoolllloowwiinngg aaccttiioonnss ffoorr uussee iinn eevveenntt ttrraannssllaattiioonnss:: <> <> <>cchheecckk(())<> <> TThhiiss aaccttiioonn ccaauusseess tthhee wwiiddggeett ttoo cchheecckk ffoorr nneeww mmaaiill aanndd ddiissppllaayy tthhee ffllaagg aapppprroopprriiaatteellyy.. <> <>uunnsseett(())<> <> TThhiiss aaccttiioonn ccaauusseess tthhee wwiiddggeett ttoo lloowweerr tthhee ffllaagg uunnttiill nneeww mmaaiill ccoommeess iinn.. <> <>sseett(())<> <> TThhiiss aaccttiioonn ccaauusseess tthhee wwiiddggeett ttoo rraaiissee tthhee ffllaagg uunnttiill tthhee uusseerr rreesseettss iitt.. <> <> TThhee ddeeffaauulltt ttrraannssllaattiioonn iiss <><> <> <> <>:: uunnsseett(()) <> <><> <> EENNVVIIRROONNMMEENNTT <> <> <> <> <>DDIISSPPLLAAYY<> <> ttoo ggeett tthhee ddeeffaauulltt hhoosstt aanndd ddiissppllaayy nnuummbbeerr.. <> <>XXEENNVVIIRROONNMMEENNTT<> <> ttoo ggeett tthhee nnaammee ooff aa rreessoouurrccee ffiillee tthhaatt oovveerrrriiddeess tthhee gglloobbaall rreessoouurrcceess ssttoorreedd iinn tthhee RREESSOOUURRCCEE__MMAANNAAGGEERR pprrooppeerrttyy.. <> <> SSEEEE AALLSSOO <> XX((77)),, xxrrddbb((11)),, ssttaatt((22)) <> BBUUGGSS <> TThhee mmaaiillbbooxx bbiittmmaappss aarree uuggllyy.. <> AAUUTTHHOORR <> JJiimm FFuullttoonn,, MMIITT XX CCoonnssoorrttiiuumm <> AAddddiittiioonnaall hhaacckkss bbyy RRaallpphh SSwwiicckk,, DDEECC//MMIITT PPrroojjeecctt AAtthheennaa <>