Renamed -version switch to -Version to remove the conflict with -verbose.

[mmh] / man / repl.man1

diff --git a/man/repl.man1 b/man/repl.man1
index 05a9736..c1eb1d8 100644 (file)
--- a/man/repl.man1
+++ b/man/repl.man1
@@ -19,22 +19,18 @@ all/to/cc/me]
 .RB [ \-query " | " \-noquery ]
 .RB [ \-form
 .IR formfile ]
 .RB [ \-query " | " \-noquery ]
 .RB [ \-form
 .IR formfile ]

-.RB [ \-format " | " \-noformat ]

 .RB [ \-filter
 .RB [ \-filter

-.IR filterfile ]
+.IR filterfile
+.RB " | " \-nofilter ]

 .RB [ \-mime " | " \-nomime ]
 .RB [ \-mime " | " \-nomime ]

-.RB [ \-fcc
-.IR +folder ]

 .RB [ \-editor
 .IR editor ]
 .RB [ \-editor
 .IR editor ]

-.RB [ \-noedit ]

 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-whatnowproc
 .IR program ]

-.RB [ \-nowhatnowproc ]

 .RB [ \-build ]
 .RB [ \-file
 .IR msgfile ]
 .RB [ \-build ]
 .RB [ \-file
 .IR msgfile ]

-.RB [ \-version ]
+.RB [ \-Version ]

 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION

@@ -76,7 +72,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>
 .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>
 Subject: Re: <Subject>
 In\-Reply\-To: <Message\-Id>
 References: <Message\-Id>

@@ -181,9 +177,7 @@ See
 .BR comp (1)
 for a description of the
 .B \-editor
 .BR comp (1)
 for a description of the
 .B \-editor

-and
-.B \-noedit
-switches.  Note that while in the editor, the message being replied
+switch.  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
 to is available through a link named \*(lq@\*(rq (assuming the default
 .IR whatnowproc ).
 In addition, the actual pathname of the message is

@@ -208,24 +202,10 @@ will invoke
 .B mhl
 to format the message to which you are replying.
 .PP
 .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:
 This default filter
 .RI \*(lq mhl.reply \*(rq
 is:

@@ -238,14 +218,14 @@ is:
 .PP
 which outputs each line of the body of the message prefaced with the
 \*(lq>\*(rq character and a space.
 .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,
 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
 .B \-filter
 .IR filterfile .
 .PP

@@ -275,14 +255,25 @@ 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
 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.
 .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
 .PP
 If the
 .B \-annotate

@@ -304,33 +295,9 @@ 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.
 .PP
 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
 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
 .PP
 To avoid reiteration,
 .B repl

@@ -351,33 +318,21 @@ will invoke the
 program.  See
 .BR whatnow (1)
 for a discussion of available
 program.  See
 .BR whatnow (1)
 for a discussion of available

-options.  The invocation of this program can be inhibited by using the
-.B \-nowhatnowproc
-switch.  (In truth of fact, it is the
-.B whatnow
-program which starts the initial edit.  Hence,
-.B \-nowhatnowproc
-will
-prevent any edit from occurring.)
+options.

 .PP
 The
 .B \-build
 switch is intended to be used by the Emacs mh-e interface
 to
 .PP
 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. It implies
-.BR \-nowhatnowproc .
+.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.
 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 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.
+No
+.B whatnow
+programm is invoked.
+No mail is actually sent.

 .PP
 The
 .B \-file
 .PP
 The
 .B \-file

@@ -419,8 +374,6 @@ 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)
 ^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)

-^fileproc:~^Program to refile the message
-^mhlproc:~^Program to filter message being replied\-to

 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
 
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
 

@@ -434,7 +387,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 ` \-nogroup '
 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
 .RB ` \-noannotate '

-.RB ` \-noformat '

 .RB ` \-nomime '
 .RB ` \-noquery '
 .fi
 .RB ` \-nomime '
 .RB ` \-noquery '
 .fi

@@ -454,3 +406,5 @@ 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
 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.