Renamed -version switch to -Version to remove the conflict with -verbose.

[mmh] / man / mh-profile.man5

diff --git a/man/mh-profile.man5 b/man/mh-profile.man5
index 57e27cb..7768f7a 100644 (file)
--- a/man/mh-profile.man5
+++ b/man/mh-profile.man5
@@ -102,7 +102,6 @@ Names the sequence or sequences which shall contain any unread messages.
 The commands
 .BR inc ,
 .BR rcvstore ,
 The commands
 .BR inc ,
 .BR rcvstore ,

-.BR mhshow ,

 and
 .B show
 will add or remove messages from these
 and
 .B show
 will add or remove messages from these

@@ -134,7 +133,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 ,

@@ -142,9 +141,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 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
 .BR Sendmail :
 /usr/sbin/sendmail
 .RS 5

@@ -160,7 +177,11 @@ to send mail.
 ,
 .RS 5
 The prefix that is prepended to the name of message files when they
 ,
 .RS 5
 The prefix that is prepended to the name of message files when they

-are ``removed'' by rmm. This should typically be `,' or `#'.
+are backup'd for some reason.
+.BR send ,
+for instance, does this.
+Note: rmm does NOT anymore use the backup prefix.
+It should typically be set to `,' or `#'.

 (profile, default: `,')
 .RE
 .PP
 (profile, default: `,')
 .RE
 .PP

@@ -181,24 +202,37 @@ If you like to type a lot, name it `X-MH-Attachment'.
 (profile, default: `Attach')
 .RE
 .PP
 (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 :
 .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.
 .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 :
 .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.
 .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 :
 .RE
 .PP
 .IR program :

@@ -243,21 +277,6 @@ command.
 (context, 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
 .BR Alternate\-Mailboxes :
 mh@uci\-750a, bug-mh*
 .RS 5

@@ -303,6 +322,15 @@ Changes the default draft folder.  Read the
 man page for details. (profile, default: +drafts)
 .RE
 .PP
 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
 .BI digest\-issue\- list :
 1
 .RS 5

@@ -361,154 +389,17 @@ 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 send
-to process MIME composition files, created from drafts which require
-MIME features.
-.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 \-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
-.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.
-Unless the
-.B \-nofilter
-option is used with
-.BR repl ,
-the
-.I mhlproc
-is used to filter the
-message to which you are replying.
-.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
 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 \*(lqWhat now?\*(rq prompt.
+The absolute pathname of the message to list will be appended to
+the command line given.

 .RE
 .PP
 .BR whatnowproc :
 .RE
 .PP
 .BR whatnowproc :

@@ -623,7 +514,7 @@ a character set that doesn't match
 .BR $MM_CHARSET .
 This variable is
 checked by
 .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
 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

@@ -671,6 +562,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

@@ -684,8 +591,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.

@@ -723,16 +629,6 @@ which file to ask \*(lqWhat now?\*(rq
 questions about.
 .RE
 .PP
 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
 .B $mhaltmsg
 .RS 5
 .B dist

@@ -807,15 +703,7 @@ and
 .B repl
 during edit sessions so you
 can peruse other messages in the current folder besides the one being
 .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
 .RE
 
 .SH FILES