


NEWMAIL(1L)       MISC. REFERENCE MANUAL PAGES        NEWMAIL(1L)



NAME
     newmail,wnewmail - programs to asynchronously notify of  new
     mail

SYNOPSIS
     newmail [-d] [-i _i_n_t_e_r_v_a_l] [-w] _f_i_l_e-_s_p_e_c {_f_i_l_e-_s_p_e_c...}
     wnewmail [-d] [-i _i_n_t_e_r_v_a_l] [-w] _f_i_l_e-_s_p_e_c {_f_i_l_e-_s_p_e_c...}

DESCRIPTION
     _N_e_w_m_a_i_l is a program to allow monitoring of mailboxes in  an
     intelligent fashion.  It is based loosely on _b_i_f_f(_1) and the
     version of _n_e_w_m_a_i_l that was distributed with Elm  1.7.   The
     basic  operation  is that the program will check the list of
     specified mailboxes each _i_n_t_e_r_v_a_l seconds and will list  any
     new  mail that has arrived in any of the mailboxes, indicat-
     ing the sender name, and the subject of the  message.   Each
     entry  displayed  can  be  in  a number of different formats
     depending on the mode of the program, the number of  folders
     being  monitored,  and the status of the message.  If you're
     running it as a _w_i_n_d_o_w (e.g. ``-w'' or invoked as  _w_n_e_w_m_a_i_l)
     then the output will be similar to:

        _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e
        Priority: _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e

     where <sender name> is either the name of the person sending
     it, if available (the ARPA 'From:' line) or some other brief
     indication of origin.   If you are the sender, <sender name>
     will  be  replaced by "to <recipient name>".  If there is no
     subject, the message  "<no  subject>"  will  appear  on  the
     screen.   Folders  are  indicated  by having the folder name
     appear first on the output line, as in:

        _f_o_l_d_e_r: _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e

     If you're running _n_e_w_m_a_i_l without the windows  option,  then
     the  output  is more suitable for popping up on an otherwise
     active screen, and will be formatted:

        >> New mail from _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e
        >> Priority mail from _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e

     Again, with folder names indicated as a prefix.   The  flags
     available are:

     -d        This will turn on the  debugging,  verbose  output
               mode.   It  is  not  recommended that you use this
               option unless you're interested in actually debug-
               ging the program.

     -i _i_n_t_e_r_v_a_l
               This will change the frequency  that  the  program



USENET Community TrustLast change: Elm Version 2.4                 1






NEWMAIL(1L)       MISC. REFERENCE MANUAL PAGES        NEWMAIL(1L)



               checks  the  folders to the interval specified, in
               seconds.  The default interval for the program  is
               60  seconds.   _N_o_t_e: _i_f _y_o_u _c_h_a_n_g_e _t_h_e _i_n_t_e_r_v_a_l _t_o
               _l_e_s_s _t_h_a_n _1_0 _s_e_c_o_n_d_s, _t_h_e _p_r_o_g_r_a_m  _w_i_l_l  _w_a_r_n  _y_o_u
               _t_h_a_t _i_t _i_s_n'_t _r_e_c_o_m_m_e_n_d_e_d.

     -w        Use of the ``-w'' flag will  simulate  having  the
               program  run  from  within a window (e.g. the more
               succinct output format, and so on).  Most  likely,
               rather than using this option you should be simply
               invoking _w_n_e_w_m_a_i_l instead.  _F_i_l_e _s_p_e_c_s are made up
               of  two components, the _f_o_l_d_e_r _n_a_m_e and the _p_r_e_f_i_x
               _s_t_r_i_n_g, the latter of which can always be omitted.
               The format is _f_o_l_d_e_r_n_a_m_e=_p_r_e_f_i_x_s_t_r_i_n_g, and you can
               specify folders by full name, by simply  the  name
               of  the user whose mailbox should be monitored, or
               by the standard Elm metacharacters to specify your
               folder  directory  (e.g.  ``+'', ``='', or ``%'').
               Folders that cannot be opened  due  to  permission
               mismatches  will  cause the program to immediately
               abort.  On the other hand, files that do not exist
               will   continue   to  be  checked  every  _i_n_t_e_r_v_a_l
               seconds, so some care  should  be  exercised  when
               invoking  the program.  The program will run until
               you log out or explicitly kill it, and can  inter-
               nally reset itself if any of the folders shrink in
               size and then grow again.  The default  folder  to
               monitor is always your incoming mailbox.

EXAMPLES
     Some example invocations:

          $ newmail

     will check your incoming mailbox every 60 seconds.

          $ newmail  -i  15  joe  root

     will  monitor  the  incoming  mailboxes  for   ``joe''   and
     ``root'', checking every 15 seconds for new mail.

          $ newmail  "mary=Mary"  +postmaster=POBOX

     will monitor the incoming mailbox for user ``mary'', prefix-
     ing all messages with the string ``Mary'', and the folder in
     the users _m_a_i_l_d_i_r directory called ``postmaster'', prefixing
     all  of  those  messages  with ``POBOX''.  You can also have
     more complex monitoring too, for example:

          $ newmail  -i  30  $LOGNAME=me  ${LOGNAME}su=myroot   /tmp/mbox

     will check every 30 seconds for the users mailbox, a mailbox



USENET Community TrustLast change: Elm Version 2.4                 2






NEWMAIL(1L)       MISC. REFERENCE MANUAL PAGES        NEWMAIL(1L)



     that  is  the  users  login-name  with ``su'' appended (e.g.
     ``joe'' would become ``joesu'') and the file /tmp/mbox, pre-
     fixing  new  mail  for  each  with  ``me'',  ``myroot''  and
     ``mbox'' respectively.

AUTHOR
     Elm Development Group

SEE ALSO
     notify in sh(1) or csh(1)

BUG REPORTS TO
     Syd Weinstein  elm@DSI.COM    (dsinc!elm)

COPYRIGHTS
     Copyright 1988-1992 by The USENET Community Trust
     Derived from Elm 2.0,  Copyright 1986, 1987 by Dave Taylor






































USENET Community TrustLast change: Elm Version 2.4                 3



