+.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
.na
.B dist
.RI [ +folder ]
-.RI [ msgs ]
+.RI [ msg ]
.RB [ \-form
.IR formfile ]
-.RB [ \-annotate " | " \-noannotate ]
-.RB [ \-inplace " | " \-noinplace ]
+.RB [ \-annotate " | " \-noannotate ]
+.RB [ \-inplace " | " \-noinplace ]
.RB [ \-draftfolder
.IR +folder ]
.RB [ \-draftmessage
.RB [ \-whatnowproc
.IR program ]
.RB [ \-nowhatnowproc ]
+.RB [ \-atfile ]
+.RB [ \-noatfile ]
.RB [ \-version ]
.RB [ \-help ]
.ad
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:
.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'
nmh\-from string Addresses specified with `\-from\ address'
nmh\-to string Addresses specified with `\-to\ address'
.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
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
The
.B \-draftfolder
.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 ` \-noannotate '
.RB ` \-nodraftfolder '
.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