.\"
.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
-mh-profile \- user profile customization for mmh message handler
-.SH SYNOPSIS
-.I $HOME/.mmh/profile
-.br
-.I $HOME/.mmh/context
+mh-profile \- user customization for the mmh message handler
.SH DESCRIPTION
Each user of
.B mmh
.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
(profile, default: %sendmailpath%)
.RE
.PP
-.BR Backup-Prefix :
-,
+.BR Attachment-Header :
+Attach
.RS 5
-The prefix that is prepended to the name of message files when they
-are ``removed'' by rmm. This should typically be `,' or `#'.
-(profile, 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 AltMsg-Link :
-@
+.BR Sign-Header :
+Sign
.RS 5
-Name of the link to the file to which you are replying or which you are
-redistributing. See `$mhaltmsg' below.
-(profile, default: `@')
+The (pseudo) header in draft messages, that requests the message to be
+signed automatically by
+.BR send ,
+using
+.BR mhsign .
+If you like to type a lot, name it `X-MH-Sign-This-Message'.
+(profile, default: `Sign')
.RE
.PP
-.BR automimeproc :
+.BR Enc-Header :
+Enc
.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 requests the message to be
+signed and encrypted by
+.BR send ,
+using
+.BR mhsign .
+If you like to type a lot, name it `X-MH-Encrypt-This-Message'.
+(profile, default: `Enc')
+.RE
+.PP
+.BR Mime-Type-Query :
+file \-b \-\-mime
+.RS 5
+A command that prints the MIME type of a given file.
+The file name is appended to the command line.
+Note: Older versions of file(1) won't generate the desired output.
+file-4.26, for instance, omits a required semicolon.
+file-5.04 is known to work.
+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
(profile, default: your user-id)
.RE
.PP
+.BR Default-From :
+Philipp Takacs <philipp@bureaucracy.de>
+.RS 5
+Tells
+.B spost
+which address to use, if the draft dosn't contain a
+.RI ` From '
+Header or the draft is not from the user.
+(profile, no default)
+.RE
+.PP
.BR Aliasfile :
aliases
.I other-alias
.RS 5
Indicates aliases files for
-.BR ali
-and
+.BR ali ,
.BR send .
-This may be used instead of the
-.B \-alias
-.I file
-switch. (profile, no default)
+and
+.BR spost .
+(profile, no default)
.RE
.PP
.BR Draft\-Folder :
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
.SS "Process Profile Entries"
The following profile elements are used whenever an
-.B nmh
+.B mmh
program invokes some other program such as
.BR more .
The profile can be used to select alternate programs if the
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 lproc :
-more
+.BR listproc :
+show
.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 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 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.
.RE
.PP
-.B $editalt
-.RS 5
-This is the alternate message.
-.PP
-This is set by
-.B dist
-and
-.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
-.BR altmsg-link )
-in the current directory if your current working directory
-and the message's folder are on the same UNIX filesystem.
-.RE
-.PP
.B $mhdraft
.RS 5
This is the path to the working draft.
.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
.I whatnowproc
about an alternate message associated with the
draft (the message being distributed or replied to).
+It is also set during edit sessions so you can peruse the
+message being distributed or replied to.
+This variable replaces the older
+.B $editalt
+variable.
+There used to be a link named `@' in the working directory, pointing
+to the alternate message, there is no such link anymore.
.RE
.PP
.B $mhdist
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
.ta \w'%etcdir%/ExtraBigFileName 'u
^$HOME/.mmh~^The user's mmh directory
^or $MMH~^Rather than the standard mmh directory
+.sp
^$HOME/.mmh/profile~^The user's profile
^or $MMHP~^Rather than the standard profile
+.sp
^$HOME/.mmh/context~^The user's context
^or $MMHC~^Rather than the standard context
+.sp
^<folder>/.mh_sequences~^Public sequences for <folder>
.fi
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.