Maybe ... it works? Sort of! Needs more testing, and for me to finish

[nmh] / man / repl.man

diff --git a/man/repl.man b/man/repl.man
index 04d89914277c935e9b2550bde70aef3d8d1b6656..4de6a70bcb824272431763cacdeda8244ee1b6da 100644 (file)
--- a/man/repl.man
+++ b/man/repl.man
@@ -1,4 +1,4 @@
-.TH REPL %manext1% "July 1, 2012" "%nmhversion%"
+.TH REPL %manext1% "December 14, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -9,8 +9,8 @@ repl \- reply to a message
 .na
 .B repl
 .RI [ +folder ]
-.RI [ msgs ]
-.RB [ \-annotate " | " \-noannotate ] 
+.RI [ msg ]
+.RB [ \-annotate " | " \-noannotate ]
 .RB [ \-group " | " \-nogroup ]
 .RB [ \-cc
 all/to/cc/me]
@@ -36,6 +36,8 @@ all/to/cc/me]
 .RB [ \-editor
 .IR editor ]
 .RB [ \-noedit ]
+.RB [ \-convertargs
+.IR "type argstring" ]
 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-nowhatnowproc ]
@@ -94,7 +96,7 @@ Subject: Re: <Subject>
 In\-Reply\-To: <Message\-Id>
 References: <Message\-Id>
 Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
-.ti +3 
+.ti +3
 message dated <date>
 --------
 .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
@@ -234,6 +236,25 @@ 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.
+.I %docdir%/contrib/replaliases
+shows the use of
+.BR "repl \-convertargs" .
+.PP
 Although
 .B repl
 uses a forms file to direct it how to construct
@@ -260,7 +281,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
@@ -350,16 +373,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
@@ -472,26 +486,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 <mh\-dir>/replcomps~^Rather than the standard template
-^%etcdir%/replgroupcomps~^The standard `reply -group' template
+^%nmhetcdir%/replgroupcomps~^The standard `reply -group' template
 ^or <mh\-dir>/replgroupcomps~^Rather than the standard template
-^%etcdir%/mhl.reply~^The standard message filter
+^%nmhetcdir%/mhl.reply~^The standard message filter
 ^or <mh\-dir>/mhl.reply~^Rather than the standard filter
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
@@ -518,6 +537,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"