From 999706c4d506f77fcef2a3d5d1c6bfe65c8db791 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Sun, 6 Feb 2022 10:02:37 -0400 Subject: [PATCH] doc: use hyperlinks for config options in notmuch-insert(1) The tradeoff is no bold/italic in the man pages to get actual hyperlinks in the html output. --- doc/man1/notmuch-config.rst | 2 ++ doc/man1/notmuch-insert.rst | 6 +++--- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/doc/man1/notmuch-config.rst b/doc/man1/notmuch-config.rst index 84a9e023..acc5ecec 100644 --- a/doc/man1/notmuch-config.rst +++ b/doc/man1/notmuch-config.rst @@ -85,6 +85,8 @@ database.hook_dir Default: See HOOKS, below. +.. _database.mail_root: + database.mail_root The top-level directory where your mail currently exists and to where mail will be delivered in the future. Files should be diff --git a/doc/man1/notmuch-insert.rst b/doc/man1/notmuch-insert.rst index 8d91d62a..fe2bf26b 100644 --- a/doc/man1/notmuch-insert.rst +++ b/doc/man1/notmuch-insert.rst @@ -14,12 +14,12 @@ DESCRIPTION **notmuch insert** reads a message from standard input and delivers it into the maildir directory given by configuration option -**database.mail_root**, then incorporates the message into the notmuch +:ref:`database.mail_root `, then incorporates the message into the notmuch database. It is an alternative to using a separate tool to deliver the message then running :any:`notmuch-new(1)` afterwards. The new message will be tagged with the tags specified by the -**new.tags** configuration option, then by operations specified on the +:ref:`new.tags ` configuration option, then by operations specified on the command-line: tags prefixed by '+' are added while those prefixed by '-' are removed. @@ -86,7 +86,7 @@ Supported options for **insert** include ``--decrypt=nostash`` without considering the security of your index. - See also ``index.decrypt`` in :any:`notmuch-config(1)`. + See also :ref:`index.decrypt ` in :any:`notmuch-config(1)`. CONFIGURATION =============