Manpage SEE ALSO cleanup.
[mmh] / man / mh-profile.man
index b124388..a7c97d0 100644 (file)
@@ -1,7 +1,7 @@
+.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .\"
 .\" %nmhwarning%
 .\"
-.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mh-profile \- user profile customization for nmh message handler
 .SH SYNOPSIS
@@ -22,7 +22,15 @@ family of programs.  Each entry in the file is of the format
 .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
 entry is `Path:'.  The others are optional; some have default values if
@@ -31,7 +39,9 @@ indicates whether the information is kept in the user's
 .B nmh
 profile or
 .B nmh
-context, and indicates what the default value is.
+context, and indicates what the default value is.  Note that a profile
+component can only appear once.  Multiple appearances with trigger a
+warning that all appearances after the first are ignored.
 .PP
 .BR Path :
 Mail
@@ -159,7 +169,8 @@ composition draft before it is sent.
 An octal number which defines the permission bits for new message files.
 See
 .BR chmod (1)
-for an explanation of the octal number.
+for an explanation of the octal number.  Note that some filesystems,
+such as FAT32, do not support removal of read file permissions.
 (profile, default: 0600)
 .RE
 .PP
@@ -318,8 +329,11 @@ superseded by the environment variable
 .BR Signature :
 RAND MH System (agent: Marshall Rose)
 .RS 5
-Tells
-.B send
+Tells front-end programs such as
+.BR comp,
+.BR forw,
+and
+.B repl
 your mail signature.  This is superseded by the
 environment variable
 .BR $SIGNATURE .
@@ -330,9 +344,9 @@ 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
-signature text.  (profile, no default)
+signature text.  The \*(lqLocal\-Mailbox\*(rq profile component
+supersedes all of this.  (profile, no default)
 .RE
-
 .SS "Process Profile Entries"
 The following profile elements are used whenever an
 .B nmh
@@ -413,6 +427,9 @@ also used by the draft folder facility in
 and
 .B repl
 to display the draft message.
+(Note that
+.B $PAGER
+supersedes the default built-in pager command.)
 .RE
 .PP
 .BR mailproc :
@@ -472,6 +489,9 @@ 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.
+(Note that
+.B $PAGER
+supersedes the default built-in pager command.)
 .RE
 .PP
 .BR mshproc :
@@ -560,7 +580,6 @@ 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
@@ -586,24 +605,6 @@ variables whose names are all upper-case are user-settable; those
 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
@@ -713,18 +714,6 @@ the environment variable
 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
@@ -752,7 +741,8 @@ This variable tells
 .B send
 and
 .B post
-your mail signature. This supersedes the \*(lqSignature\*(rq profile entry.
+your mail signature. This supersedes the \*(lqSignature\*(rq profile entry,
+and is not used when the \*(lqLocal\-Mailbox\*(rq profile component is set.
 .RE
 .PP
 .B $USER
@@ -816,21 +806,6 @@ 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,
@@ -845,18 +820,6 @@ If this variable is set to a non-null value,
 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,
@@ -867,6 +830,12 @@ profile entry will display debugging information
 about the values in that entry.
 .RE
 .PP
+.B $PAGER
+.RS 5
+If set to a non-null value, this supersedes the value of
+the default built-in pager command.
+.RE
+.PP
 .B $editalt
 .RS 5
 This is the alternate message.
@@ -992,7 +961,6 @@ and
 .B repl
 if annotations are to occur.
 .RE
-
 .SH FILES
 .fc ^ ~
 .nf
@@ -1003,10 +971,10 @@ if annotations are to occur.
 ^or $MHCONTEXT~^Rather than the standard context
 ^<folder>/\&.mh\(rusequences~^Public sequences for <folder>
 .fi
-
 .SH "SEE ALSO"
-nmh(1), environ(5), mh-sequence(5)
-
+.IR environ (5),
+.IR mh-sequence (5),
+.IR nmh (7)
 .SH HISTORY
 The
 .I \&.mh\(ruprofile
@@ -1035,7 +1003,6 @@ lower-case).  If the entry is not absolute (does not start with a
 .B nmh
 directory.  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 .