[PATCH] doc: tweak hook configuration documentation.

[PATCH] doc: tweak hook configuration documentation.

[David Bremner]

Add a historical note, and hint to look below for more about hooks.
Capitalized the heading for consistency.
---
 doc/man1/notmuch-config.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/man1/notmuch-config.rst b/doc/man1/notmuch-config.rst
index 56f4a160..eb941dc8 100644
--- a/doc/man1/notmuch-config.rst
+++ b/doc/man1/notmuch-config.rst
@@ -85,6 +85,10 @@ paths are presumed relative to `$HOME` for items in section
     Directory containing hooks run by notmuch commands. See
     :any:`notmuch-hooks(5)`.
 
+    History: this configuration value was introduced in notmuch 0.32.
+
+    Default: See HOOKS, below.
+
 **user.name**
     Your full name.
 
@@ -261,7 +265,7 @@ Notmuch configuration file search order:
    by :envvar:`NOTMUCH_PROFILE` environment variable if set,
    ``$HOME/.notmuch-config`` otherwise.
 
-Hooks
+HOOKS
 -----
 
 Notmuch hook directory search order:
-- 
2.30.2

Re: [PATCH] doc: tweak hook configuration documentation.

[Hannu Hartikainen]

[-- Attachment #1: Type: text/plain, Size: 789 bytes --]


LGTM, but because there is an empty line after `**database.hook_dir**`
that section has different indentation than others in the generated
manpage. Might as well fix that too. See snippet below, from a rendered
manpage on my machine.

Hannu

---
       database.backup_dir
              Directory to store tag dumps when upgrading database.

              History: this configuration value was  introduced  in
              notmuch 0.32.

              Default:  A  sibling directory of the Xapian database
              called backups.

       database.hook_dir
          Directory containing hooks run by notmuch  commands.  See
          notmuch-hooks(5).

          History:  this configuration value was introduced in not???
          much 0.32.

          Default: See HOOKS, below.

[-- Attachment #2: Type: text/plain, Size: 0 bytes --]

Re: [PATCH] doc: tweak hook configuration documentation.

[David Bremner]

Hannu Hartikainen <hannu.hartikainen@gmail.com> writes:

> LGTM, but because there is an empty line after `**database.hook_dir**`
> that section has different indentation than others in the generated
> manpage. Might as well fix that too. See snippet below, from a rendered
> manpage on my machine.

Thanks for the suggestion. Done, applied to release and master.