Factor trim format function out
[mmh] / man / repl.man1
index f8f6eb1..7cc4110 100644 (file)
@@ -25,13 +25,12 @@ all/to/cc/me]
 .RB [ \-mime " | " \-nomime ]
 .RB [ \-editor
 .IR editor ]
-.RB [ \-noedit ]
 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-build ]
 .RB [ \-file
 .IR msgfile ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -57,15 +56,15 @@ If the switch
 .B \-nogroup
 is given (it is on by default), then
 .B repl
-will use the standard forms file \*(lqreplcomps\*(rq.  This will construct
+will use the standard forms file `replcomps'.  This will construct
 a draft message that is intended to be sent only to the author of the
-message to which you are replying.  If a file named \*(lqreplcomps\*(rq
+message to which you are replying.  If a file named `replcomps'
 exists in the user's
 .B mmh
 directory, it will be used instead of this
 default forms file.
 .PP
-The default reply template \*(lqreplcomps\*(rq will direct
+The default reply template `replcomps' will direct
 .B repl
 to construct the reply message draft as follows:
 .PP
@@ -88,7 +87,7 @@ where field names enclosed in angle brackets (<\ >) indicate the
 contents of the named field from the message to which the reply is
 being made.
 .PP
-By default, the \*(lqCc:\*(rq field is empty.  You may selectively add
+By default, the `Cc:' field is empty.  You may selectively add
 addresses to this default with the
 .B \-cc
 .I type
@@ -96,7 +95,7 @@ switch.  This switch takes an
 argument (
 .IR all / to / cc / me )
 which specifies who gets added to the default
-\*(lqCc:\*(rq list of the reply.  You may give this switch multiple times (with
+`Cc:' list of the reply.  You may give this switch multiple times (with
 different arguments) if you wish to add multiple types of addresses.
 .PP
 If the switch
@@ -104,12 +103,12 @@ If the switch
 is given, then
 .B repl
 will use the the
-standard forms file \*(lqreplgroupcomps\*(rq.  This will construct a
+standard forms file `replgroupcomps'.  This will construct a
 draft message that is intended as a group or followup reply.  If a file
-named \*(lqreplgroupcomps\*(rq exists in the user's mmh directory, it
+named `replgroupcomps' exists in the user's mmh directory, it
 will be used instead of this default forms file.
 .PP
-The default group reply template \*(lqreplgroupcomps\*(rq will direct
+The default group reply template `replgroupcomps' will direct
 .B repl
 to construct the reply message draft as follows:
 .PP
@@ -138,7 +137,7 @@ In\-Reply\-To: Message from <From> of <Date>.
 .fi
 .RE
 .PP
-By default, the \*(lqCc:\*(rq contains all the addresses shown.  You may
+By default, the `Cc:' contains all the addresses shown.  You may
 selectively remove addresses from this default with the
 .B \-nocc
 .I type
@@ -146,7 +145,7 @@ switch.
 This switch takes an argument (
 .IR all / to / cc / me )
 which specifies who gets removed
-from the default \*(lqCc:\*(rq list of the reply.  You may give this switch
+from the default `Cc:' list of the reply.  You may give this switch
 multiple times (with different arguments) if you wish to remove multiple types
 of addresses.
 .PP
@@ -161,7 +160,7 @@ switch modifies the action of
 .I type
 switch by
 interactively asking you if each address that normally would be placed in
-the \*(lqTo:\*(rq and \*(lqCc:\*(rq list should actually be sent a copy.
+the `To:' and `Cc:' list should actually be sent a copy.
 This is useful for special\-purpose replies.  Note that the position of
 the
 .B \-cc
@@ -170,22 +169,18 @@ and
 switches, like all other switches which take a
 positive and negative form, is important.
 .PP
-Lines beginning with the fields \*(lqTo:\*(rq, \*(lqCc:\*(rq, and
-\*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
+Lines beginning with the fields `To:', `Cc:', and
+`Bcc:' will be standardized and have duplicate addresses removed.
 In addition, these fields will be wrapped at a reasonable length.
 .PP
 See
 .BR comp (1)
 for a description of the
 .B \-editor
-and
-.B \-noedit
-switches.  Note that while in the editor, the message being replied
-to is available through a link named \*(lq@\*(rq (assuming the default
-.IR whatnowproc ).
-In addition, the actual pathname of the message is
+switch.  Note that while in the editor,
+the actual pathname of the message being replied to is
 stored in the environment variable
-.BR $editalt ,
+.BR $mhaltmsg ,
 and the pathname of
 the folder containing the message is stored in the environment variable
 .BR $mhfolder .
@@ -210,7 +205,7 @@ through a default message filter file and then included into the draft body
 as quotation.
 This should be adequate for most users.
 This default filter
-.RI \*(lq mhl.reply \*(rq
+.RI ` mhl.reply '
 is:
 .PP
 .RS 5
@@ -220,9 +215,9 @@ is:
 .RE
 .PP
 which outputs each line of the body of the message prefaced with the
-\*(lq>\*(rq character and a space.
+`>' character and a space.
 If a file named
-.RI \*(lq mhl.reply \*(rq
+.RI ` mhl.reply '
 exists in the user's
 .B mmh
 directory,
@@ -248,20 +243,20 @@ is:
 .RS 5
 .nf
 message-id:nocomponent,\|nonewline,\\
-formatfield=\*(lqIn message %{text},\ \*(rq
-from:nocomponent,\|formatfield=\*(lq%(decode(friendly{text})) writes:\*(rq
-body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
+formatfield=`In message %{text},\ '
+from:nocomponent,\|formatfield=`%(decode(friendly{text})) writes:'
+body:component=`>',\|overflowtext=`>',\|overflowoffset=0
 .fi
 .RE
 .PP
 This message filter file cites the Message-ID and author of the message
 being replied\-to, and then outputs each line of the body prefaced with
-the \*(lq>\*(rq character.
+the `>' character.
 .PP
 If the switch
 .B \-nofilter
 is given, then the message
-to which you are replying will not be formated and thus not included in
+to which you are replying will not be formatted and thus not included in
 the body of the draft.
 (It may be added as MIME attachment with
 .B \-mime
@@ -293,7 +288,7 @@ The annotation will be done only if the message is sent directly from
 .BR repl .
 If the message is not sent immediately from
 .BR repl ,
-.RB \*(lq "comp\ \-use" \*(rq
+.RB ` "comp\ \-use" '
 may be used to re\-edit and send the constructed
 message, but the annotations won't take place.  Annotations are always
 done inplace in order to preserve any links to the message.
@@ -327,29 +322,22 @@ The
 .B \-build
 switch is intended to be used by the Emacs mh-e interface
 to
-.BR nmh ,
-and is only present if
-.B nmh
-was compiled with support
-for mh-e.
+.BR nmh .
 It causes a file
 .I reply (in the mail storage root)
 to be created, containing the draft message that would normally be presented
 to the user for editing.
 No
 .B whatnow
-programm is invoked.
-No mail is actually sent. Note that this switch is not guaranteed to
-be present or to have the same effects in future versions of
-.BR nmh :
-it is documented here only for completeness.
+program is invoked.
+No mail is actually sent.
 .PP
 The
 .B \-file
 .I msgfile
 switch specifies the message to be replied to as an
 exact filename rather than as an
-.B nmh
+.B mh
 folder and message number. It is
 intended to be used by the
 .B msh
@@ -365,7 +353,7 @@ switch.
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^%etcdir%/replcomps~^The standard reply template
 ^or $HOME/.mmh/replcomps~^Rather than the standard template
-^%etcdir%/replgroupcomps~^The standard `reply -group' template
+^%etcdir%/replgroupcomps~^The standard `reply \-group' template
 ^or $HOME/.mmh/replgroupcomps~^Rather than the standard template
 ^%etcdir%/mhl.reply~^The standard message filter
 ^or $HOME/.mmh/mhl.reply~^Rather than the standard filter
@@ -384,7 +372,7 @@ switch.
 ^Draft\-Folder:~^To set the default draft\-folder
 ^Editor:~^To override the default editor
 ^Msg\-Protect:~^To set mode when creating a new message (draft)
-^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
+^whatnowproc:~^Program to ask the `What now?' questions
 .fi
 
 .SH "SEE ALSO"
@@ -393,7 +381,7 @@ mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
-.RB ` msg "' defaults to cur"
+.RB ` msg "' defaults to the current message"
 .RB ` \-nogroup '
 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
 .RB ` \-noannotate '
@@ -414,7 +402,4 @@ uses the sender's host.
 Moral of the story: if you're going to include addresses in a reply
 template, include the host portion of the address.
 .PP
-If your current working directory is not writable, the link named
-\*(lq@\*(rq is not available.
-.PP
 The quotation of the original message does not get transfer-decoded, yet.