X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Frepl.man;h=04d89914277c935e9b2550bde70aef3d8d1b6656;hb=a8a488a128a8124503d01da632c7290f6abc0752;hp=9f2f4893b7a743c800fd6b7ab4747ff38a10c650;hpb=5dd6771b28c257af405d7248639ed0e3bcdce38b;p=mmh

diff --git a/man/repl.man b/man/repl.man
index 9f2f489..04d8991 100644
--- 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
@@ -303,6 +316,28 @@ 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
+You can also use an external format program to format the message body.
+The format program is specified by the
+.IR formatproc
+profile entry, and is enabled by the \*(lqformat\*(rq flag.  A message
+filter using an external format program would look like this:
+.PP
+.RS 5
+.nf
+body:component=\*(lq>\*(rq,\|nowrap,\|format
+.fi
+.RE
+.PP
+See the
+.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
 switch.
@@ -368,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
@@ -378,7 +413,7 @@ escape:
 .RS 5
 .nf
 .ta \w'Escape  'u +\w'Returns  'u
-.I Escape	Returns	Description
+.I "Escape	Returns	Description"
 fcc	string	Any folders specified with `\-fcc\ folder'
 .fi
 .RE
@@ -401,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
@@ -410,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
@@ -425,20 +460,14 @@ 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 nmh .
+It implies
 .BR \-nowhatnowproc .
 It causes a file
 .I <mh\-dir>/reply
 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 mail is actually sent.
 .PP
 The
 .B \-file
@@ -454,7 +483,6 @@ interface to
 The same caveats apply to this option as to the
 .B \-build
 switch.
-
 .SH FILES
 .fc ^ ~
 .nf
@@ -468,7 +496,6 @@ switch.
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -484,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"
@@ -500,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
@@ -540,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.