X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Frepl.man1;h=7cc41106a055af2e47a6ccc9fe71e0a59a2461a6;hp=5643286b20f622b78f647982a28c0a846975d84c;hb=18591f8e001ecedbee48a51c1d1f08ebaa1c15c8;hpb=dfa0332c4e6144699dedd5c9795219adc0f9c0d2 diff --git a/man/repl.man1 b/man/repl.man1 index 5643286..7cc4110 100644 --- a/man/repl.man1 +++ b/man/repl.man1 @@ -25,14 +25,12 @@ all/to/cc/me] .RB [ \-mime " | " \-nomime ] .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 @@ -58,15 +56,15 @@ If the switch .B \-nogroup is given (it is on by default), then .B repl -will use the standard forms file \*(lqreplcomps\*(rq. This will construct +will use the standard forms file `replcomps'. This will construct a draft message that is intended to be sent only to the author of the -message to which you are replying. If a file named \*(lqreplcomps\*(rq +message to which you are replying. If a file named `replcomps' exists in the user's .B mmh directory, it will be used instead of this default forms file. .PP -The default reply template \*(lqreplcomps\*(rq will direct +The default reply template `replcomps' will direct .B repl to construct the reply message draft as follows: .PP @@ -89,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 `Cc:' field is empty. You may selectively add addresses to this default with the .B \-cc .I type @@ -97,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 +`Cc:' 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 @@ -105,12 +103,12 @@ If the switch is given, then .B repl will use the the -standard forms file \*(lqreplgroupcomps\*(rq. This will construct a +standard forms file `replgroupcomps'. This will construct a draft message that is intended as a group or followup reply. If a file -named \*(lqreplgroupcomps\*(rq exists in the user's mmh directory, it +named `replgroupcomps' exists in the user's mmh directory, it will be used instead of this default forms file. .PP -The default group reply template \*(lqreplgroupcomps\*(rq will direct +The default group reply template `replgroupcomps' will direct .B repl to construct the reply message draft as follows: .PP @@ -139,7 +137,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 `Cc:' contains all the addresses shown. You may selectively remove addresses from this default with the .B \-nocc .I type @@ -147,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 `Cc:' list of the reply. You may give this switch multiple times (with different arguments) if you wish to remove multiple types of addresses. .PP @@ -162,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 `To:' and `Cc:' list should actually be sent a copy. This is useful for special\-purpose replies. Note that the position of the .B \-cc @@ -171,22 +169,18 @@ 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 -\*(rqBcc:\*(rq will be standardized and have duplicate addresses removed. +Lines beginning with the fields `To:', `Cc:', and +`Bcc:' will be standardized and have duplicate addresses removed. 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 -to is available through a link named \*(lq@\*(rq (assuming the default -.IR whatnowproc ). -In addition, the actual pathname of the message is +switch. Note that while in the editor, +the actual pathname of the message being replied to is stored in the environment variable -.BR $editalt , +.BR $mhaltmsg , and the pathname of the folder containing the message is stored in the environment variable .BR $mhfolder . @@ -211,7 +205,7 @@ 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 +.RI ` mhl.reply ' is: .PP .RS 5 @@ -221,9 +215,9 @@ is: .RE .PP which outputs each line of the body of the message prefaced with the -\*(lq>\*(rq character and a space. +`>' character and a space. If a file named -.RI \*(lq mhl.reply \*(rq +.RI ` mhl.reply ' exists in the user's .B mmh directory, @@ -249,20 +243,20 @@ is: .RS 5 .nf message-id:nocomponent,\|nonewline,\\ -formatfield=\*(lqIn message %{text},\ \*(rq -from:nocomponent,\|formatfield=\*(lq%(decode(friendly{text})) writes:\*(rq -body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0 +formatfield=`In message %{text},\ ' +from:nocomponent,\|formatfield=`%(decode(friendly{text})) writes:' +body:component=`>',\|overflowtext=`>',\|overflowoffset=0 .fi .RE .PP 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. +the `>' character. .PP If the switch .B \-nofilter is given, then the message -to which you are replying will not be formated and thus not included in +to which you are replying will not be formatted and thus not included in the body of the draft. (It may be added as MIME attachment with .B \-mime @@ -294,7 +288,7 @@ 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 +.RB ` "comp\ \-use" ' 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. @@ -322,40 +316,28 @@ 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 +program is invoked. +No mail is actually sent. .PP The .B \-file .I msgfile switch specifies the message to be replied to as an exact filename rather than as an -.B nmh +.B mh folder and message number. It is intended to be used by the .B msh @@ -371,7 +353,7 @@ switch. .ta \w'%etcdir%/ExtraBigFileName 'u ^%etcdir%/replcomps~^The standard reply template ^or $HOME/.mmh/replcomps~^Rather than the standard template -^%etcdir%/replgroupcomps~^The standard `reply -group' template +^%etcdir%/replgroupcomps~^The standard `reply \-group' template ^or $HOME/.mmh/replgroupcomps~^Rather than the standard template ^%etcdir%/mhl.reply~^The standard message filter ^or $HOME/.mmh/mhl.reply~^Rather than the standard filter @@ -390,8 +372,7 @@ 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 -^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions +^whatnowproc:~^Program to ask the `What now?' questions .fi .SH "SEE ALSO" @@ -400,7 +381,7 @@ mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5) .SH DEFAULTS .nf .RB ` +folder "' defaults to the current folder" -.RB ` msg "' defaults to cur" +.RB ` msg "' defaults to the current message" .RB ` \-nogroup ' .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'" .RB ` \-noannotate ' @@ -421,7 +402,4 @@ 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 -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.