CLI: document handling of --config for external commands

Create a section of the notmuch(1) manpage to have some place to put
this documentation.

diff --git a/doc/man1/notmuch.rst b/doc/man1/notmuch.rst
index c6ee30366264016846701ee4b3c4a9d4df343877..e0892e01667be75a8ae66ab3a89ad737ad9f12e8 100644 (file)
--- a/doc/man1/notmuch.rst
+++ b/doc/man1/notmuch.rst
@@ -185,6 +185,14 @@ of notmuch.
    If set to a non-empty value, the notmuch library will print (to
    stderr) Xapian queries it constructs.
 
+EXTERNAL COMMANDS
+=================
+
+When given a subcommand `foo` not recognized as built-in, notmuch will
+try to run the command (e.g. script) `notmuch-foo` in the user's
+path. The :envvar:`NOTMUCH_CONFIG` will be set according to
+:option:`--config`, if the latter is present.
+
 SEE ALSO
 ========