doc: use program and option directives to document options

[notmuch] / doc / man1 / notmuch-emacs-mua.rst

diff --git a/doc/man1/notmuch-emacs-mua.rst b/doc/man1/notmuch-emacs-mua.rst
index c0d5b1a7c4768d1c2bc301da57c0e5db773faaa0..d8af08bda47a530dac1827a28c55fa976fe96e0a 100644 (file)
--- a/doc/man1/notmuch-emacs-mua.rst
+++ b/doc/man1/notmuch-emacs-mua.rst
@@ -17,50 +17,64 @@ subject, recipients, and message body, or mailto: URL.
 
 Supported options for **emacs-mua** include
 
 
 Supported options for **emacs-mua** include
 

-``-h, --help``
-    Display help.
+.. program:: emacs-mua

 
 

-``-s, --subject=``\ <subject>
-    Specify the subject of the message.
+.. option:: -h, --help

 
 

-``--to=``\ <to-address>
-    Specify a recipient (To).
+   Display help.

 
 

-``-c, --cc=``\ <cc-address>
-    Specify a carbon-copy (Cc) recipient.
+.. option:: -s, --subject=<subject>

 
 

-``-b, --bcc=``\ <bcc-address>
-    Specify a blind-carbon-copy (Bcc) recipient.
+   Specify the subject of the message.

 
 

-``-i, --body=``\ <file>
-    Specify a file to include into the body of the message.
+.. option:: --to=<to-address>

 
 

-``--hello``
-    Go to the Notmuch hello screen instead of the message composition
-    window if no message composition parameters are given.
+   Specify a recipient (To).

 
 

-``--no-window-system``
-    Even if a window system is available, use the current terminal.
+.. option:: -c, --cc=<cc-address>

 
 

-``--client``
-    Use :manpage:`emacsclient(1)`, rather than
-    :manpage:`emacs(1)`. For :manpage:`emacsclient(1)` to work, you
-    need an already running Emacs with a server, or use
-    ``--auto-daemon``.
+   Specify a carbon-copy (Cc) recipient.

 
 

-``--auto-daemon``
-    Automatically start Emacs in daemon mode, if the Emacs server is
-    not running. Applicable with ``--client``. Implies
-    ``--create-frame``.
+.. option:: -b, --bcc=<bcc-address>

 
 

-``--create-frame``
-    Create a new frame instead of trying to use the current Emacs
-    frame. Applicable with ``--client``. This will be required when
-    Emacs is running (or automatically started with ``--auto-daemon``)
-    in daemon mode.
+   Specify a blind-carbon-copy (Bcc) recipient.

 
 

-``--print``
-    Output the resulting elisp to stdout instead of evaluating it.
+.. option:: -i, --body=<file>
+
+   Specify a file to include into the body of the message.
+
+.. option:: --hello
+
+   Go to the Notmuch hello screen instead of the message composition
+   window if no message composition parameters are given.
+
+.. option:: --no-window-system
+
+   Even if a window system is available, use the current terminal.
+
+.. option:: --client
+
+   Use :manpage:`emacsclient(1)`, rather than
+   :manpage:`emacs(1)`. For :manpage:`emacsclient(1)` to work, you
+   need an already running Emacs with a server, or use
+   ``--auto-daemon``.
+
+.. option:: --auto-daemon
+
+   Automatically start Emacs in daemon mode, if the Emacs server is
+   not running. Applicable with ``--client``. Implies
+   ``--create-frame``.
+
+.. option:: --create-frame
+
+   Create a new frame instead of trying to use the current Emacs
+   frame. Applicable with ``--client``. This will be required when
+   Emacs is running (or automatically started with ``--auto-daemon``)
+   in daemon mode.
+
+.. option:: --print
+
+   Output the resulting elisp to stdout instead of evaluating it.

 
 The supported positional parameters and short options are a compatible
 subset of the :manpage:`mutt(1)` MUA command-line options. The options
 
 The supported positional parameters and short options are a compatible
 subset of the :manpage:`mutt(1)` MUA command-line options. The options