Removed the mhlproc profile entry. Call mhl directly.
[mmh] / man / repl.man1
index 3f52d6c..5643286 100644 (file)
@@ -19,15 +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 [ \-width
-.IR columns ]
 .RB [ \-editor
 .IR editor ]
 .RB [ \-noedit ]
@@ -78,8 +73,8 @@ to construct the reply message draft as follows:
 .RS 5
 .nf
 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
-cc: <To> and <cc> and <personal address>
-Fcc: {fcc switch} or +outbox
+Cc: <To> and <Cc> and <personal address>
+Fcc: +sent
 Subject: Re: <Subject>
 In\-Reply\-To: <Message\-Id>
 References: <Message\-Id>
@@ -94,7 +89,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 \*(lqCc:\*(rq field is empty.  You may selectively add
 addresses to this default with the
 .B \-cc
 .I type
@@ -102,7 +97,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
+\*(lqCc:\*(rq 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
@@ -135,7 +130,7 @@ or if the field <Mail\-Followup\-To> is not available:
 .RS 5
 .nf
 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
-cc: <To> and <cc> and <personal address>
+Cc: <To> and <Cc> and <personal address>
 Subject: Re: <Subject>
 In\-Reply\-To: Message from <From> of <Date>.
 .ti +\w'In\-Reply\-To: 'u
@@ -144,7 +139,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 \*(lqCc:\*(rq contains all the addresses shown.  You may
 selectively remove addresses from this default with the
 .B \-nocc
 .I type
@@ -152,7 +147,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 \*(lqCc:\*(rq list of the reply.  You may give this switch
 multiple times (with different arguments) if you wish to remove multiple types
 of addresses.
 .PP
@@ -167,7 +162,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 \*(lqTo:\*(rq and \*(lqCc:\*(rq list should actually be sent a copy.
 This is useful for special\-purpose replies.  Note that the position of
 the
 .B \-cc
@@ -176,14 +171,9 @@ 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
+Lines beginning with the fields \*(lqTo:\*(rq, \*(lqCc:\*(rq, and
 \*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
-In addition, the
-.B \-width
-.I columns
-switch will guide
-.BR repl 's
-formatting of these fields.
+In addition, these fields will be wrapped at a reasonable length.
 .PP
 See
 .BR comp (1)
@@ -216,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:
@@ -246,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
@@ -283,83 +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
-switch.
-This directs
-.B repl
-to generate an
-.B mhbuild
-composition file.
-Note that
-.B nmh
-will not invoke
-.B mhbuild
-automatically, unless you
-add this line to your profile:
-.PP
-.RS 5
-automimeproc: 1
-.RE
-.PP
-Otherwise, you must specifically give the command
-.PP
-.RS 5
-What now? mime
-.RE
+though.)
 .PP
-prior to sending the draft.
+To MIME-attach the original message, specify the
+.B \-mime
+switch.
+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 'outbox',
-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
@@ -449,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
 
@@ -463,11 +404,8 @@ 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 '
-.RB ` "\-width\ 72" '
 .fi
 
 .SH CONTEXT
@@ -483,30 +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
-The
-.B \-width
-.I columns
-switch is only used to do address-folding; other
-headers are not line\-wrapped.
-.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.