X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Frepl.man1;h=5643286b20f622b78f647982a28c0a846975d84c;hp=3f52d6c10e5f97330f064fa62cbdb2a1b586fb92;hb=dfa0332c4e6144699dedd5c9795219adc0f9c0d2;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9 diff --git a/man/repl.man1 b/man/repl.man1 index 3f52d6c..5643286 100644 --- a/man/repl.man1 +++ b/man/repl.man1 @@ -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: or or -cc: and and -Fcc: {fcc switch} or +outbox +Cc: and and +Fcc: +sent Subject: Re: In\-Reply\-To: References: @@ -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 is not available: .RS 5 .nf To: or or -cc: and and +Cc: and and Subject: Re: In\-Reply\-To: Message from of . .ti +\w'In\-Reply\-To: 'u @@ -144,7 +139,7 @@ In\-Reply\-To: Message from of . .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.