Factor trim format function out
[mmh] / man / mh-profile.man5
index 19250b3..dd8196f 100644 (file)
@@ -3,11 +3,7 @@
 .\"
 .TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 .\"
 .TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-mh-profile \- user profile customization for mmh message handler
-.SH SYNOPSIS
-.I $HOME/.mmh/profile
-.br
-.I $HOME/.mmh/context
+mh-profile \- user customization for the mmh message handler
 .SH DESCRIPTION
 Each user of
 .B mmh
 .SH DESCRIPTION
 Each user of
 .B mmh
@@ -173,26 +169,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 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
-.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
@@ -202,15 +178,39 @@ 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
 .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
 .BR print\-mimetype ,
 which is part of mmh, but guesses MIME types by file name extensions only.
 .RE
@@ -300,18 +300,27 @@ 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 address to use, if the draft dosn't contain a
+.RI ` From '
+Header or the draft is not from the user.
+(profile, no default)
+.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 :
@@ -382,7 +391,7 @@ signature text.  (profile, no default)
 
 .SS "Process Profile Entries"
 The following profile elements are used whenever an
 
 .SS "Process Profile Entries"
 The following profile elements are used whenever an
-.B nmh
+.B mmh
 program invokes some other program such as
 .BR more .
 The profile can be used to select alternate programs if the
 program invokes some other program such as
 .BR more .
 The profile can be used to select alternate programs if the
@@ -390,7 +399,7 @@ user wishes.  The default values are given in the examples.
 .RE
 .PP
 .BR listproc :
 .RE
 .PP
 .BR listproc :
-show \-file
+show
 .RS 5
 This program is used to list the contents of a message in response
 to the
 .RS 5
 This program is used to list the contents of a message in response
 to the
@@ -597,22 +606,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
-`@' (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.
@@ -640,6 +633,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
@@ -712,10 +712,13 @@ distributed or replied to.
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/.mmh~^The user's mmh directory
 ^or $MMH~^Rather than the standard mmh directory
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/.mmh~^The user's mmh directory
 ^or $MMH~^Rather than the standard mmh directory
+.sp
 ^$HOME/.mmh/profile~^The user's profile
 ^or $MMHP~^Rather than the standard profile
 ^$HOME/.mmh/profile~^The user's profile
 ^or $MMHP~^Rather than the standard profile
+.sp
 ^$HOME/.mmh/context~^The user's context
 ^or $MMHC~^Rather than the standard context
 ^$HOME/.mmh/context~^The user's context
 ^or $MMHC~^Rather than the standard context
+.sp
 ^<folder>/.mh_sequences~^Public sequences for <folder>
 .fi
 
 ^<folder>/.mh_sequences~^Public sequences for <folder>
 .fi