.PP
If the text of profile entry is long, you may extend it across several
real lines by indenting the continuation lines with leading spaces or tabs.
+Comments may be introduced by a line starting with `#:':
+.PP
+.RS 5
+.IR # ": "
+This is a comment.
+.RE
+.PP
+Blank lines are not permitted in
+.IR \&.mh\(ruprofile.
.SS "Standard Profile Entries"
The possible profile components are exemplified below. The only mandatory
(context, no default)
.RE
.PP
+.BR Local\-Mailbox :
+Your Username <user@some.host>
+.RS 5
+Tells the various MH tools what your local mailbox is. If set, will be used
+by the default component files by tools like
+.B comp
+and
+.B repl
+to construct your default \*(lqFrom\*(rq header. The text used here will
+be copied exactly to your From: header, so it should already be RFC-822
+compliant. If this is set, the
+.B Signature
+profile entry is NOT used, so it should include a signature as well. (profile,
+default: userid@local.hostname)
+.RE
+.PP
.BR Alternate\-Mailboxes :
mh@uci\-750a, bug-mh*
.RS 5
.BR comp ,
.BR dist ,
.BR forw ,
+.BR refile ,
and
.BR repl .
Read the
Program called by
.B mhl
to filter a component when it is tagged with the \*(lqformat\*(rq variable
-in the mhl filter. See
+in the mhl filter. See
.BR mhl (5)
for more information.
.RE
to delete a message from a folder.
.RE
.PP
-.BR rmfproc :
-%bindir%/rmf
-.RS 5
-Currently not used.
-.RE
-.PP
.BR sendproc :
%bindir%/send
.RS 5
whose names are lower-case only are used internally by nmh and should
not generally be set by the user.
.PP
-If the
-.B WHATNOW
-option was set during
-.B nmh
-configuration, and
-if this environment variable is set, then if the commands
-.BR refile\ ,
-.BR send ,
-.BR show ,
-or
-.B whom
-are not given any `msgs'
-arguments, then they will default to using the file indicated by
-.BR mh\-draft (5).
-This is useful for getting the default behavior
-supplied by the default
-.IR whatnowproc .
-.PP
.B $MH
.RS 5
With this environment variable, you can specify a profile
directory.
.RE
.PP
+.B $MHBUILD
+.RS 5
+With this environment variable, you can specify an
+additional user profile (file) to be read by
+.BR mhbuild ,
+in addition to the mhn.defaults profile.
+.RE
+.PP
+.B $MHN
+.RS 5
+With this environment variable, you can specify an
+additional user profile (file) to be read by
+.BR mhn ,
+in addition to the mhn.defaults profile.
+.B mhn
+is deprecated, so this support for this variable will
+be removed from a future nmh release.
+.RE
+.PP
+.B $MHSHOW
+.RS 5
+With this environment variable, you can specify an
+additional user profile (file) to be read by
+.BR mhshow ,
+in addition to the mhn.defaults profile.
+.RE
+.PP
+.B $MHSTORE
+.RS 5
+With this environment variable, you can specify an
+additional user profile (file) to be read by
+.BR mhstore ,
+in addition to the mhn.defaults profile.
+.RE
+.PP
.B $MM_CHARSET
.RS 5
With this environment variable, you can specify
to iso_8859_1).
.RE
.PP
+.B $NOMHNPROC
+.RS 5
+If this variable is set,
+.B show
+will next test for MIME messages. This mechanism is obsolete;
+use the
+.B \-nocheckmime
+switch to
+.B show
+instead.
+.RE
+.PP
.B $MAILDROP
.RS 5
This variable tells
the default maildrop. This supersedes the \*(lqMailDrop\*(rq profile entry.
.RE
.PP
+.B $MAILHOST
+.RS 5
+This variable tells
+.B inc
+the POP host to query for mail to incorporate. See the
+inc(1) man page for more information.
+.RE
+.PP
+.B $USERNAME_EXTENSION
+.RS 5
+This variable is for use with username_extension masquerading. See the
+mh-tailor(5) man page.
+.RE
+.PP
.B $SIGNATURE
.RS 5
This variable tells
your mail signature. This supersedes the \*(lqSignature\*(rq profile entry.
.RE
.PP
+.B $USER
+.RS 5
+This variable tells
+.B repl
+your user name and
+.B inc
+your default maildrop: see the \*(lqMailDrop\*(rq profile entry.
+.RE
+.PP
.B $HOME
.RS 5
This variable tells all
programs your home directory
.RE
.PP
-.B $SHELL
-.RS 5
-This variable tells
-.B bbl
-the default shell to run
-.RE
-.PP
.B $TERM
.RS 5
This variable tells
lines long your terminal screen is.
.RE
.PP
+.B $MHMTSCONF
+.RS 5
+If this variable is set to a non-null value, it specifies the
+name of the mail transport configuration file to use by
+.BR post ,
+.BR inc ,
+and other programs that interact with the mail transport system,
+instead of the default. See mh-tailor(5).
+.RE
+.PP
+.B $MHMTSUSERCONF
+.RS 5
+If this variable is set to a non-null value, it specifies the name of
+a mail transport configuration file to be read in addition to the
+default. See mh-tailor(5).
+.RE
+.PP
+.B $MHTMPDIR
+.B $TMPDIR
+.B $TMP
+.RS 5
+These variables are searched, in order, for the directory in which to
+create some temporary files.
+.RE
+.PP
+.B $MM_NOASK
+.RS 5
+Setting this variable is set to 1 has the same effect as specifying
+the
+.B \-nolist
+and
+.B \-nopause
+switches to
+.BR mhbuild ,
+.BR mhn ,
+and
+.BR mhshow .
+OBSOLETE: will be removed in a future version of nmh.
+.RE
+.PP
+.B $MHLDEBUG
+.RS 5
+If this variable is set to a non-null value,
+.B mhl
+will emit debugging information.
+.RE
+.PP
+.B $MHPDEBUG
+.RS 5
+If this variable is set to a non-null value,
+.B pick
+will emit a representation of the search pattern.
+.RE
+.PP
+.B $MHPOPDEBUG
+.RS 5
+If this variable is set to a non-null value,
+.B msgchck
+and
+.B inc
+will display their interaction with the POP server.
+This mechanism is obsolete; use the
+.B \-snoop
+switch instead.
+.RE
+.PP
+.B $MHWDEBUG
+.RS 5
+If this variable is set to a non-null value,
+.B nmh
+commands that use the
+.BR Alternate\-Mailboxes
+profile entry will display debugging information
+about the values in that entry.
+.RE
+.PP
.B $editalt
.RS 5
This is the alternate message.
questions about.
.RE
.PP
-.B $mhfolder
-.RS 5
-This is set by
-.BR dist ,
-.BR forw ,
-and
-.BR repl ,
-if appropriate.
-.RE
-.PP
.B $mhaltmsg
.RS 5
.B dist
draft (the message being distributed or replied to).
.RE
.PP
+.B $mhfolder
+.RS 5
+This is the folder containing the alternate message.
+.PP
+This is set by
+.B dist
+and
+.B repl
+during edit sessions so you
+can peruse other messages in the current folder besides the one being
+distributed or replied to. The environment variable
+.B $mhfolder
+is also set by
+.BR show ,
+.BR prev ,
+and
+.B next
+for use by
+.BR mhl .
+.RE
+.PP
.B $mhdist
.RS 5
.B dist
.B repl
if annotations are to occur.
.RE
-.PP
-.B $mhfolder
-.RS 5
-This is the folder containing the alternate message.
-.PP
-This is set by
-.B dist
-and
-.B repl
-during edit sessions so you
-can peruse other messages in the current folder besides the one being
-distributed or replied to. The environment variable
-.B $mhfolder
-is also set by
-.BR show ,
-.BR prev ,
-and
-.B next
-for use by
-.BR mhl .
-.RE
.SH FILES
.fc ^ ~