summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorKevin McCarthy <kevin@8t8.us>2021-04-09 17:51:12 -0700
committerKevin McCarthy <kevin@8t8.us>2021-04-09 17:51:12 -0700
commit6a2e3deaa1bdea2e0a9c6638db159ad00024f2d9 (patch)
tree084247fdaabdd407bac1ef1102651bdec803c27d /doc
parent6c510773f2ff04aed70426bb1339222f2b785c34 (diff)
Clarify -H usage in batch mode is not a "pass through" option.
Mutt runs the file through mutt_prepare_template() in both cases, which will decrypt, remove signatures, strip multipart/alternatives. The documentation wasn't clear about this, and it might be misunderstood that -H is a "pass through" option.
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.xml.head17
-rw-r--r--doc/mutt.man14
2 files changed, 20 insertions, 11 deletions
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 04588800..12eab654 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -11311,11 +11311,18 @@ aborted.
<para>
A draft file passed with <literal>-H</literal> will be used as the
initial header and body for the message. Multipart messages can be
-used as a draft file. When combined with <literal>-E</literal>, the
-draft file will be updated to the final state of the message after
-composition, regardless of whether the message is sent, aborted, or
-even postponed. Note that if the message is sent encrypted or signed,
-the draft file will be saved that way too.
+used as a draft file, and are processed the same in interactive and
+batch mode; they are not passed through untouched. For example,
+encrypted draft files will be decrypted. When combined with
+<literal>-E</literal>, the draft file will be updated to the final
+state of the message after composition, regardless of whether the
+message is sent, aborted, or even postponed. Note that if the message
+is sent encrypted or signed, the draft file will be saved that way
+too.
+</para>
+
+<para>
+
</para>
<para>
diff --git a/doc/mutt.man b/doc/mutt.man
index 42b3ac97..86c072d2 100644
--- a/doc/mutt.man
+++ b/doc/mutt.man
@@ -144,12 +144,14 @@ Use \fIrcfile\fP instead of the user configuration file.
Display a short option summary and exit.
.TP
.BI \-H " draft"
-Specify a \fIdraft\fP file which contains header and body to use to send a
-message.
-If \fIdraft\fP is \*(lq\fB\-\fP\*(rq, then data is read from stdin.
-The draft file is expected to contain just an RFC822 email \(em headers and a body.
-Although it is not an mbox file, if an mbox "\fBFrom\~\fP" line is present,
-it will be silently discarded.
+Specify a \fIdraft\fP file which contains header and body to use to
+send a message. If \fIdraft\fP is \*(lq\fB\-\fP\*(rq, then data is
+read from stdin. The draft file is expected to contain just an RFC822
+email \(em headers and a body. Although it is not an mbox file, if an
+mbox "\fBFrom\~\fP" line is present, it will be silently discarded.
+Draft files are processed the same in interactive and batch mode; they
+are not passed through untouched. For example, encrypted draft files
+will be decrypted.
.TP
.BI \-i " include"
Specify an \fIinclude\fP file to be inserted into the body of a message.