Add "Default-From" config option

[mmh] / man / mh-profile.man5

diff --git a/man/mh-profile.man5 b/man/mh-profile.man5
index 2f67c63..9b052c9 100644 (file)
--- a/man/mh-profile.man5
+++ b/man/mh-profile.man5
@@ -38,7 +38,7 @@ context, and indicates what the default value is.
 .BR Path :
 Mail
 .RS 5
 .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
 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.
 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 :
 .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
 \&!
 .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)
 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 ,
 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

@@ -125,7 +124,7 @@ entry blank.  (profile, default: \&.mh_sequences)
 .BI atr\- seq \- folder :
 172\0178\-181\0212
 .RS 5
 .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)
 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 :
 .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

@@ -156,22 +173,6 @@ to send mail.
 (profile, default: %sendmailpath%)
 .RE
 .PP
 (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
 .BR Attachment-Header :
 Attach
 .RS 5

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

@@ -206,7 +244,7 @@ for an explanation of the octal number.
 .RS 5
 Sets default switches to be used whenever the mmh program
 .I program
 .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
 component when replying to messages by adding a component such as:
 .PP
 .RS 5

@@ -219,8 +257,8 @@ repl: \-editor /bin/ed
 .IB lasteditor "-next:"
 .I nexteditor
 .RS 5
 .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 ,
 in
 .BR comp ,
 .BR dist ,

@@ -228,9 +266,9 @@ in
 and
 .BR repl .
 After editing
 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
 (profile, no default)
 .RE
 .PP

@@ -243,21 +281,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

@@ -273,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
 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
 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

@@ -281,18 +304,26 @@ or both ends of the mailbox and host to indicate wild-card matching.
 (profile, default: your user-id)
 .RE
 .PP
 (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 Aliasfile :
 aliases
 .I other-alias
 .RS 5
 Indicates aliases files for

-.BR ali
-and
+.BR ali ,

 .BR send .
 .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 :
 .RE
 .PP
 .BR Draft\-Folder :

@@ -303,6 +334,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

@@ -344,11 +384,11 @@ environment variable
 .BR $SIGNATURE .
 If
 .B $SIGNATURE
 .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
 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
 
 signature text.  (profile, no default)
 .RE
 

@@ -361,153 +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
 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 :
-show -file
+.BR listproc :
+show

 .RS 5
 This program is used to list the contents of a message in response
 to the
 .B list
 and
 .B display
 .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
 The absolute pathname of the message to list will be appended to
 the command line given.
 .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
-.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.
-.RE
-.PP

 .BR whatnowproc :
 %bindir%/whatnow
 .RS 5
 .BR whatnowproc :
 %bindir%/whatnow
 .RS 5

@@ -527,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
 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
 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
 .B mmh
 user, isn't it?  The reason for all this is that the
 .B mmh

@@ -620,7 +526,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

@@ -642,7 +548,7 @@ to iso_8859_1).
 .RS 5
 This variable tells
 .B inc
 .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
 .RE
 .PP
 .B $SIGNATURE

@@ -651,7 +557,7 @@ This variable tells
 .B send
 and
 .B post
 .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
 .RE
 .PP
 .B $HOME

@@ -668,6 +574,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

@@ -687,22 +609,6 @@ how many
 lines long your terminal screen is.
 .RE
 .PP
 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.
 .B $mhdraft
 .RS 5
 This is the path to the working draft.

@@ -715,20 +621,10 @@ and
 .B repl
 to tell the
 .I whatnowproc
 .B repl
 to tell the
 .I whatnowproc

-which file to ask \*(lqWhat now?\*(rq
+which file to ask `What now?'

 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

@@ -740,6 +636,13 @@ to tell the
 .I whatnowproc
 about an alternate message associated with the
 draft (the message being distributed or replied to).
 .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
 .RE
 .PP
 .B $mhdist

@@ -803,15 +706,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

@@ -840,15 +735,15 @@ programs will
 update.  Changes in context are made to the
 .I $HOME/.mmh/context
 file.
 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
 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
 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.
 
 As a result, you can actually have more than one set of
 private sequences by using different context files.