document support for mailto: URLs on the command line

closes #3400

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 301a93a12e91321b82a3b544b2d8943750b1c190..946a0043b92ec8e4005d6ad5a96ba85129eea854 100644 (file)
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -8242,9 +8242,14 @@ To compose a new message
 <arg choice="opt" rep="repeat"/>
 --
 </arg>
-<arg choice="plain" rep="repeat">
+<group choice="plain" rep="repeat">
+<arg choice="plain">
 <replaceable>address</replaceable>
 </arg>
+<arg choice="plain">
+<replaceable>mailto_url</replaceable>
+</arg>
+</group>
 </cmdsynopsis>
 
 <para>
@@ -8286,6 +8291,15 @@ The <literal>-a</literal> option must be last in the option list.
 </para>
 </note>
 
+<para>
+In addition to accepting a list of email addresses, Mutt also accepts a URL with
+the <literal>mailto:</literal> schema as specified in RFC2368.  This is useful
+when configuring a web browser to launch Mutt when clicking on mailto links.
+</para>
+
+<screen>
+mutt mailto:some@one.org&amp;subject=test</screen>
+
 </sect1>
 
 <sect1 id="commands">

diff --git a/doc/mutt.man b/doc/mutt.man
index 8765a8de9c2edf61e27cd621b31c1a3b646ee654..8a5113c6d9ef63c4d03c7868bad388c685ffa6eb 100644 (file)
--- a/doc/mutt.man
+++ b/doc/mutt.man
@@ -36,7 +36,7 @@ mutt \- The Mutt Mail User Agent
 [\-b \fIaddr\fP]
 [\-c \fIaddr\fP]
 [\-a \fIfile\fP [...] \-\-]
-\fIaddr\fP [...]
+\fIaddr|mailto_url\fP [...]
 .PP
 .B mutt 
 [\-nx] 
@@ -46,7 +46,7 @@ mutt \- The Mutt Mail User Agent
 [\-b \fIaddr\fP]
 [\-c \fIaddr\fP]
 [\-a \fIfile\fP [...] \-\-]
-\fIaddr\fP [...]
+\fIaddr|mailto_url\fP [...]
 < message
 .PP
 .B mutt