.\"
.\" %nmhwarning%
-.\" $Id$
.\"
.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
-mh-profile \- user profile customization for nmh message handler
+mh-profile \- user profile customization for mmh message handler
.SH SYNOPSIS
-.I $HOME/.mh\(ruprofile
+.I $HOME/.mmh/profile
+.br
+.I $HOME/.mmh/context
.SH DESCRIPTION
Each user of
-.B nmh
+.B mmh
is expected to have a file named
-.I \&.mh\(ruprofile
+.I $HOME/.mmh/profile
in his or her home directory. This file contains
a set of user parameters used by some or all of the
-.B nmh
+.B mmh
family of programs. Each entry in the file is of the format
.PP
.RS 5
-.IR profile\-component ": " value
+.IR Profile\-Component ": " value
.RE
.PP
If the text of profile entry is long, you may extend it across several
entry is `Path:'. The others are optional; some have default values if
they are not present. In the notation used below, (profile, default)
indicates whether the information is kept in the user's
-.B nmh
+.B mmh
profile or
-.B nmh
+.B mmh
context, and indicates what the default value is.
.PP
.BR Path :
Mail
.RS 5
-Locates
-.B nmh
-transactions in directory \*(lqMail\*(rq. This is the
+Sets the user's mail storage to \*(lqMail\*(rq. This is the
only mandatory profile entry. (profile, no default)
.RE
.PP
-.BR context :
+.BR Context :
context
.RS 5
Declares the location of the
-.B nmh
+.B mmh
context file. This is overridden by the environment variable
-.BR $MHCONTEXT .
+.BR $MMHC .
See the
.B HISTORY
section below.
-(profile, default: <nmh\-dir>/context)
+(profile, default: $HOME/.mmh/context)
.RE
.PP
.BR Current\-Folder :
.RS 5
Names the sequence or sequences which should be defined as the `msgs' or
`msg' argument given to any
-.B nmh
+.B mmh
command. If not present or empty,
no such sequences are defined. Otherwise, for each name given, the
sequence is first zero'd and then each message is added to the sequence.
(profile, no default)
.RE
.PP
-.BR mh\-sequences :
-\&.mh\(rusequences
+.BR Mh\-Sequences :
+\&.mh_sequences
.RS 5
The name of the file in each folder which defines public sequences.
To disable the use of public sequences, leave the value portion of this
-entry blank. (profile, default: \&.mh\(rusequences)
+entry blank. (profile, default: \&.mh_sequences)
.RE
.PP
.BI atr\- seq \- folder :
.BR forw ,
and
.BR repl .
-(profile, default: %default_editor%)
+(profile, default: vi)
+.RE
+.PP
+.BR Sendmail :
+/usr/sbin/sendmail
+.RS 5
+The path name to the
+.B sendmail
+program, used by
+.BR spost
+to send mail.
+(profile, default: %sendmailpath%)
+.RE
+.PP
+.BR Backup-Prefix :
+,
+.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: `,')
+.RE
+.PP
+.BR AltMsg-Link :
+@
+.RS 5
+Name of the link to the file to which you are replying or which you are
+redistributing. See `$mhaltmsg' below.
+(profile, default: `@')
.RE
.PP
.BR automimeproc :
.IR program :
.I default switches
.RS 5
-Sets default switches to be used whenever the mh program
+Sets default switches to be used whenever the mmh program
.I program
is invoked. For example, one could override the \*(lqEditor:\*(rq profile
component when replying to messages by adding a component such as:
(profile, no default)
.RE
.PP
-.BR bboards :
-system
-.RS 5
-Tells
-.B bbc
-which BBoards you are interested in. (profile, default: system)
-.RE
-.PP
.BR Folder\-Stack :
.I folders
.RS 5
.B inc
to compose an
.I MHE
-auditfile in addition to its other tasks.
+auditfile in addition to its other tasks.
.I MHE
-is Brian Reid's
+is Brian Reid's
.B emacs
front-end for
-.BR nmh .
+.BR mmh .
(profile, no default)
.RE
.PP
.I other-alias
.RS 5
Indicates aliases files for
-.BR ali ,
-.BR whom ,
+.BR ali
and
.BR send .
This may be used instead of the
.BR Draft\-Folder :
drafts
.RS 5
-Indicates a default draft folder for
-.BR comp ,
-.BR dist ,
-.BR forw ,
-and
-.BR repl .
-Read the
+Changes the default draft folder. Read the
.BR mh\-draft (5)
-man page for details. (profile, no default)
+man page for details. (profile, default: +drafts)
.RE
.PP
.BI digest\-issue\- list :
.B nmh
program invokes some other program such as
.BR more .
-The
-.I \&.mh\(ruprofile
-can be used to select alternate programs if the
+The profile can be used to select alternate programs if the
user wishes. The default values are given in the examples.
.RE
.PP
.RE
.PP
.BR installproc :
-%libdir%/install\-mh
+mmh
.RS 5
This program is called to initialize the environment for
new users of
-.BR nmh .
+.BR mmh .
.RE
.PP
.BR lproc :
-%default_pager%
+more
.RS 5
This program is used to list the contents of a message in response
to the
.RE
.PP
.BR moreproc :
-%default_pager%
+more
.RS 5
This is the program used by
.B mhl
to display message bodies (or message parts) of type text/plain.
.RE
.PP
-.BR mshproc :
-%bindir%/msh
-.RS 5
-Currently not used.
-.RE
-.PP
.BR packproc :
%bindir%/packf
.RS 5
(used by the
.B sendfiles
shell script) to
-post a message to the mail transport system. It is also called by
-.B whom
-(called with the switches
-.B \-whom
-and
-.BR \-library )
-to do address verification.
+post a message to the mail transport system.
.RE
.PP
.BR rmmproc :
.B repl
to query about the disposition of a composed draft message.
.RE
-.PP
-.BR whomproc :
-%bindir%/whom
-.RS 5
-This is the program used by
-.B whatnow
-to determine to whom a message would be sent.
-.RE
.SS "Environment Variables"
The operation of
-.B nmh
+.B mmh
and its commands it also controlled by the
presence of certain environment variables.
.PP
\*(lqWhat now?\*(rq 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
-.B nmh
+.B mmh
user, isn't it? The reason for all this is that the
-.B nmh
+.B mmh
user
can select
.B any
.IR whatnowproc ,
including
one of the standard shells. As a result, it's not possible to pass
-information via an argument list.
+information via an argument list. The convention is that environment
+variables whose names are all upper-case are user-settable; those
+whose names are lower-case only are used internally by mmh and should
+not generally be set by the user.
.PP
If the
.B WHATNOW
option was set during
-.B nmh
+.B mmh
configuration, and
if this environment variable is set, then if the commands
.BR refile\ ,
-.BR send ,
-.BR show ,
+.BR send
or
-.B whom
+.BR show
are not given any `msgs'
arguments, then they will default to using the file indicated by
.BR mh\-draft (5).
supplied by the default
.IR whatnowproc .
.PP
-.B $MH
+.B $MMH
+.RS 5
+With this environment variable, you can specify an alternative
+mmh directory. Personal mmh configuration files are located relative to
+the mmh directory.
+Non-absolute values are relative to the home directory.
+This is one of the very few exceptions in
+.B mmh
+where non-absolute pathnames are not considered relative to the user's
+mmh directory.
+.RE
+.PP
+.B $MMHP
.RS 5
With this environment variable, you can specify a profile
other than
-.I \&.mh\(ruprofile
+.I $HOME/.mmh/profile
to be read by the
-.B nmh
+.B mmh
programs
that you invoke. If the value of
-.B $MH
-is not absolute, (i.e., does
-not begin with a \*(lq/\*(rq), it will be presumed to start from the current
-working directory. This is one of the very few exceptions in
-.B nmh
-where non-absolute pathnames are not considered relative to the user's
-.B nmh
-directory.
+.B $MMHP
+is not absolute, it will be presumed to start from the mmh directory.
.RE
.PP
-.B $MHCONTEXT
+.B $MMHC
.RS 5
With this environment variable, you can specify a
context other than the normal context file (as specified in
-the
-.B nmh
-profile). As always, unless the value of
-.B $MHCONTEXT
-is absolute, it will be presumed to start from your
-.B nmh
-directory.
+the profile). As always, unless the value of
+.B $MMHC
+is absolute, it will be presumed to start from your mmh directory.
.RE
.PP
.B $MM_CHARSET
parameter of text contents containing 8\-bit characters.
.PP
When decoding text in such an alternate character set,
-.B nmh
+.B mmh
must be able to determine which characters are alphabetic, which
are control characters, etc. For many operating systems, this
will require enabling the support for locales (such as setting
.B $HOME
.RS 5
This variable tells all
-.B nmh
+.B mmh
programs your home directory
.RE
.PP
.B $TERM
.RS 5
This variable tells
-.B nmh
+.B mmh
your terminal type.
.PP
The environment variable
.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 in the current directory if
-your current working directory and the folder the message lives in are
-on the same UNIX filesystem.
+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
.PP
.B $mheditor
.RS 5
-This is set to tell the
+This is set by
+.BR comp ,
+.BR repl ,
+.BR forw ,
+and
+.B dist
+to tell the
.I whatnowproc
the user's choice of
editor (unless overridden by
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-^or $MH~^Rather than the standard profile
-^<mh\-dir>/context~^The user context
-^or $MHCONTEXT~^Rather than the standard context
-^<folder>/\&.mh\(rusequences~^Public sequences for <folder>
+.ta \w'%etcdir%/ExtraBigFileName 'u
+^$HOME/.mmh~^The user's mmh directory
+^or $MMH~^Rather than the standard mmh directory
+^$HOME/.mmh/profile~^The user's profile
+^or $MMHP~^Rather than the standard profile
+^$HOME/.mmh/context~^The user's context
+^or $MMHC~^Rather than the standard context
+^<folder>/.mh_sequences~^Public sequences for <folder>
+.fi
.SH "SEE ALSO"
nmh(1), environ(5), mh-sequence(5)
.SH HISTORY
The
-.I \&.mh\(ruprofile
+.I $HOME/.mmh/profile
contains only static information, which
-.B nmh
+.B mmh
programs will
.B NOT
update. Changes in context are made to the
-.I context
-file kept in the users
-.B nmh
-directory.
+.I $HOME/.mmh/context
+file.
This includes, but is not limited to: the \*(lqCurrent\-Folder\*(rq 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 \*(lqMh\-Sequences\*(rq
profile entry (default is
-.IR \&.mh\(rusequences ).
+.IR \&.mh_sequences ).
.PP
-The
-.I \&.mh\(ruprofile
-may override the path of the
+The profile may override the path of the
.I context
-file, by specifying a \*(lqcontext\*(rq entry (this must be in
-lower-case). If the entry is not absolute (does not start with a
-\*(lq/\*(rq), then it is interpreted relative to the user's
-.B nmh
-directory. As a result, you can actually have more than one set of
+file, by specifying a \*(lqContext\*(rq entry.
+As a result, you can actually have more than one set of
private sequences by using different context files.
.SH BUGS
-The shell quoting conventions are not available in the
-.IR \&.mh\(ruprofile .
+The shell quoting conventions are not available in the profile.
Each token is separated by whitespace.
.PP
There is some question as to what kind of arguments should be placed
in the profile as options. In order to provide a clear answer, recall
command line semantics of all
-.B nmh
+.B mmh
programs: conflicting switches
(e.g.
.B \-header
arguments) in the profile.
.PP
If one finds that an
-.B nmh
+.B mmh
program is being invoked again and again
with the same arguments, and those arguments aren't switches, then there
are a few possible solutions to this problem. The first is to create a
(soft) link in your
.I $HOME/bin
directory to the
-.B nmh
+.B mmh
program
of your choice. By giving this link a different name, you can create
a new entry in your profile and use an alternate set of defaults for
the
-.B nmh
+.B mmh
command. Similarly, you could create a small shell script
which called the
-.B nmh
+.B mmh
program of your choice with an alternate set
of invocation line switches (using links and an alternate profile entry
is preferable to this solution).
.PP
In this way, the user can avoid lengthy type-in to the shell, and still
give
-.B nmh
+.B mmh
commands safely. (Recall that some
-.B nmh
+.B mmh
commands
invoke others, and that in all cases, the profile is read, meaning that
aliases are disregarded beyond an initial command invocation)