-.TH NMH %manext7% "November 3, 2012" "%nmhversion%"
+.TH NMH %manext7% "April 21, 2014" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
.\"
.SH NAME
nmh \- new MH message system
-.SH SYNOPSIS
-any
-.B nmh
-command
.SH DESCRIPTION
.B nmh
is the name of a powerful message handling system. Rather than
.B attach
and related responses, as described in its man page.
.PP
+.B nmh
+command arguments are usually called
+.IR switches .
+Some switches have a corresponding \*(lq\-no\*(rq switch, which
+negates all previous occurrences of that switch on the command line.
+This allows a user to conveniently override, on the command line, a
+switch in their profile. Switches may be abbreviated as long as there
+is no ambiguity with another switch of the same command. To avoid
+ambiguity with any switches that may be added in the future, it is
+recommended that full switch names be used in durable code such as
+shell scripts, functions, and aliases.
+.PP
All the
.B nmh
-commands may be run with the single argument
+commands may be run with the single switch
.BR \-help ,
-which causes them to print a list of the arguments they may be invoked
+which causes them to print a list of the switches they may be invoked
with and then exit.
.PP
All the
.B nmh
-commands may be run with the single argument
+commands may be run with the single switch
.BR \-version ,
which causes them to print the version number of the
.B nmh
\*(lqprev\*(rq, \*(lqcur\*(rq, \*(lqnext\*(rq, or \*(lqlast\*(rq to indicate
(respectively) the first, previous, current, next, or last message in
the current folder (assuming they are defined).
+As a shorthand, \*(lq\&.\*(rq is equivalent to \*(lqcur\*(rq.
.PP
Commands which take a range of message numbers
.RB ( rmm ,
messages, if they exist.
.PD
.PP
+Commands that take a folder name
+.RB ( inc ,
+.BR refile ,
+.BR scan,
+\&...) accept the folder name in two formats: \*(lq+folder\*(rq or
+\*(lq@folder\*(rq. In both cases, \*(lqfolder\*(rq can be a
+\*(lq/\*(rq-separated path, e.g. \*(lqfoo/bar\*(rq. \*(lq+folder\*(rq
+specifies a directory path to a folder. If \*(lqfolder\*(rq starts
+with \*(lq/\*(rq then it's an absolute path from the root directory.
+If it is \*(lq.\*(rq or \*(lq..\*(rq, or starts with \*(lq./\*(rq or
+\*(lq../\*(rq, then it's relative to the current working directory.
+Otherwise it's relative to mh-profile(5)'s
+.RI \*(lq Path \*(rq,
+i.e. as given by
+.RB ` "mhpath +" `.
+\*(lq@folder\*(rq is a shorthand for \*(lq+curfolder/folder\*(rq; it's
+a relative path from the current folder. \*(lqcurfolder\*(rq is given
+by
+.RB ` mhpath `.
+For example, assuming a
+.B Path
+profile component of Mail,
+.TP \n(ttu
+.PD 0
+.BI "scan " +inbox
+scans $HOME/Mail/inbox
+.TP
+.BI "scan " +work/todo
+scans $HOME/Mail/work/todo
+.TP
+.BI "scan " @todo
+scans $HOME/Mail/work/todo, if current folder is +work
+.TP
+.BI "refile " @../done
+refiles to $HOME/Mail/work/done, if the current folder is +work/todo
+.TP
+.BI "scan " +/tmp
+scans /tmp
+.TP
+.BI "scan " +.
+scans the current directory
+.TP
+.BI "refile " @.
+refiles current message to end of current folder.
+.PD
+.PP
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
.PD 0
.IR mhmail (1)
send or read mail
-.TP
-.IR msh (1)
-nmh shell
.PD
.ne 4
.SS
Utilities
.TP \n(ttu
.PD 0
+.IR mhfixmsg (1)
+rewrite MIME messages with various transformations
+.TP
.IR mhparam (1)
print nmh profile components
.TP
.TP \n(ttu
.PD 0
.IR ap (8)
-parse addresses 822\-style
-.TP
-.IR conflict (8)
-search for alias/password conflicts
+parse addresses RFC 822\-style
.TP
.IR dp (8)
-parse dates 822\-style
+parse dates RFC 822\-style
.TP
.IR fmtdump (8)
decode
.IR mh\-alias (5)
alias file for nmh message system
.TP
+.IR mh\-format (5)
+format file for nmh message system
+.TP
+.IR mh\-profile (5)
+user customization for nmh message system
+.TP
+.IR mh\-tailor (5)
+mail transport customization for nmh message system
+.PD
+.ne 4
+.SS
+Formats
+.TP \n(ttu
+.PD 0
.IR mh\-draft (5)
draft folder facility
.TP
-.IR mh\-format (5)
-format file for nmh message system
+.IR mh\-folders (5)
+nmh message storage format specification
.TP
.IR mh\-mail (5)
message format for nmh message system
.TP
-.IR mh\-profile (5)
-user customization for nmh message system
-.TP
.IR mh\-sequence (5)
sequence specification for nmh message system
-.TP
-.IR mh\-tailor (5)
-mail transport customization for nmh message system
.PD
.ne 4
.SH FILES
.B nmh
commands
.TP
-%etcdir%
+%nmhetcdir%
contains
.B nmh
format files
.TP
-%libdir%
+%nmhlibexecdir%
contains
.B nmh
library commands
.SH "SEE ALSO"
.IR install-mh (1),
.IR mh-profile (5),
-.IR mh-chart (7)
+.IR mh-chart (7),
+.IR mh-mime (7)
.ne 4
.SH BUGS
If problems are encountered with an
projects / nmh / blobdiff