X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fdist.man;h=add2e8e094c7209bb72d71a5fc1f6a7e5566852b;hb=d00b170aa19a82a22bf55516f2cdb33e26deca0c;hp=ae7be11c0d3346715666fa2a2be9e628bbbcf301;hpb=5dd6771b28c257af405d7248639ed0e3bcdce38b;p=mmh

diff --git a/man/dist.man b/man/dist.man
index ae7be11..add2e8e 100644
--- a/man/dist.man
+++ b/man/dist.man
@@ -9,11 +9,11 @@ dist \- redistribute a message to additional addresses
 .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
@@ -22,9 +22,21 @@ dist \- redistribute a message to additional addresses
 .RB [ \-editor
 .IR editor ]
 .RB [ \-noedit ]
+.RB [ \-width
+.IR columns ]
+.RB [ \-from
+.IR address ]
+.RB [ \-to
+.IR address ]
+.RB [ \-cc
+.IR address ]
+.RB [ \-fcc
+.IR +folder ]
 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-nowhatnowproc ]
+.RB [ \-atfile ]
+.RB [ \-noatfile ]
 .RB [ \-version ]
 .RB [ \-help ]
 .ad
@@ -40,7 +52,10 @@ The default message form contains the following elements:
 .PP
 .RS 5
 .nf
-%distcomps%
+Resent-From: {from switch} or <Local-Mailbox> or <username@hostname>
+Resent-To: {to switch} or blank
+Resent-cc: {cc switch} or blank
+Resent-fcc: {fcc switch} or blank
 .fi
 .RE
 .PP
@@ -51,7 +66,39 @@ will be used instead of this default form.  You may specify an alternate
 forms file with the switch
 .B \-form
 .IR formfile .
-The form used will be prepended to the message being resent.
+Forms are processed via the
+.B nmh
+template system; see
+.BR 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)
+escapes, the following
+.I component
+escapes are also supported:
+.PP
+.RS 5
+.nf
+.ta \w'Escape	'u +\w'Returns	'u
+.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'
+nmh\-cc	string	Addresses specified with `\-cc\ address'
+.fi
+.RE
+.PP
+See the
+.BR forw (1)
+man page for descriptions of the
+.BR \-from ,
+.BR \-to ,
+.BR \-cc ,
+and
+.B \-fcc
+switches.
 .PP
 If the draft already exists,
 .B dist
@@ -82,6 +129,11 @@ fields and no body.  The headers and the body of
 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
+.BR prompter (1)
+editor is quite useful with
+.BR dist .
+.PP
 If the
 .B \-annotate
 switch is given, the  message being distributed will
@@ -119,6 +171,12 @@ stored in the environment variable
 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
@@ -172,7 +230,7 @@ will prevent any edit from occurring.)
 .fi
 
 .SH "SEE ALSO"
-comp(1), forw(1), repl(1), send(1), whatnow(1)
+comp(1), forw(1), prompter(1), repl(1), send(1), whatnow(1)
 
 .SH DEFAULTS
 .nf
@@ -181,6 +239,7 @@ comp(1), forw(1), repl(1), send(1), whatnow(1)
 .RB ` \-noannotate '
 .RB ` \-nodraftfolder '
 .RB ` \-inplace '
+.RB ` \-noatfile '
 .fi
 
 .SH CONTEXT