Add "Default-From" config option
[mmh] / man / mh-profile.man5
index 053213a..9b052c9 100644 (file)
@@ -38,7 +38,7 @@ context, and indicates what the default value is.
 .BR Path :
 Mail
 .RS 5
-Sets the user's mail storage to \*(lqMail\*(rq.  This is the
+Sets the user's mail storage to `Mail'.  This is the
 only mandatory profile entry.  (profile, no default)
 .RE
 .PP
@@ -59,7 +59,7 @@ section below.
 inbox
 .RS 5
 Keeps track of the current open folder.
-(context, default: folder specified by \*(lqInbox\*(rq)
+(context, default: folder specified by `Inbox')
 .RE
 .PP
 .BR Inbox :
@@ -87,8 +87,8 @@ man page for the details about this sequence. (profile, no default)
 \&!
 .RS 5
 Defines the string which, when prefixed to a sequence name, negates
-that sequence.  Hence, \*(lq!foo\*(rq means all those messages that
-are not a member of the sequence \*(lqfoo\*(rq.
+that sequence.  Hence, `!foo' means all those messages that
+are not a member of the sequence `foo'.
 To deactivate this mechanism, define Sequence\-Negation to an empty value.
 Read the
 .BR mh\-sequence (7)
@@ -102,7 +102,6 @@ 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
@@ -125,7 +124,7 @@ entry blank.  (profile, default: \&.mh_sequences)
 .BI atr\- seq \- folder :
 172\0178\-181\0212
 .RS 5
-Keeps track of the private sequence called \*(lqseq\*(rq in the specified
+Keeps track of the private sequence called `seq' in the specified
 folder.  Private sequences are generally used for read\-only folders.
 See the
 .BR mh\-sequence (7)
@@ -134,7 +133,7 @@ man page for details about private sequences.
 .RE
 .PP
 .BR Editor :
-/usr/bin/vi
+vi
 .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 .
+This profile entry overrides the $VISUAL and $EDITOR environment variables,
+but gets overridden by the $MMHEDITOR environment variabel.
 (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
@@ -156,50 +173,70 @@ to send mail.
 (profile, default: %sendmailpath%)
 .RE
 .PP
-.BR Backup-Prefix :
-,
+.BR Attachment-Header :
+Attach
 .RS 5
-The prefix that is prepended to the name of message files when they
-are ``removed'' by rmm. This should typically be `,' or `#'.
-(profile, 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 AltMsg-Link :
-@
+.BR Sign-Header :
+Sign
 .RS 5
-Name of the link to the file to which you are replying or which you are
-redistributing. See `$mhaltmsg' below.
-(profile, default: `@')
+The (pseudo) header in draft messages, that requests the message to be
+signed automatically by
+.BR send ,
+using
+.BR mhsign .
+If you like to type a lot, name it `X-MH-Sign-This-Message'.
+(profile, default: `Sign')
 .RE
 .PP
-.BR automimeproc :
+.BR Enc-Header :
+Enc
 .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 requests the message to be
+signed and encrypted by
+.BR send ,
+using
+.BR mhsign .
+If you like to type a lot, name it `X-MH-Encrypt-This-Message'.
+(profile, default: `Enc')
+.RE
+.PP
+.BR Mime-Type-Query :
+file \-b \-\-mime
+.RS 5
+A command that prints the MIME type of a given file.
+The file name is appended to the command line.
+Note: Older versions of file(1) won't generate the desired output.
+file-4.26, for instance, omits a required semicolon.
+file-5.04 is known to work.
+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
+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.
-(profile, default: 0644)
+(profile, default: 0600)
 .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.
-(profile, default: 700)
+(profile, default: 0700)
 .RE
 .PP
 .IR program :
@@ -207,7 +244,7 @@ for an explanation of the octal number.
 .RS 5
 Sets default switches to be used whenever the mmh program
 .I program
-is invoked.  For example, one could override the \*(lqEditor:\*(rq profile
+is invoked.  For example, one could override the `Editor:' profile
 component when replying to messages by adding a component such as:
 .PP
 .RS 5
@@ -220,8 +257,8 @@ repl: \-editor /bin/ed
 .IB lasteditor "-next:"
 .I nexteditor
 .RS 5
-Names \*(lqnexteditor\*(rq to be the default editor after using
-\*(lqlasteditor\*(rq.  This takes effect at \*(lqWhat now?\*(rq prompt
+Names `nexteditor' to be the default editor after using
+`lasteditor'.  This takes effect at `What now?' prompt
 in
 .BR comp ,
 .BR dist ,
@@ -229,9 +266,9 @@ in
 and
 .BR repl .
 After editing
-the draft with \*(lqlasteditor\*(rq, the default editor is set to be
-\*(lqnexteditor\*(rq.  If the user types \*(lqedit\*(rq without any
-arguments to \*(lqWhat now?\*(rq, then \*(lqnexteditor\*(rq is used.
+the draft with `lasteditor', the default editor is set to be
+`nexteditor'.  If the user types `edit' without any
+arguments to `What now?', then `nexteditor' is used.
 (profile, no default)
 .RE
 .PP
@@ -244,21 +281,6 @@ command.
 (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
@@ -274,7 +296,7 @@ reply, and
 scan
 knows if the message really originated from you.
 Addresses must be separated by a comma, and the hostnames listed should
-be the \*(lqofficial\*(rq hostnames for the mailboxes you indicate, as
+be the `official' hostnames for the mailboxes you indicate, as
 local nicknames for hosts are not replaced with their official site names.
 For each address, if a host is not given, then that address on any host is
 considered to be you.  In addition, an asterisk (`*') may appear at either
@@ -282,18 +304,26 @@ or both ends of the mailbox and host to indicate wild-card matching.
 (profile, default: your user-id)
 .RE
 .PP
+.BR Default-From :
+Philipp Takacs <philipp@bureaucracy.de>
+.RS 5
+Tells
+.B spost
+which addresse shall be used, if the draft dosn\'t contain a
+.RI ` From '
+Header or the draft is not from the user.
+.RE
+.PP
 .BR Aliasfile :
 aliases
 .I other-alias
 .RS 5
 Indicates aliases files for
-.BR ali
-and
+.BR ali ,
 .BR send .
-This may be used instead of the
-.B \-alias
-.I file
-switch.  (profile, no default)
+and
+.BR spost .
+(profile, no default)
 .RE
 .PP
 .BR Draft\-Folder :
@@ -304,6 +334,15 @@ Changes the default draft folder.  Read the
 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
@@ -345,14 +384,11 @@ environment variable
 .BR $SIGNATURE .
 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
+is not set and this profile entry is not present, the `gcos' field of
+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
+puts in the `From:' header; do not include an address in the
 signature text.  (profile, no default)
 .RE
 
@@ -365,169 +401,17 @@ The profile can be used to select alternate programs if the
 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
-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
 .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.  When the
-.B \-format
-or
-.B \-filter
-option is used
-by
-.B forw
-or
-.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 postproc :
-%libdir%/post
-.RS 5
-This is the program used by
-.BR send ,
-.BR mhmail ,
-.BR rcvdist ,
 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 `What now?' prompt.
+The absolute pathname of the message to list will be appended to
+the command line given.
 .RE
 .PP
 .BR whatnowproc :
@@ -549,9 +433,9 @@ and its commands it also controlled by the
 presence of certain environment variables.
 .PP
 Many of these environment variables are used internally by the
-\*(lqWhat now?\*(rq interface.  It's amazing all the information
+`What now?' interface.  It's amazing all the information
 that has to get passed via environment variables to make the
-\*(lqWhat now?\*(rq interface look squeaky clean to the
+`What now?' interface look squeaky clean to the
 .B mmh
 user, isn't it?  The reason for all this is that the
 .B mmh
@@ -642,7 +526,7 @@ a character set that doesn't match
 .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
@@ -664,7 +548,7 @@ to iso_8859_1).
 .RS 5
 This variable tells
 .B inc
-the default maildrop. This supersedes the \*(lqMailDrop\*(rq profile entry.
+the default maildrop. This supersedes the `MailDrop' profile entry.
 .RE
 .PP
 .B $SIGNATURE
@@ -673,7 +557,7 @@ This variable tells
 .B send
 and
 .B post
-your mail signature. This supersedes the \*(lqSignature\*(rq profile entry.
+your mail signature. This supersedes the `Signature' profile entry.
 .RE
 .PP
 .B $HOME
@@ -690,6 +574,22 @@ This variable tells
 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
@@ -703,29 +603,12 @@ these tell
 .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.
 .RE
 .PP
-.B $editalt
-.RS 5
-This is the alternate message.
-.PP
-This is set by
-.B dist
-and
-.B repl
-during edit sessions so you can peruse the message being distributed or
-replied to.  The message is also available through a link called
-\*(lq@\*(rq (if not changed by
-.BR altmsg-link )
-in the current directory if your current working directory
-and the message's folder are on the same UNIX filesystem.
-.RE
-.PP
 .B $mhdraft
 .RS 5
 This is the path to the working draft.
@@ -738,20 +621,10 @@ and
 .B repl
 to tell the
 .I whatnowproc
-which file to ask \*(lqWhat now?\*(rq
+which file to ask `What now?'
 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
@@ -763,6 +636,13 @@ to tell the
 .I whatnowproc
 about an alternate message associated with the
 draft (the message being distributed or replied to).
+It is also set during edit sessions so you can peruse the
+message being distributed or replied to.
+This variable replaces the older
+.B $editalt
+variable.
+There used to be a link named `@' in the working directory, pointing
+to the alternate message, there is no such link anymore.
 .RE
 .PP
 .B $mhdist
@@ -816,16 +696,6 @@ and
 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.
@@ -836,15 +706,7 @@ and
 .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
@@ -873,15 +735,15 @@ programs will
 update.  Changes in context are made to the
 .I $HOME/.mmh/context
 file.
-This includes, but is not limited to: the \*(lqCurrent\-Folder\*(rq entry
+This includes, but is not limited to: the `Current\-Folder' entry
 and all private sequence information.  Public sequence information is
-kept in each folder in the file determined by the \*(lqMh\-Sequences\*(rq
+kept in each folder in the file determined by the `Mh\-Sequences'
 profile entry (default is
 .IR \&.mh_sequences ).
 .PP
 The profile may override the path of the
 .I context
-file, by specifying a \*(lqContext\*(rq entry.
+file, by specifying a `Context' entry.
 As a result, you can actually have more than one set of
 private sequences by using different context files.