


     NNNNEEEEWWWWMMMMAAAAIIIILLLL((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....3333))))  NNNNEEEEWWWWMMMMAAAAIIIILLLL((((1111LLLL))))



     NNNNAAAAMMMMEEEE
          newmail,wnewmail - programs to asynchronously notify of new mail

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          nnnneeeewwwwmmmmaaaaiiiillll [[[[----dddd]]]] [[[[----iiii _i_n_t_e_r_v_a_l]]]] [[[[----wwww]]]] _f_i_l_e-_s_p_e_c {_f_i_l_e-_s_p_e_c...}
          wwwwnnnneeeewwwwmmmmaaaaiiiillll [[[[----dddd]]]] [[[[----iiii _i_n_t_e_r_v_a_l]]]] [[[[----wwww]]]] _f_i_l_e-_s_p_e_c {_f_i_l_e-_s_p_e_c...}

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          _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 EEEEllllmmmm 1111....777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,
          indicating 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 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dd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
                    debugging the program.



     Page 1                                          (printed 9/16/90)






     NNNNEEEEWWWWMMMMAAAAIIIILLLL((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....3333))))  NNNNEEEEWWWWMMMMAAAAIIIILLLL((((1111LLLL))))



          ----iiii _i_n_t_e_r_v_a_l
                    This will change the frequency that the program
                    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ww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 EEEEllllmmmm
          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 internally reset itself if any of the folders
          shrink in size and then grow again.

          The default folder to monitor is always your incoming
          mailbox.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
          Some example invocations:

               $ nnnneeeewwwwmmmmaaaaiiiillll

          will check your imcoming mailbox every 60 seconds.

               $ nnnneeeewwwwmmmmaaaaiiiillll  ----iiii  11115555  jjjjooooeeee  rrrrooooooootttt

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

               $ nnnneeeewwwwmmmmaaaaiiiillll  """"mmmmaaaarrrryyyy====MMMMaaaarrrryyyy""""  ++++ppppoooossssttttmmmmaaaasssstttteeeerrrr====PPPPOOOOBBBBOOOOXXXX

          will monitor the incoming mailbox for user ``mary'',
          prefixing all messages with the string ``Mary'', and the
          folder in the users _m_a_i_l_d_i_r directory called ``postmaster'',



     Page 2                                          (printed 9/16/90)






     NNNNEEEEWWWWMMMMAAAAIIIILLLL((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....3333))))  NNNNEEEEWWWWMMMMAAAAIIIILLLL((((1111LLLL))))



          prefixing all of those messages with ``POBOX''.

          You can also have more complex monitoring too, for example:

               $ nnnneeeewwwwmmmmaaaaiiiillll  ----iiii  33330000  $$$$LLLLOOOOGGGGNNNNAAAAMMMMEEEE====mmmmeeee  $$$${{{{LLLLOOOOGGGGNNNNAAAAMMMMEEEE}}}}ssssuuuu====mmmmyyyyrrrrooooooootttt   ////ttttmmmmpppp////mmmmbbbbooooxxxx

          will check every 30 seconds for the users mailbox, a mailbox
          that is the users login-name with ``su'' appended (e.g.
          ``joe'' would become ``joesu'') and the file /tmp/mbox,
          prefixing new mail for each with ``me'', ``myroot'' and
          ``mbox'' respectively.

     AAAAUUUUTTTTHHHHOOOORRRR
          Dave Taylor, Hewlett-Packard Laboratories.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          notify in sh(1) or csh(1)

     BBBBUUUUGGGG RRRREEEEPPPPOOOORRRRTTTTSSSS TTTTOOOO
          Syd Weinstein  elm@DSI.COM    (dsinc!elm)

     CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTTSSSS
          8888cccc9999 Copyright 1986, 1987 by Dave Taylor
          8888cccc9999 Copyright 1988, 1989, 1990 by The USENET Community Trust































     Page 3                                          (printed 9/16/90)



