-.\"
+.TH RCVDIST %manext1% 1999-04-30 "%nmhversion%"
+.
.\" %nmhwarning%
-.\" $Id$
-.\"
-.TH RCVDIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.
.SH NAME
-rcvdist \- asynchronously redistribute new mail
+rcvdist \- asynchronously receive and distribute new email
.SH SYNOPSIS
.HP 5
.na
-.B %libdir%/rcvdist
+.B %nmhlibexecdir%/rcvdist
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-form
.IR formfile ]
[switches\ for
.IR postproc ]
.I address1
\&...
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
-The
.B rcvdist
-program will accept a message on its standard input
-and resend a copy of this message to all of the addresses listed on its
-command line.
+accepts a message on its standard input and resends a copy of
+the message to all of the addresses listed on its command line.
.PP
-When a message is redistributed with the
-.B rcvdist
-command, the
-format of the Resent-xxx header fields is controlled by the forms files
+The format of the Resent-xxx header fields is specified by the form file
.RI \*(lq rcvdistcomps \*(rq.
If a file named
.RI \*(lq rcvdistcomps \*(rq
-exists in the user's nmh
-directory, it will be used instead of the default one. You may specify
-an alternate forms file with the switch
+exists in the user's nmh directory, it will be used instead of the
+default file.
+You may specify an alternate forms file with
.B \-form
.IR formfile .
.PP
The
.RI \*(lq rcvdistcomps \*(rq
file uses the format string facility described in
-.BR mh\-format (5).
+.IR mh\-format (5).
In addition to the standard format escapes,
.B rcvdist
-also recognizes the following additional
+also recognizes the following
.I component
escape:
.PP
.RS 5
.nf
.ta \w'Dtimenow 'u +\w'Returns 'u
-.I Escape Returns Description
+.I "Escape Returns Description"
addresses string the addresses to distribute to
.fi
.RE
.PP
By default,
.B rcvdist
-uses the program
+uses the
.B post
-to do the actual
-delivery of the message, although this can be changed by defining the
+program to deliver the message, although this can be changed by
+defining the
.I postproc
profile component.
-
.SH FILES
.fc ^ ~
.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^%etcdir%/rcvdistcomps~^Default message skeleton
-^or <mh\-dir>/rcvdistcomps~^Rather than standard message skeleton
-^%etcdir%/mts.conf~^nmh mts configuration file
-^$HOME/\&.maildelivery~^The file controlling local delivery
-^%etcdir%/maildelivery~^Rather than the standard file
+.ta \w'%nmhetcdir%/ExtraBigFileName 'u
+^%nmhetcdir%/rcvdistcomps~^Default message skeleton
+^or <mh-dir>/rcvdistcomps~^User's message skeleton
+^%nmhetcdir%/mts.conf~^nmh mts configuration file
+^%nmhetcdir%/maildelivery~^Default delivery file
+^$HOME/.maildelivery~^User's delivery file
.fi
-
.SH "SEE ALSO"
-rcvpack(1), rcvstore(1), rcvtty(1), mh\-format(5), slocal(1)
-
-.SH BUGS
-Only two return codes are meaningful, others should be.
+.IR rcvpack (1),
+.IR rcvstore (1),
+.IR rcvtty (1),
+.IR slocal (1),
+.IR mh\-format (5)