Note in dist, mh-profile, and repl man pages that the @ link

[mmh] / man / repl.man

diff --git a/man/repl.man b/man/repl.man
index 4c04887..04d8991 100644 (file)
--- a/man/repl.man
+++ b/man/repl.man
@@ -1,7 +1,7 @@
+.TH REPL %manext1% "July 1, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
-.TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 repl \- reply to a message
 .SH SYNOPSIS
@@ -39,6 +39,11 @@ all/to/cc/me]
 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-nowhatnowproc ]
+.RB [ \-atfile ]
+.RB [ \-noatfile ]
+.RB [ \-fmtproc
+.IR program ]
+.RB [ \-nofmtproc ]
 .RB [ \-build ]
 .RB [ \-file
 .IR msgfile ]
@@ -61,7 +66,7 @@ uses
 a reply template to guide its actions.  A reply template is simply a
 .B mhl
 format file (see
-.BR mh\-format (5)
+.IR mh\-format (5)
 for details).
 .PP
 If the switch
@@ -118,7 +123,8 @@ will use the 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
-will be used instead of this default forms file.
+will be used instead of this default forms file, unless you specify
+another forms file on the command line or in your profile.
 .PP
 The default group reply template \*(lqreplgroupcomps\*(rq will direct
 .B repl
@@ -206,12 +212,14 @@ skeleton; and
 will display the draft.
 .PP
 See
-.BR comp (1)
+.IR comp (1)
 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
@@ -220,6 +228,11 @@ 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 is controlled via the
+.B \-atfile
+and
+.B \-noatfile
+options.
 .PP
 Although
 .B repl
@@ -316,8 +329,14 @@ body:component=\*(lq>\*(rq,\|nowrap,\|format
 .RE
 .PP
 See the
-.BR mhl(1)
-documentation for more information.
+.IR mhl(1)
+documentation for more information.  The format program can be changed by
+the
+.B \-fmtproc
+.I program
+and
+.B \-nofmtproc
+switches.
 .PP
 To use the MIME rules for encapsulation, specify the
 .B \-mime
@@ -384,7 +403,7 @@ can
 be named.
 .PP
 In addition to the standard
-.BR mh\-format (5)
+.IR mh\-format (5)
 escapes,
 .B repl
 also recognizes the following additional
@@ -417,7 +436,7 @@ the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the
-.BR mh-draft (5)
+.IR mh-draft (5)
 man page for more
 information.
 .PP
@@ -426,7 +445,7 @@ Upon exiting from the editor,
 will invoke the
 .B whatnow
 program.  See
-.BR whatnow (1)
+.IR whatnow (1)
 for a discussion of available
 options.  The invocation of this program can be inhibited by using the
 .B \-nowhatnowproc
@@ -464,7 +483,6 @@ interface to
 The same caveats apply to this option as to the
 .B \-build
 switch.
-
 .SH FILES
 .fc ^ ~
 .nf
@@ -478,7 +496,6 @@ switch.
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -494,10 +511,13 @@ switch.
 ^mhlproc:~^Program to filter message being replied\-to
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
-
 .SH "SEE ALSO"
-mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
-
+.IR comp (1),
+.IR forw (1),
+.IR mhbuild (1),
+.IR send (1),
+.IR whatnow (1),
+.IR mh\-format (5)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
@@ -510,13 +530,12 @@ mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
 .RB ` \-inplace '
 .RB ` \-nomime '
 .RB ` \-noquery '
+.RB ` \-noatfile '
 .RB ` "\-width\ 72" '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The message
 replied\-to will become the current message.
-
 .SH BUGS
 If any addresses occur in the reply template, addresses in the template
 that do not contain hosts are defaulted incorrectly.  Instead of using
@@ -550,6 +569,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.