.\"
.\" %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.
.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
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
+.BR 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.
.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 \-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
.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
.RB ` \-inplace '
.RB ` \-nomime '
.RB ` \-noquery '
+.RB ` \-atfile '
.RB ` "\-width\ 72" '
.fi