From 9878bb1d6d6661c7278caa33013de1fdce91cc6d Mon Sep 17 00:00:00 2001
From: Rocco Rutte <pdmef@gmx.net>
Date: Wed, 27 May 2009 10:13:42 +0200
Subject: [PATCH] Document that -- is always mandatory after -a. Closes #3235.

---
 doc/manual.xml.head | 19 ++++++++++++-------
 doc/mutt.man        | 11 +++++------
 2 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 27b382ef5..c207498f3 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -7582,15 +7582,13 @@ To compose a new message
 <arg choice="opt"><option>-s</option>
 <replaceable>subject</replaceable>
 </arg>
-<arg choice="opt" rep="repeat">
+<arg choice="opt">
 <option>-a</option>
 <replaceable>file</replaceable>
+<arg choice="opt" rep="repeat"/>
+--
 </arg>
-<arg choice="opt">--</arg>
-<arg choice="plain">
-<replaceable>address</replaceable>
-</arg>
-<arg choice="opt" rep="repeat">
+<arg choice="plain" rep="repeat">
 <replaceable>address</replaceable>
 </arg>
 </cmdsynopsis>
@@ -7611,10 +7609,17 @@ of the file <quote>&tilde;/run2.dat</quote>.
 
 <para>
 All files passed with <literal>-a</literal> <emphasis>file</emphasis> will be attached as a MIME
-part to the message. To attach several files, use <quote>--</quote> to separate files and
+part to the message. To attach a single or several files, use <quote>--</quote> to separate files and
 recipient addresses:
 </para>
 
+<screen>
+mutt -a image.png -- some@one.org</screen>
+
+<para>
+or
+</para>
+
 <screen>
 mutt -a *.png -- some@one.org</screen>
 
diff --git a/doc/mutt.man b/doc/mutt.man
index 23ca76df1..e3b2bbec0 100644
--- a/doc/mutt.man
+++ b/doc/mutt.man
@@ -35,8 +35,7 @@ mutt \- The Mutt Mail User Agent
 [-s \fIsubj\fP]
 [-b \fIaddr\fP]
 [-c \fIaddr\fP]
-[\-a \fIfile\fP [...]]
-[\-\-]
+[\-a \fIfile\fP [...] \-\-]
 \fIaddr\fP [...]
 .PP
 .B mutt 
@@ -46,8 +45,7 @@ mutt \- The Mutt Mail User Agent
 [-s \fIsubj\fP]
 [-b \fIaddr\fP]
 [-c \fIaddr\fP]
-[\-a \fIfile\fP [...]]
-[\-\-]
+[\-a \fIfile\fP [...] \-\-]
 \fIaddr\fP [...]
 < message
 .PP
@@ -82,8 +80,9 @@ text, HTML, and/or PDF format.
 An expanded version of the given alias is passed to stdout.
 .IP "-a \fIfile\fP [...]"
 Attach a file to your message using MIME.
-To attach multiple files, separating filenames and recipient addresses with
-"\-\-" is mandatory, e.g. \fBmutt \-a img.jpg *.png \-\- addr1 addr2\fP.
+When attaching single or multiple files, separating filenames and recipient addresses with
+"\-\-" is mandatory, e.g. \fBmutt -a image.jpg \-\- addr1\fP or
+\fBmutt \-a img.jpg *.png \-\- addr1 addr2\fP.
 The \-a option must be placed at the end of command line options.
 .IP "-b \fIaddress\fP"
 Specify a blind-carbon-copy (BCC) recipient
-- 
2.40.0