X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fforw.man;h=d4edc2f4f1ccad621915c3744a8f9ccf68c7ff49;hb=9ac724c1df34e9dd56e2e35566b0cf81a491e8e6;hp=877b49bbaa098962d4bbfb94fb0abbdab06cec73;hpb=5dd6771b28c257af405d7248639ed0e3bcdce38b;p=mmh

diff --git a/man/forw.man b/man/forw.man
index 877b49b..d4edc2f 100644
--- a/man/forw.man
+++ b/man/forw.man
@@ -26,6 +26,18 @@ forw \- forward messages
 .RB [ \-editor
 .IR editor ]
 .RB [ \-noedit ]
+.RB [ \-width
+.IR colums ]
+.RB [ \-from
+.IR address ]
+.RB [ \-to
+.IR address ]
+.RB [ \-cc
+.IR address ]
+.RB [ \-fcc
+.IR +folder ]
+.RB [ \-subject
+.IR text ]
 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-nowhatnowproc ]
@@ -62,11 +74,17 @@ as in
 and after editing is complete, the user is prompted
 before the message is sent.
 .PP
-The default message form contains the following elements:
+The default message template will direct
+.B forw
+to construct the draft as follows:
 .PP
 .RS 5
 .nf
-%forwcomps%
+From: {from switch} or <Local-Mailbox> or <username@hostname>
+To: {to switch} or blank
+Fcc: {fcc switch} or +outbox
+Subject: {subject switch} or "{original subject} (fwd)"
+--------
 .fi
 .RE
 .PP
@@ -77,6 +95,30 @@ it will be used instead of this default form.  You may also specify an
 alternate forms file with the switch
 .B \-form
 .IR formfile .
+Forms are processed via the
+.B nmh
+template system; see
+.BR mh\-format (5)
+for details.  Components from the first forwarded 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'nmh\-subject	'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'
+nmh\-subject	string	Any text specified with `\-subject\ text'
+.fi
+.RE
 .PP
 If the draft already exists,
 .B forw
@@ -265,18 +307,13 @@ will prevent any edit from occurring.)
 The
 .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 <mh\-dir>/draft
 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