X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..48fe8b4114532c04fc200d91fdc3f5315d47c97f:/man/repl.man?ds=sidebyside diff --git a/man/repl.man b/man/repl.man index 81e22b87..b764e673 100644 --- a/man/repl.man +++ b/man/repl.man @@ -1,4 +1,4 @@ -.TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +.TH REPL %manext1% "October 15, 2016" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,9 +8,11 @@ repl \- reply to a message .HP 5 .na .B repl +.RB [ \-help ] +.RB [ \-version ] .RI [ +folder ] -.RI [ msgs ] -.RB [ \-annotate " | " \-noannotate ] +.RI [ msg ] +.RB [ \-annotate " | " \-noannotate ] .RB [ \-group " | " \-nogroup ] .RB [ \-cc all/to/cc/me] @@ -36,6 +38,8 @@ all/to/cc/me] .RB [ \-editor .IR editor ] .RB [ \-noedit ] +.RB [ \-convertargs +.IR "type argstring" ] .RB [ \-whatnowproc .IR program ] .RB [ \-nowhatnowproc ] @@ -47,8 +51,6 @@ all/to/cc/me] .RB [ \-build ] .RB [ \-file .IR msgfile ] -.RB [ \-version ] -.RB [ \-help ] .ad .SH DESCRIPTION .B Repl @@ -94,7 +96,7 @@ Subject: Re: In\-Reply\-To: References: Comments: In\-Reply\-To or or -.ti +3 +.ti +3 message dated -------- .fi @@ -109,8 +111,8 @@ addresses to this default with the .B \-cc .I type switch. This switch takes an -argument ( -.IR all / to / cc / me ) +argument +.RI ( 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 different arguments) if you wish to add multiple types of addresses. @@ -119,7 +121,7 @@ If the switch .B \-group is given, then .B repl -will use the the +will use the standard forms file \*(lqreplgroupcomps\*(rq. 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 nmh directory, it @@ -217,7 +219,9 @@ for a description of the .B \-editor and .B \-noedit -switches. Note that while in the editor, the message being replied +switches. Note that while in the editor, with +.B \-atfile +and if the current directory is writable, 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 @@ -226,13 +230,33 @@ stored in the environment variable and the pathname of the folder containing the message is stored in the environment variable .BR $mhfolder . -The creation of the \*(lq@\*(rq file and associated environment variables -can be controlled via the +The creation of the \*(lq@\*(rq file is controlled via the .B \-atfile and .B \-noatfile options. .PP +The +.B \-convertargs +switch directs +.B repl +to pass the arguments for +.I type +to +.BR mhbuild . +Both arguments are required; +.I type +must be non-empty while +.I argstring +can be empty, e.g., '' in a shell command line. The +.B \-convertargs +switch can be used multiple times. +See the Convert Interface section of the +.B mhbuild +man page for description of the convert mechanism, and +.I %docdir%/contrib/replaliases +for examples of its use. +.PP Although .B repl uses a forms file to direct it how to construct @@ -259,7 +283,9 @@ which message filter file to use. .PP If the switch .B \-noformat -is given (it is the default), then the message +is given (it is the default) and the +.B \-filter +switch is not used, then the message to which you are replying is not included in the body of the draft. .PP If the switch @@ -349,16 +375,7 @@ Note that .B nmh will not invoke .B mhbuild -automatically, unless you -add this line to your -.I \&.mh\(ruprofile -file: -.PP -.RS 5 -automimeproc: 1 -.RE -.PP -Otherwise, you must specifically give the command +automatically; you must specifically give the command .PP .RS 5 What now? mime @@ -471,26 +488,31 @@ No mail is actually sent. The .B \-file .I msgfile -switch specifies the message to be replied to as an +switch specifies the message to be replied to as an exact filename rather than as an .B nmh -folder and message number. It is -intended to be used by the -.B msh -interface to -.BR nmh . +folder and message number. The same caveats apply to this option as to the .B \-build switch. .SH FILES +.B repl +looks for all format, filter and template files in multiple locations: +absolute pathnames are accessed directly, tilde expansion is done on +usernames, and files are searched for in the user's +.I Mail +directory as specified in their profile. If not found there, the directory +.RI \*(lq %nmhetcdir% \*(rq +is checked. +.PP .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^%etcdir%/replcomps~^The standard reply template +.ta \w'%nmhetcdir%/ExtraBigFileName 'u +^%nmhetcdir%/replcomps~^The standard reply template ^or /replcomps~^Rather than the standard template -^%etcdir%/replgroupcomps~^The standard `reply -group' template +^%nmhetcdir%/replgroupcomps~^The standard `reply -group' template ^or /replgroupcomps~^Rather than the standard template -^%etcdir%/mhl.reply~^The standard message filter +^%nmhetcdir%/mhl.reply~^The standard message filter ^or /mhl.reply~^Rather than the standard filter ^$HOME/\&.mh\(ruprofile~^The user profile ^/draft~^The draft file @@ -517,6 +539,8 @@ switch. .IR send (1), .IR whatnow (1), .IR mh\-format (5) +.PP +.I %docdir%/contrib/replaliases .SH DEFAULTS .nf .RB ` +folder "' defaults to the current folder" @@ -568,6 +592,3 @@ don't call it since .B repl won't run it. -.PP -If your current working directory is not writable, the link named -\*(lq@\*(rq is not available.