Add a forwarding chapter to the manual. From Gero Treuner.

diff --git a/doc/manual.sgml.in b/doc/manual.sgml.in
index a6e6edffbc309e759222ca50d70a5436f7e0fb9c..0f18b6e9d8cfd779e61f955a2b723876db0ef0f4 100644 (file)
--- a/doc/manual.sgml.in
+++ b/doc/manual.sgml.in
@@ -419,11 +419,9 @@ ESC k   mail-key        mail a PGP public key to someone
 
 Bouncing a message sends the message as is to the recipient you
 specify.  Forwarding a message allows you to add comments or
-modify the message you are forwarding.  Bouncing a message uses
-the <ref id="sendmail" name="sendmail">
-command to send a copy of a message to recipients as if they were
-original recipients of the message.  See also <ref id="mime_forward"
-name="&dollar;mime&lowbar;forward">.
+modify the message you are forwarding.  These items are discussed
+in greater detail in the next chapter <ref id="forwarding_mail"
+name="``Forwarding Mail''">.
 
 Mutt will then enter the <em/compose/ menu and prompt you for the
 recipients to place on the ``To:'' header field.  Next, it will ask
@@ -507,6 +505,42 @@ id="pgp_sign_as" name="&dollar;pgp&lowbar;sign&lowbar;as"> permanently.
 
 Also see <ref id="edit_headers" name="edit&lowbar;headers">.
 
+<sect1>Forwarding and Bouncing Mail<label id="forwarding_mail">
+<p>
+
+Forwarding and bouncing let you send a message to more recipients
+you specify.  Bouncing a message uses the <ref id="sendmail"
+name="sendmail"> command to send a copy of a message to recipients
+as if they were original recipients of the message.  Forwarding a message
+on the other hand allows you to add comments or modify the message
+before it is resend.
+
+Following keys are bound by default:
+
+<tscreen><verb>
+f       forward         forward message
+b       bounce          bounce (remail) message
+</verb></tscreen>
+
+Forwarding can be done by including the message in the new message's body
+(surrounded by indicating lines) or including it as MIME attachment,
+which is controlled by the <ref id="mime_forward"
+name="&dollar;mime&lowbar;forward"> variable, and with or without decoding
+attachments like in the pager, controlled by the <ref id="forward_decode"
+name="&dollar;forward&lowbar;decode"> resp. <ref id="mime_forward_decode"
+name="&dollar;mime&lowbar;forward&lowbar;decode"> variables.
+The desired forwarding format may depend on the content, therefore
+<em/&dollar;mime&lowbar;forward/ is a quad option and can be set to
+``ask-no'' for example.
+
+Messages are always forwarded with full headers, except when
+&dollar;mime&lowbar;forward=no, &dollar;forward&lowbar;decode=yes and
+<ref id="forward_weed" name="&dollar;forward&lowbar;weed">=yes
+(which is the default).
+
+Editing the message to forward is the same procedure as in sending or
+replying to a message.
+
 <sect1>Postponing Mail<label id="postponing_mail">
 <p>