+.TH REPL %manext1% "July 1, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
repl \- reply to a message
.SH SYNOPSIS
.HP 5
+.na
.B repl
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-whatnowproc
.IR program ]
.RB [ \-nowhatnowproc ]
+.RB [ \-atfile ]
+.RB [ \-noatfile ]
+.RB [ \-fmtproc
+.IR program ]
+.RB [ \-nofmtproc ]
.RB [ \-build ]
.RB [ \-file
.IR msgfile ]
.RB [ \-version ]
.RB [ \-help ]
+.ad
.SH DESCRIPTION
.B Repl
may be used to produce a reply to an existing message.
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
.nf
To: <Mail\-Reply\-To> or <Reply\-To> or <From>
cc: <To> and <cc> and <personal address>
+Fcc: {fcc switch} or +outbox
Subject: Re: <Subject>
-In\-Reply\-To: Your message of <Date>.
-.ti +\w'In\-Reply\-To: 'u
-<Message\-Id>
+In\-Reply\-To: <Message\-Id>
+References: <Message\-Id>
+Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
+.ti +3
+message dated <date>
--------
.fi
.RE
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
will display the draft.
.PP
See
-.BR comp (1)
+.IR comp (1)
for a description of the
.B \-editor
and
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
+.B \-atfile
+and
+.B \-noatfile
+options.
.PP
Although
.B repl
.nf
message-id:nocomponent,\|nonewline,\\
formatfield=\*(lqIn message %{text},\ \*(rq
-from:nocomponent,\|formatfield=\*(lq%(friendly{text}) writes:\*(rq
+from:nocomponent,\|formatfield=\*(lq%(decode(friendly{text})) writes:\*(rq
body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
.fi
.RE
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.
.B \-noinplace
switch to change this.
.PP
-The
+Although the default template specifies that a copy of the reply will be
+put in
+the folder 'outbox',
+if the
.B \-fcc
.I +folder
-switch can be used to automatically specify a folder
-to receive Fcc:s. More than one folder, each preceded by
+switch is given it will override the default value.
+More than one folder, each preceded by
.B \-fcc
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
.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
.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
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
.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
The same caveats apply to this option as to the
.B \-build
switch.
-
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
+.ta \w'%etcdir%/ExtraBigFileName 'u
^%etcdir%/replcomps~^The standard reply template
^or <mh\-dir>/replcomps~^Rather than the standard template
^%etcdir%/replgroupcomps~^The standard `reply -group' template
^$HOME/\&.mh\(ruprofile~^The user profile
^<mh\-dir>/draft~^The draft file
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^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"
.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