Removed the `mhbuild' indirection via `buildmimeproc'.
[mmh] / man / mh-profile.man5
index d94f301..b5e731a 100644 (file)
@@ -134,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 ,
@@ -142,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
@@ -181,6 +199,19 @@ 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 :
 644
 .RS 5
 .BR Msg\-Protect :
 644
 .RS 5
@@ -361,15 +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 send
-to process MIME composition files, created from drafts which require
-MIME features.
-.RE
-.PP
 .BR fileproc :
 %bindir%/refile
 .RS 5
 .BR fileproc :
 %bindir%/refile
 .RS 5
@@ -400,19 +422,16 @@ is invoked with no arguments.
 .RE
 .PP
 .BR lproc :
 .RE
 .PP
 .BR lproc :
-more
+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 :
@@ -432,54 +451,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.
+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 ,
@@ -520,7 +510,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
@@ -687,6 +677,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
@@ -700,8 +706,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.
@@ -813,16 +818,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.