Add "Default-From" config option
[mmh] / man / mh-profile.man5
index d47b78f..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)
@@ -156,7 +155,7 @@ to page the
 .B mhl
 formatted message when displaying to a terminal.  It is also the default
 program used by
-.B mhshow
+.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.
@@ -174,22 +173,6 @@ to send mail.
 (profile, default: %sendmailpath%)
 .RE
 .PP
-.BR Backup-Prefix :
-,
-.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: `,')
-.RE
-.PP
-.BR AltMsg-Link :
-@
-.RS 5
-Name of the link to the file to which you are replying or which you are
-redistributing. See `$mhaltmsg' below.
-(profile, default: `@')
-.RE
-.PP
 .BR Attachment-Header :
 Attach
 .RS 5
@@ -199,37 +182,61 @@ If you like to type a lot, name it `X-MH-Attachment'.
 (profile, default: `Attach')
 .RE
 .PP
+.BR Sign-Header :
+Sign
+.RS 5
+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 Enc-Header :
+Enc
+.RS 5
+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 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
+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 :
@@ -237,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
@@ -250,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 ,
@@ -259,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
@@ -274,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
@@ -304,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
@@ -312,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 :
@@ -334,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
@@ -375,11 +384,11 @@ environment variable
 .BR $SIGNATURE .
 If
 .B $SIGNATURE
-is not set and this profile entry is not present, the \*(lqgcos\*(rq field of
+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
 
@@ -392,57 +401,19 @@ The profile can be used to select alternate programs if the
 user wishes.  The default values are given in the examples.
 .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 listproc :
-show \-file
+show
 .RS 5
 This program is used to list the contents of a message in response
 to the
 .B list
 and
 .B display
-directive at the \*(lqWhat now?\*(rq prompt.
+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 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 whatnowproc :
 %bindir%/whatnow
 .RS 5
@@ -462,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
@@ -555,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
@@ -577,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
@@ -586,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
@@ -638,22 +609,6 @@ 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.
@@ -666,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
@@ -691,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
@@ -754,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
@@ -791,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.