Removed the mhlproc profile entry. Call mhl directly.
[mmh] / man / repl.man1
index a187483..5643286 100644 (file)
@@ -19,13 +19,10 @@ all/to/cc/me]
 .RB [ \-query " | " \-noquery ]
 .RB [ \-form
 .IR formfile ]
-.RB [ \-format " | " \-noformat ]
 .RB [ \-filter
-.IR filterfile ]
-.RB [ \-inplace " | " \-noinplace ]
+.IR filterfile
+.RB " | " \-nofilter ]
 .RB [ \-mime " | " \-nomime ]
-.RB [ \-fcc
-.IR +folder ]
 .RB [ \-editor
 .IR editor ]
 .RB [ \-noedit ]
@@ -77,7 +74,7 @@ to construct the reply message draft as follows:
 .nf
 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
 Cc: <To> and <Cc> and <personal address>
-Fcc: {fcc switch} or +sent
+Fcc: +sent
 Subject: Re: <Subject>
 In\-Reply\-To: <Message\-Id>
 References: <Message\-Id>
@@ -209,24 +206,10 @@ will invoke
 .B mhl
 to format the message to which you are replying.
 .PP
-The switches
-.BR \-noformat ,
-.BR \-format ,
-and
-.B \-filter
-.I filterfile
-specify
-which message filter file to use.
-.PP
-If the switch
-.B \-noformat
-is given (it is the default), then the message
-to which you are replying is not included in the body of the draft.
-.PP
-If the switch
-.B \-format
-is given, then a default message filter file
-is used.  This default message filter should be adequate for most users.
+By default, the original message gets filtered
+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
 is:
@@ -239,14 +222,14 @@ is:
 .PP
 which outputs each line of the body of the message prefaced with the
 \*(lq>\*(rq character and a space.
-.PP
 If a file named
 .RI \*(lq mhl.reply \*(rq
 exists in the user's
 .B mmh
 directory,
-it will be used instead of this form.  You may specify an alternate
-message filter file with the switch
+it will be used instead of this form.
+.PP
+You may specify an alternate message filter file with the switch
 .B \-filter
 .IR filterfile .
 .PP
@@ -276,65 +259,49 @@ 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.
 .PP
-To use the MIME rules for encapsulation, specify the
+If the switch
+.B \-nofilter
+is given, then the message
+to which you are replying will not be formated and thus not included in
+the body of the draft.
+(It may be added as MIME attachment with
+.B \-mime
+though.)
+.PP
+To MIME-attach the original message, specify the
 .B \-mime
 switch.
-This directs
-.B repl
-to add an attachment header field, for which
-.B send
-will care.
+Note: In mmh, the \-mime switch is unrelated to
+the \-filter and \-nofilter switches.
+It is therefore possible to have the original message quoted in the body
+.B and
+attached as MIME part.
+However, using the \-mime switch is discouraged.
+It may get removed in the future.
 .PP
 If the
 .B \-annotate
 switch is given, the message being replied\-to will
-be annotated with the lines
+be annotated with the line:
 .PP
 .RS 5
+.nf
 Replied:\ date
-Replied:\ addrs
+.fi
 .RE
 .PP
-where the address list contains one line for each addressee.
 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
 may be used to re\-edit and send the constructed
-message, but the annotations won't take place.  Normally annotations are
-done inplace in order to preserve any links to the message.  You may use
-the
-.B \-noinplace
-switch to change this.
+message, but the annotations won't take place.  Annotations are always
+done inplace in order to preserve any links to the message.
 .PP
-Although the default template specifies that a copy of the reply will be
+The default template specifies that a copy of the reply will be
 put in
-the folder 'sent',
-if the
-.B \-fcc
-.I +folder
-switch is given it will override the default value.
-More than one folder, each preceded by
-.B \-fcc
-can
-be named.
-.PP
-In addition to the standard
-.BR mh\-format (5)
-escapes,
-.B repl
-also recognizes the following additional
-.I component
-escape:
-.PP
-.RS 5
-.nf
-.ta \w'Escape  'u +\w'Returns  'u
-.I Escape      Returns Description
-fcc    string  Any folders specified with `\-fcc\ folder'
-.fi
-.RE
+the folder 'sent'.
 .PP
 To avoid reiteration,
 .B repl
@@ -424,7 +391,6 @@ switch.
 ^Editor:~^To override the default editor
 ^Msg\-Protect:~^To set mode when creating a new message (draft)
 ^fileproc:~^Program to refile the message
-^mhlproc:~^Program to filter message being replied\-to
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
 
@@ -438,8 +404,6 @@ mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
 .RB ` \-nogroup '
 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
 .RB ` \-noannotate '
-.RB ` \-noformat '
-.RB ` \-inplace '
 .RB ` \-nomime '
 .RB ` \-noquery '
 .fi
@@ -457,24 +421,7 @@ 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
-.I whatnowproc
-is
-.BR whatnow ,
-then
-.B repl
-uses a built\-in
-.BR whatnow ,
-it does not actually run the
-.B whatnow
-program.
-Hence, if you define your own
-.IR whatnowproc ,
-don't call it
-.B whatnow
-since
-.B repl
-won't run it.
-.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.