Added "-d --" to invocation of ls when figuring out what files

[mmh] / man / mh-profile.man

diff --git a/man/mh-profile.man b/man/mh-profile.man
index 9ba9f11..949cf97 100644 (file)
--- a/man/mh-profile.man
+++ b/man/mh-profile.man
@@ -22,6 +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
@@ -31,7 +40,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 +170,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
@@ -276,6 +288,7 @@ Indicates a default draft folder for
 .BR comp ,
 .BR dist ,
 .BR forw ,
+.BR refile ,
 and
 .BR repl .
 Read the
@@ -317,8 +330,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 .
@@ -329,7 +345,8 @@ 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"
@@ -516,12 +533,6 @@ and
 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
@@ -591,24 +602,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
@@ -718,18 +711,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
@@ -757,7 +738,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
@@ -821,21 +803,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,
@@ -850,18 +817,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,
@@ -1010,7 +965,7 @@ if annotations are to occur.
 .fi
 
 .SH "SEE ALSO"
-nmh(1), environ(5), mh-sequence(5)
+nmh(7), environ(5), mh-sequence(5)
 
 .SH HISTORY
 The