+.TH DIST %manext1% "June 18, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
-.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
dist \- redistribute a message to additional addresses
.SH SYNOPSIS
.RI [ msg ]
.RB [ \-form
.IR formfile ]
-.RB [ \-annotate " | " \-noannotate ]
-.RB [ \-inplace " | " \-noinplace ]
+.RB [ \-annotate " | " \-noannotate ]
+.RB [ \-inplace " | " \-noinplace ]
.RB [ \-draftfolder
.IR +folder ]
.RB [ \-draftmessage
Forms are processed via the
.B nmh
template system; see
-.BR mh\-format (5)
+.IR mh\-format (5)
for details. Components from the redistributed message are available
as standard component escapes in the forms file.
.PP
In addition to the standard
-.BR mh\-format (5)
+.IR mh\-format (5)
escapes, the following
.I component
escapes are also supported:
.RE
.PP
See the
-.BR forw (1)
+.IR forw (1)
man page for descriptions of the
.BR \-from ,
.BR \-to ,
will be sent. Also, a
.RI \*(lq "Resent\-Fcc: folder" \*(rq
will be honored (see
-.BR send (1)).
+.IR send (1)).
Note that with
.BR dist ,
the draft should contain only
the original message are copied to the draft when the message is sent.
Use care in constructing the headers for the redistribution.
.PP
+Because the draft is minimal, the
+.IR prompter (1)
+editor is quite useful with
+.BR dist .
+.PP
If the
.B \-annotate
switch is given, the message being distributed will
be annotated with the lines:
-
- Resent:\ date
- Resent:\ addrs
-
+.RS
+Resent:\ date
+.br
+Resent:\ addrs
+.RE
where each address list contains as many lines as required. This
annotation will be done only if the message is sent directly from
.BR dist .
switch to change this.
.PP
See
-.BR comp (1)
+.IR comp (1)
for a description of the
.B \-editor
and
.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
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
program which starts the initial edit. Hence,
.B \-nowhatnowproc
will prevent any edit from occurring.)
-
.SH FILES
.fc ^ ~
.nf
^$HOME/\&.mh\(ruprofile~^The user profile
^<mh\-dir>/draft~^The draft file
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^fileproc:~^Program to refile the message
^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
.fi
-
.SH "SEE ALSO"
-comp(1), forw(1), repl(1), send(1), whatnow(1)
-
+.IR comp (1),
+.IR forw (1),
+.IR prompter (1),
+.IR repl (1),
+.IR send (1),
+.IR whatnow (1)
.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
.RB ` \-inplace '
.RB ` \-noatfile '
.fi
-
.SH CONTEXT
If a folder is given, it will become the current folder. The message
distributed will become the current message.
-
.SH HISTORY
.B Dist
originally used headers of the form
.RI \*(lq Distribute\-xxx: \*(rq
type headers and automatically convert them to
.RI \*(lq Resent\-xxx: \*(rq.
-
.SH BUGS
.B Dist
does not rigorously check the message being distributed