Provided by: nmh_1.3-1build1_amd64 bug

NAME

       nmh - new MH message system

SYNOPSIS

       any nmh command

DESCRIPTION

       nmh  is  the  name  of  a  powerful  message  handling system.  Rather than being a single
       comprehensive program, nmh consists  of  a  collection  of  fairly  simple  single-purpose
       programs to send, retrieve, save, and manipulate messages.

       Unlike most mail clients in UNIX, nmh is not a closed system which must be explicitly run,
       then exited when you wish to return to the shell.  You may freely intersperse nmh commands
       with  other  shell commands, allowing you to read and answer your mail while you have (for
       example) a compilation running, or search for a file or run programs as needed to find the
       answer to someone's question before answering their mail.

       The  rest of this manual entry is a quick tutorial which will teach you the basics of nmh.
       You should read the manual entries for the individual programs for complete documentation.

       To get started using nmh, put the directory /usr/bin/mh on your $PATH.  This is best  done
       in  one of the files: .profile, .login, .bashrc, or .cshrc in your home directory.  (Check
       the manual entry for the shell you use, in case you don't know how to do this.)   Run  the
       install-mh command.  If you've never used nmh before, it will create the necessary default
       files and directories after asking you if you wish it to do so.

       inc moves mail from your system maildrop into your nmh `+inbox'  folder,  breaking  it  up
       into  separate  files  and converting it to nmh format as it goes.  It prints one line for
       each message it processes, containing the from field, the subject field and as much of the
       first  line  of the message as will fit.  It leaves the first message it processes as your
       current message.  You'll need to run inc each time you wish to incorporate new  mail  into
       your nmh file.

       scan prints a list of the messages in your current folder.

       The  commands:  show,  next,  and prev are used to read specific messages from the current
       folder.  show displays the current message, or a specific message, which may be  specified
       by  its  number,  which  you  pass  as  an  argument  to  show.   next  and  prev display,
       respectively, the message numerically after or before the current message.  In all  cases,
       the  message  displayed becomes the current message.  If there is no current message, show
       may be called with an argument, or next may be used to advance to the first message.

       rmm (remove message) deletes the current message.  It may be called with  message  numbers
       passed as arguments, to delete specific messages.

       repl  is used to respond to the current message (by default).  It places you in the editor
       with a prototype response form.  While you're in the  editor,  you  may  peruse  the  item
       you're  responding  to  by  reading the file @.  After completing your response, type l to
       list (review) it, or s to send it.

       comp allows you to compose a message by putting you in the editor on a  prototype  message
       form, and then lets you send it.

       All  the  nmh  commands  may  be run with the single argument: -help, which causes them to
       print a list of the arguments they may be invoked with and then exit.

       All the nmh commands may be run with the single argument: -version, which  cause  them  to
       print the version number of the nmh distribution, and then exit.

       Commands  which  take  a message number as an argument ( scan, show, repl, ...)  also take
       one of the words: “first”, “prev”, “cur”, “next”, or “last” to indicate (respectively) the
       first,  previous,  current, next, or last message in the current folder (assuming they are
       defined).

       Commands which take a range of message numbers ( rmm, scan, show, ...)  also take  any  of
       the abbreviations:

            <num1>-<num2>  Indicates  all  messages in the range <num1> to <num2>, inclusive. The
                           range must be nonempty.

            <num>:+N

            <num>:-N       Up to N messages beginning with (or ending with) message num.  Num may
                           be any of the pre-defined symbols: first, prev, cur, next or last.

            first:N

            prev:N

            next:N

            last:N         The first, previous, next or last messages, if they exist.

       There are many other possibilities such as creating multiple folders for different topics,
       and automatically refiling messages according to subject, source, destination, or content.
       These are beyond the scope of this manual entry.

       Following is a list of all the nmh commands:

            ali(1)         - list mail aliases
            anno(1)        - annotate messages
            burst(1)       - explode digests into messages
            comp(1)        - compose a message
            dist(1)        - redistribute a message to additional addresses
            flist(1)       - list folders with messages in given sequence(s)
            flists(1)      - list all folders with messages in given sequence(s)
            folder(1)      - set/list current folder/message
            folders(1)     - list all folders
            forw(1)        - forward messages
            inc(1)         - incorporate new mail
            mark(1)        - mark messages
            mhbuild(1)     - translate MIME composition draft
            mhl(1)         - produce formatted listings of nmh messages
            mhlist(1)      - list information about content of MIME messages
            mhmail(1)      - send or read mail
            mhn(1)         - display/list/store/cache MIME messages
            mhparam(1)     - print nmh profile components
            mhpath(1)      - print full pathnames of nmh messages and folders
            mhshow(1)      - display MIME messages
            mhstore(1)     - store contents of MIME messages into files
            msgchk(1)      - check for messages
            msh(1)         - nmh shell(and BBoard reader)
            next(1)        - show the next message
            packf(1)       - compress a folder into a single file
            pick(1)        - select messages by content
            prev(1)        - show the previous message
            prompter(1)    - prompting editor front end
            rcvdist(1)     - asynchronously redistribute new mail
            rcvpack(1)     - append message to file
            rcvstore(1)    - asynchronously incorporate new mail
            rcvtty(1)      - report new mail
            refile(1)      - file messages in other folders
            repl(1)        - reply to a message
            rmf(1)         - remove folder
            rmm(1)         - remove messages
            scan(1)        - produce a one line per message scan listing
            send(1)        - send a message
            sendfiles(1)   - send multiple files and directories in MIME message
            show(1)        - show(display) messages
            slocal(1)      - asynchronously filter and deliver new mail
            sortm(1)       - sort messages
            whatnow(1)     - prompting front-end for send
            whom(1)        - report to whom a message would go

            mh-alias(5)    - alias file for nmh message system
            mh-draft(5)    - draft folder facility
            mh-format(5)   - format file for nmh message system
            mh-mail(5)     - message format for nmh message system
            mh-profile(5)  - user customization for nmh message system
            mh-sequence(5) - sequence specification for nmh message system
            mh-tailor(5)   - mail transport customization for nmh message system

            ap(8)          - parse addresses 822-style
            conflict(8)    - search for alias/password conflicts
            dp(8)          - parse dates 822-style
            fmtdump(8)     - decode nmh format files
            install-mh(8)  - initialize the nmh environment
            post(8)        - deliver a message

FILES

       /usr/bin/mh                contains nmh commands
       /etc/nmh                   contains nmh format files
       /usr/lib/mh                contains nmh library commands
       $HOME/.mh_profile          The user profile

PROFILE COMPONENTS

       Path:                To determine the user's nmh directory

BUGS

       If  problems  are  encountered with an nmh program, the problems should be reported to the
       local maintainers of nmh.  When doing this, the name of the program  should  be  reported,
       along with the version information for the program.
       To  find  out  what  version  of  an nmh program is being run, invoke the program with the
       -version switch.  This information includes the version of nmh, the host it was  generated
       on, and the date the program was loaded.

       Send bug reports and suggestions to nmh-workers@nongnu.org.

SEE ALSO

       mh-chart(7)