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

2021-07-30 Thread Hannu Hartikainen
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.___
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-le...@notmuchmail.org


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

2021-06-25 Thread David Bremner
Hannu Hartikainen  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.
___
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-le...@notmuchmail.org


[PATCH] doc: tweak hook configuration documentation.

2021-06-22 Thread 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
___
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-le...@notmuchmail.org