s/lproc/listproc/

[mmh] / man / mh-profile.man5

diff --git a/man/mh-profile.man5 b/man/mh-profile.man5
index 63633fd..9ffa117 100644 (file)
--- a/man/mh-profile.man5
+++ b/man/mh-profile.man5
@@ -84,32 +84,34 @@ man page for the details about this sequence. (profile, no default)
 .RE
 .PP
 .BR Sequence\-Negation :
 .RE
 .PP
 .BR Sequence\-Negation :

-not
+\&!

 .RS 5
 Defines the string which, when prefixed to a sequence name, negates
 .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, \*(lq!foo\*(rq means all those messages that
+are not a member of the sequence \*(lqfoo\*(rq.
+To deactivate this mechanism, define Sequence\-Negation to an empty value.
+Read the

 .BR mh\-sequence (7)
 .BR mh\-sequence (7)

-man page for the details.  (profile, no default)
+man page for the details.  (profile, default: !)

 .RE
 .PP
 .BR Unseen\-Sequence :
 .RE
 .PP
 .BR Unseen\-Sequence :

-unseen
+u

 .RS 5
 .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
 .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.
 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 :
 .RE
 .PP
 .BR Mh\-Sequences :

@@ -132,7 +134,7 @@ man page for details about private sequences.
 .RE
 .PP
 .BR Editor :
 .RE
 .PP
 .BR Editor :

-/usr/bin/vi
+vi

 .RS 5
 Defines the editor to be used by the commands
 .BR comp ,
 .RS 5
 Defines the editor to be used by the commands
 .BR comp ,

@@ -140,9 +142,27 @@ Defines the editor to be used by the commands
 .BR forw ,
 and
 .BR repl .
 .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
 (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 mhshow
+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
 .BR Sendmail :
 /usr/sbin/sendmail
 .RS 5

@@ -170,14 +190,26 @@ redistributing. See `$mhaltmsg' below.
 (profile, default: `@')
 .RE
 .PP
 (profile, default: `@')
 .RE
 .PP

-.BR automimeproc :
+.BR Attachment-Header :
+Attach

 .RS 5
 .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 :
 .RE
 .PP
 .BR Msg\-Protect :

@@ -344,11 +376,8 @@ environment variable
 If
 .B $SIGNATURE
 is not set and this profile entry is not present, the \*(lqgcos\*(rq field of
 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
+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)
 .B send
 puts in the \*(lqFrom:\*(rq header; do not include an address in the
 signature text.  (profile, no default)

@@ -363,14 +392,6 @@ The profile can be used to select alternate programs if the
 user wishes.  The default values are given in the examples.
 .RE
 .PP
 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
 .BR fileproc :
 %bindir%/refile
 .RS 5

@@ -391,37 +412,17 @@ response to the
 directive at the \*(lqWhat now?\*(rq prompt.
 .RE
 .PP
 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
 .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
 and

-.B repl
-to display the draft message.
+.B display
+directive at the \*(lqWhat now?\*(rq prompt.
+The absolute pathname of the message to list will be appended to
+the command line given.

 .RE
 .PP
 .BR mailproc :
 .RE
 .PP
 .BR mailproc :

@@ -441,60 +442,25 @@ It is used to retrieve an external-body with access-type `mail-server'
 .RE
 .PP
 .BR mhlproc :
 .RE
 .PP
 .BR mhlproc :

-%libdir%/mhl
+%bindir%/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
 .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
+of MIME messages.
+Unless the
+.B \-nofilter
+option is used with

 .BR repl ,
 the
 .I mhlproc
 is used to filter the
 .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.
+message to which you are replying.

 .RE
 .PP
 .BR postproc :
 .RE
 .PP
 .BR postproc :

-%libdir%/post
+%bindir%/post

 .RS 5
 This is the program used by
 .BR send ,
 .RS 5
 This is the program used by
 .BR send ,

@@ -518,12 +484,6 @@ and
 to delete a message from a folder.
 .RE
 .PP
 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
 .BR sendproc :
 %bindir%/send
 .RS 5

@@ -541,7 +501,7 @@ to process and display non-text (MIME) messages.
 .RE
 .PP
 .BR showproc :
 .RE
 .PP
 .BR showproc :

-%libdir%/mhl
+%bindir%/mhl

 .RS 5
 This is the program used by
 .B show
 .RS 5
 This is the program used by
 .B show

@@ -708,6 +668,22 @@ This variable tells
 the default shell to run
 .RE
 .PP
 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 $TERM
 .RS 5
 This variable tells

@@ -721,8 +697,7 @@ these tell
 .B scan
 and
 .B mhl
 .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 mhl
 how many
 lines long your terminal screen is.

@@ -834,16 +809,6 @@ and
 if annotations are to occur.
 .RE
 .PP
 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 $mhfolder
 .RS 5
 This is the folder containing the alternate message.