RCVTTY(1)                                               RCVTTY(1)

NAME
       rcvtty  - report new mail

SYNOPSIS
       /usr/lib/nmh/rcvtty [command]
            [-form formatfile] [-format string] [-width columns]
            [-bell] [-nobell] [-newline] [-nonewline] [-biff]
            [-version] [-help]

DESCRIPTION
       The  rcvtty  can  be  used to report new mail.  It is used
       primarily in conjunction with mail filtering  agents  such
       as slocal or procmail.

       The  rcvtty  program  executes  the named command with the
       message as its standard input, and  writes  the  resulting
       output on your terminal.

       Alternately,  if  no  command  is specified (or is bogus),
       then rcvtty will instead write a  one-line  scan  listing.
       The  default  output  format  of  this scan listing may be
       overriden  by  using  either  the  `-form formatfile'   or
       `-format string' option, similar to the equivalent options
       for scan and inc.  See mh-format(5) for details.

       A newline is output before the  message  output,  and  the
       terminal  bell is rung after the output.  The `-nonewline'
       and `-nobell' options will inhibit these functions.

       The switch `-width columns' may be given  to  specify  the
       width  of  the scan line.  The default is to use the width
       of the terminal.

       In addition to the standard format  escapes  described  in
       mh-format(5),  rcvtty  also recognizes the following addi-
       tional component escapes:

       Escape    Returns  Description
       body      string   the (compressed) first part of the body
       dtimenow  date     the current date
       folder    string   the name of the current folder

       By default, rcvtty will send its output to every  terminal
       on  the  local  machine that is owned by current user, and
       that has given write permission as granted by the  command
       mesg (1).   If  the  option  `-biff' is given, then rcvtty
       will obey the  notification  status  set  by  the  command
       biff (1)  instead.  ^/etc/nmh/mts.conf~^nmh mts configura-
       tion file ^$HOME/.maildelivery~^The file controlling local
       delivery  ^/etc/nmh/maildelivery~^Rather than the standard
       file `-width' defaults to the width of the terminal `-new-
       line' `-bell' rcvdist(1), rcvpack(1), rcvstore(1), mh-for-
       mat(5), slocal(1) Only two return  codes  are  meaningful,
       others should be.

[nmh-0.27]                    MH.6.8                            1