Removed the -noeditor switches and made them replaceable by `-editor ""'.
[mmh] / man / repl.man1
index 3f52d6c..6b7c485 100644 (file)
@@ -19,21 +19,14 @@ 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 ]
 .RB [ \-whatnowproc
 .IR program ]
-.RB [ \-nowhatnowproc ]
 .RB [ \-build ]
 .RB [ \-file
 .IR msgfile ]
@@ -78,8 +71,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 +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 \*(lqCc:\*(rq field is empty.  You may selectively add
 addresses to this default with the
 .B \-cc
 .I type
@@ -102,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
+\*(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 +128,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 +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 \*(lqCc:\*(rq contains all the addresses shown.  You may
 selectively remove addresses from this default with the
 .B \-nocc
 .I type
@@ -152,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 \*(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 +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 \*(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,22 +169,15 @@ 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)
 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
@@ -216,24 +202,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 +218,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 +255,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
+though.)
 .PP
-Otherwise, you must specifically give the command
-.PP
-.RS 5
-What now? mime
-.RE
-.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
@@ -380,14 +318,7 @@ will invoke the
 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
@@ -397,12 +328,14 @@ to
 and is only present if
 .B nmh
 was compiled with support
-for mh-e. It implies
-.BR \-nowhatnowproc .
+for mh-e.
 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 :
@@ -448,8 +381,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)
-^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 +394,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 +411,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.