Add a batch composition flow section to the manual.

1 files changed, 100 insertions, 0 deletions

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index c424d536..4a587eec 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -7374,6 +7374,12 @@ macro index ,a "<save-message>=archive<enter><enter-command>ec
     </listitem>
     <listitem>
       <para>
+        <link linkend="send-multipart-alternative">$send_multipart_alternative</link>
+        generation.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
         Message encryption and signing.  Key selection.
       </para>
     </listitem>
@@ -7401,6 +7407,100 @@ macro index ,a "&lt;save-message&gt;=archive&lt;enter&gt;&lt;enter-command&gt;ec
   </itemizedlist>
 </sect1>
 
+<sect1 id="batch-compose-flow">
+  <title>Batch Composition Flow</title>
+
+  <para>
+    In batch mode, Mutt performs less steps than interactive mode.
+    Encryption and Signing are not supported.  Fcc'ing to an IMAP
+    mailbox is not supported.
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      <para>
+        <link linkend="my-hdr">my_hdr</link> processing for To, Cc,
+        Bcc headers.  (Subject is not processed.)
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        From header setting.  Note: this is so <link
+        linkend="send-hook">send-hook</link>s below can match ~P, but
+        From is re-set further below in case a send-hook changes the
+        value.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link linkend="send-hook">send-hook</link>
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        From header setting.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link linkend="my-hdr">my_hdr</link> processing for From,
+        Reply-To, Message-ID and user-defined headers.  The To, Cc,
+        Bcc, Subject, and Return-Path headers are ignored at this
+        stage.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        Message body is copied from stdin.  <link
+        linkend="signature">$signature</link> is not appended in batch
+        mode.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link linkend="send2-hook">send2-hook</link>
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link linkend="realname">$realname</link> part of From header setting.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link linkend="fcc-hook">fcc-hook</link>.  Fcc setting.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link linkend="send-multipart-alternative">$send_multipart_alternative</link>
+        generation.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        Fcc saving if <link
+        linkend="fcc-before-send">$fcc_before_send</link> is set.  (Note the
+        variable documentation for caveats of Fcc'ing before sending.)
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        Message sending.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        Fcc saving if <link
+        linkend="fcc-before-send">$fcc_before_send</link> is unset
+        (the default).  Note: prior to version 1.12, the Fcc was saved
+        before sending the message.  It is now by default saved
+        afterwards, but if the saving fails, the user is prompted.
+      </para>
+    </listitem>
+  </itemizedlist>
+</sect1>
+
 <sect1 id="muttlisp">
   <title>Using MuttLisp (EXPERIMENTAL)</title>
   <para>