X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Frepl.man1;h=c1eb1d8938b77a8c773d8fa3e4291e5b9b258696;hp=05a973650b527cc29f473650f4ac0eab303d970b;hb=32b2354dbaf4bf934936eb5b102a4a3d2fdd209a;hpb=a156e770d2b1f11e794d7b5eae8db1c4856933d4 diff --git a/man/repl.man1 b/man/repl.man1 index 05a9736..c1eb1d8 100644 --- a/man/repl.man1 +++ b/man/repl.man1 @@ -19,22 +19,18 @@ all/to/cc/me] .RB [ \-query " | " \-noquery ] .RB [ \-form .IR formfile ] -.RB [ \-format " | " \-noformat ] .RB [ \-filter -.IR filterfile ] +.IR filterfile +.RB " | " \-nofilter ] .RB [ \-mime " | " \-nomime ] -.RB [ \-fcc -.IR +folder ] .RB [ \-editor .IR editor ] -.RB [ \-noedit ] .RB [ \-whatnowproc .IR program ] -.RB [ \-nowhatnowproc ] .RB [ \-build ] .RB [ \-file .IR msgfile ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] .ad .SH DESCRIPTION @@ -76,7 +72,7 @@ to construct the reply message draft as follows: .nf To: or or Cc: and and -Fcc: {fcc switch} or +sent +Fcc: +sent Subject: Re: In\-Reply\-To: References: @@ -181,9 +177,7 @@ 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 @@ -208,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: @@ -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 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 @@ -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 -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 @@ -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 -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 @@ -351,33 +318,21 @@ 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 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. -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 @@ -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) -^fileproc:~^Program to refile the message -^mhlproc:~^Program to filter message being replied\-to ^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 ` \-noformat ' .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 +The quotation of the original message does not get transfer-decoded, yet.