.BR Path :
Mail
.RS 5
-Sets the user's mail storage to \*(lqMail\*(rq. This is the
+Sets the user's mail storage to `Mail'. This is the
only mandatory profile entry. (profile, no default)
.RE
.PP
inbox
.RS 5
Keeps track of the current open folder.
-(context, default: folder specified by \*(lqInbox\*(rq)
+(context, default: folder specified by `Inbox')
.RE
.PP
.BR Inbox :
.RE
.PP
.BR Sequence\-Negation :
-not
+\&!
.RS 5
Defines the string which, when prefixed to a sequence name, negates
-that sequence. Hence, \*(lqnotseen\*(rq means all those messages that
-are not a member of the sequence \*(lqseen\*(rq. Read the
+that sequence. Hence, `!foo' means all those messages that
+are not a member of the sequence `foo'.
+To deactivate this mechanism, define Sequence\-Negation to an empty value.
+Read the
.BR mh\-sequence (7)
-man page for the details. (profile, no default)
+man page for the details. (profile, default: !)
.RE
.PP
.BR Unseen\-Sequence :
-unseen
+u
.RS 5
-Names the sequence or sequences which should be defined as those
-messages which are unread. The commands
+Names the sequence or sequences which shall contain any unread messages.
+The commands
.BR inc ,
.BR rcvstore ,
-.BR mhshow ,
and
.B show
will add or remove messages from these
-sequences when they are incorporated or read. If not present or
-empty, no such sequences are defined. Otherwise, each message is
+sequences when they are incorporated or read. If defined with an empty
+value, no such sequences are defined. Otherwise, each message is
added to, or removed from, each sequence name given. Read the
.BR mh\-sequence (7)
man page for the details about this sequence.
-(profile, no default)
+(profile, default: u)
.RE
.PP
.BR Mh\-Sequences :
.BI atr\- seq \- folder :
172\0178\-181\0212
.RS 5
-Keeps track of the private sequence called \*(lqseq\*(rq in the specified
+Keeps track of the private sequence called `seq' in the specified
folder. Private sequences are generally used for read\-only folders.
See the
.BR mh\-sequence (7)
.RE
.PP
.BR Editor :
-/usr/bin/vi
+vi
.RS 5
Defines the editor to be used by the commands
.BR comp ,
.BR forw ,
and
.BR repl .
+This profile entry overrides the $VISUAL and $EDITOR environment variables,
+but gets overridden by the $MMHEDITOR environment variabel.
(profile, default: vi)
.RE
.PP
+.BR Pager :
+more
+.RS 5
+This is the program used by
+.B mhl
+to page the
+.B mhl
+formatted message when displaying to a terminal. It is also the default
+program used by
+.B show
+to display message bodies (or message parts) of type text/plain.
+This profile entry overrides the $PAGER environment variable, but gets
+overridden by the $MMHPAGER environment variable.
+(profile, default: more)
+.RE
+.PP
.BR Sendmail :
/usr/sbin/sendmail
.RS 5
,
.RS 5
The prefix that is prepended to the name of message files when they
-are ``removed'' by rmm. This should typically be `,' or `#'.
+are backup'd for some reason.
+.BR send ,
+for instance, does this.
+Note: rmm does NOT anymore use the backup prefix.
+It should typically be set to `,' or `#'.
(profile, default: `,')
.RE
.PP
(profile, default: `@')
.RE
.PP
-.BR automimeproc :
+.BR Attachment-Header :
+Attach
.RS 5
-If defined and set to 1, then the
-.B whatnow
-program will automatically
-invoke the buildmimeproc (discussed below) to process each message as a MIME
-composition draft before it is sent.
-(profile, no default)
+The (pseudo) header in draft messages, that contains files to be attached
+to the message on sending.
+If you like to type a lot, name it `X-MH-Attachment'.
+(profile, default: `Attach')
+.RE
+.PP
+.BR Mime-Type-Query :
+file \-b \-\-mime
+.RS 5
+A command that prints the MIME type of a file.
+The file name gets appended to the command line.
+Note: Older GNU versions of file(1) won't generate the desired
+output. GNU file-4.26, for instance, omits a required semicolon.
+GNU file-5.04 is known to work. Non-GNU version likely need different
+options or don't provide this function at all. Alternatively, you can use
+.BR print\-mimetype ,
+which is part of mmh, but guesses MIME types by file name extensions only.
.RE
.PP
.BR Msg\-Protect :
-644
+0644
.RS 5
An octal number which defines the permission bits for new message files.
See
.BR chmod (1)
for an explanation of the octal number.
-(profile, default: 0644)
+(profile, default: 0600)
.RE
.PP
.BR Folder\-Protect :
-750
+0750
.RS 5
An octal number which defines the permission bits for new folder
directories. See
.BR chmod (1)
for an explanation of the octal number.
-(profile, default: 700)
+(profile, default: 0700)
.RE
.PP
.IR program :
.RS 5
Sets default switches to be used whenever the mmh program
.I program
-is invoked. For example, one could override the \*(lqEditor:\*(rq profile
+is invoked. For example, one could override the `Editor:' profile
component when replying to messages by adding a component such as:
.PP
.RS 5
.IB lasteditor "-next:"
.I nexteditor
.RS 5
-Names \*(lqnexteditor\*(rq to be the default editor after using
-\*(lqlasteditor\*(rq. This takes effect at \*(lqWhat now?\*(rq prompt
+Names `nexteditor' to be the default editor after using
+`lasteditor'. This takes effect at `What now?' prompt
in
.BR comp ,
.BR dist ,
and
.BR repl .
After editing
-the draft with \*(lqlasteditor\*(rq, the default editor is set to be
-\*(lqnexteditor\*(rq. If the user types \*(lqedit\*(rq without any
-arguments to \*(lqWhat now?\*(rq, then \*(lqnexteditor\*(rq is used.
+the draft with `lasteditor', the default editor is set to be
+`nexteditor'. If the user types `edit' without any
+arguments to `What now?', then `nexteditor' is used.
(profile, no default)
.RE
.PP
(context, no default)
.RE
.PP
-.BR mhe :
-.RS 5
-If present, tells
-.B inc
-to compose an
-.I MHE
-auditfile in addition to its other tasks.
-.I MHE
-is Brian Reid's
-.B emacs
-front-end for
-.BR mmh .
-(profile, no default)
-.RE
-.PP
.BR Alternate\-Mailboxes :
mh@uci\-750a, bug-mh*
.RS 5
scan
knows if the message really originated from you.
Addresses must be separated by a comma, and the hostnames listed should
-be the \*(lqofficial\*(rq hostnames for the mailboxes you indicate, as
+be the `official' hostnames for the mailboxes you indicate, as
local nicknames for hosts are not replaced with their official site names.
For each address, if a host is not given, then that address on any host is
considered to be you. In addition, an asterisk (`*') may appear at either
man page for details. (profile, default: +drafts)
.RE
.PP
+.BR Trash\-Folder :
+trash
+.RS 5
+Changes the default folder for removed messages. Read the
+.BR rmm (1)
+man page for details.
+(profile, default: +trash)
+.RE
+.PP
.BI digest\-issue\- list :
1
.RS 5
.BR $SIGNATURE .
If
.B $SIGNATURE
-is not set and this profile entry is not present, the \*(lqgcos\*(rq field of
-the \fI/etc/passwd\fP file will be used; otherwise, on hosts where
-.B nmh
-was configured with the UCI option, the file
-.I $HOME/.signature
-is consulted. Your signature will be added to the address
+is not set and this profile entry is not present, the `gcos' field of
+the \fI/etc/passwd\fP file will be used.
+Your signature will be added to the address
.B send
-puts in the \*(lqFrom:\*(rq header; do not include an address in the
+puts in the `From:' header; do not include an address in the
signature text. (profile, no default)
.RE
user wishes. The default values are given in the examples.
.RE
.PP
-.BR buildmimeproc :
-%bindir%/mhbuild
-.RS 5
-This is the program used by
-.B whatnow
-to process drafts which are MIME composition files.
-.RE
-.PP
-.BR fileproc :
-%bindir%/refile
-.RS 5
-This program is used to refile or link a message to another folder.
-It is used by
-.B post
-to file a copy of a message into a folder given
-by a \*(lqFcc:\*(rq field. It is used by the draft folder facility in
-.BR comp ,
-.BR dist ,
-.BR forw ,
-and
-.B repl
-to refile a draft
-message into another folder. It is used to refile a draft message in
-response to the
-.B refile
-directive at the \*(lqWhat now?\*(rq prompt.
-.RE
-.PP
-.BR incproc :
-%bindir%/inc
-.RS 5
-Program called by
-.B mhmail
-to incorporate new mail when it
-is invoked with no arguments.
-.RE
-.PP
-.BR installproc :
-mmh
-.RS 5
-This program is called to initialize the environment for
-new users of
-.BR mmh .
-.RE
-.PP
-.BR lproc :
-more
+.BR listproc :
+show \-file
.RS 5
This program is used to list the contents of a message in response
to the
.B list
-directive at the \*(lqWhat now?\*(rq prompt. It is
-also used by the draft folder facility in
-.BR comp ,
-.BR dist ,
-.BR forw ,
and
-.B repl
-to display the draft message.
-.RE
-.PP
-.BR mailproc :
-%bindir%/mhmail
-.RS 5
-This is the program used to automatically mail various messages
-and notifications. It is used by
-.B conflict
-when using the
-.B \-mail
-option. It is used by
-.B send
-to post failure notices.
-It is used to retrieve an external-body with access-type `mail-server'
-(such as when storing the body with
-.BR mhstore ).
-.RE
-.PP
-.BR mhlproc :
-%libdir%/mhl
-.RS 5
-This is the program used to filter messages in various ways. It
-is used by
-.B mhshow
-to filter and display the message headers
-of MIME messages. When the
-.B \-format
-or
-.B \-filter
-option is used
-by
-.B forw
-or
-.BR repl ,
-the
-.I mhlproc
-is used to filter the
-message that you are forwarding, or to which you are replying.
-When the
-.B \-filter
-option is given to
-.B send
-or
-.BR post ,
-the
-.I mhlproc
-is used by
-.B post
-to filter the copy of the message
-that is sent to \*(lqBcc:\*(rq recipients.
-.RE
-.PP
-.BR moreproc :
-more
-.RS 5
-This is the program used by
-.B mhl
-to page the
-.B mhl
-formatted message when displaying to a terminal. It is also the default
-program used by
-.B mhshow
-to display message bodies (or message parts) of type text/plain.
-.RE
-.PP
-.BR packproc :
-%bindir%/packf
-.RS 5
-Currently not used.
-.RE
-.PP
-.BR postproc :
-%libdir%/post
-.RS 5
-This is the program used by
-.BR send ,
-.BR mhmail ,
-.BR rcvdist ,
-and
-.B viamail
-(used by the
-.B sendfiles
-shell script) to
-post a message to the mail transport system.
-.RE
-.PP
-.BR rmmproc :
-none
-.RS 5
-This is the program used by
-.B rmm
-and
-.B refile
-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
-This is the program to use by
-.B whatnow
-to actually send the message
-.RE
-.PP
-.BR showmimeproc :
-%bindir%/mhshow
-.RS 5
-This is the program used by
-.B show
-to process and display non-text (MIME) messages.
-.RE
-.PP
-.BR showproc :
-%libdir%/mhl
-.RS 5
-This is the program used by
-.B show
-to filter and display text (non-MIME) messages.
+.B display
+directive at the `What now?' prompt.
+The absolute pathname of the message to list will be appended to
+the command line given.
.RE
.PP
.BR whatnowproc :
presence of certain environment variables.
.PP
Many of these environment variables are used internally by the
-\*(lqWhat now?\*(rq interface. It's amazing all the information
+`What now?' interface. It's amazing all the information
that has to get passed via environment variables to make the
-\*(lqWhat now?\*(rq interface look squeaky clean to the
+`What now?' interface look squeaky clean to the
.B mmh
user, isn't it? The reason for all this is that the
.B mmh
.BR $MM_CHARSET .
This variable is
checked by
-.B mhshow
+.B show
for matches against the charset parameter
of text contents to decide it the text content can be displayed
without modifications to your terminal. This variable is checked by
.RS 5
This variable tells
.B inc
-the default maildrop. This supersedes the \*(lqMailDrop\*(rq profile entry.
+the default maildrop. This supersedes the `MailDrop' profile entry.
.RE
.PP
.B $SIGNATURE
.B send
and
.B post
-your mail signature. This supersedes the \*(lqSignature\*(rq profile entry.
+your mail signature. This supersedes the `Signature' profile entry.
.RE
.PP
.B $HOME
the default shell to run
.RE
.PP
+.B $MMHEDITOR
+.br
+.B $VISUAL
+.br
+.B $EDITOR
+.RS 5
+These variables (in descending priority) define the default editor to use.
+.RE
+.PP
+.B $MMHPAGER
+.br
+.B $PAGER
+.RS 5
+These variables (in descending priority) define the default pager to use.
+.RE
+.PP
.B $TERM
.RS 5
This variable tells
.B scan
and
.B mhl
-how to clear your terminal, and how
-many columns wide your terminal is. They also tell
+how many columns wide your terminal is. They also tell
.B mhl
how many
lines long your terminal screen is.
.B repl
during edit sessions so you can peruse the message being distributed or
replied to. The message is also available through a link called
-\*(lq@\*(rq (if not changed by
+`@' (if not changed by
.BR altmsg-link )
in the current directory if your current working directory
and the message's folder are on the same UNIX filesystem.
.B repl
to tell the
.I whatnowproc
-which file to ask \*(lqWhat now?\*(rq
+which file to ask `What now?'
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
if annotations are to occur.
.RE
.PP
-.B $mhinplace
-.RS 5
-This is set by
-.BR dist ,
-.BR forw ,
-and
-.B repl
-if annotations are to occur.
-.RE
-.PP
.B $mhfolder
.RS 5
This is the folder containing the alternate message.
.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 .
+distributed or replied to.
.RE
.SH FILES
update. Changes in context are made to the
.I $HOME/.mmh/context
file.
-This includes, but is not limited to: the \*(lqCurrent\-Folder\*(rq entry
+This includes, but is not limited to: the `Current\-Folder' entry
and all private sequence information. Public sequence information is
-kept in each folder in the file determined by the \*(lqMh\-Sequences\*(rq
+kept in each folder in the file determined by the `Mh\-Sequences'
profile entry (default is
.IR \&.mh_sequences ).
.PP
The profile may override the path of the
.I context
-file, by specifying a \*(lqContext\*(rq entry.
+file, by specifying a `Context' entry.
As a result, you can actually have more than one set of
private sequences by using different context files.