From: inwit <inwit@sindominio.net>
To: notmuch@notmuchmail.org
Subject: [PATCH v2 2/3] doc: document --profile option
Date: Sun, 30 Aug 2026 17:44:26 +0200
Message-ID: <20260830155628.221888-4-inwit@sindominio.net>
In-Reply-To: <20260830155628.221888-2-inwit@sindominio.net>
References: <20260830155628.221888-2-inwit@sindominio.net>
MIME-Version: 1.0
Message-ID-Hash: QNPLX4ZRTFF3RGVJVY7HAJPOVIJYPHEM
CC: inwit <inwit@sindominio.net>
Precedence: list
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit

Document the new --profile=PROFILE global option in the notmuch(1)
man page, and update the note about options that must appear before
the subcommand name.

Signed-off-by: inwit <inwit@sindominio.net>
---
 doc/man1/notmuch.rst | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/doc/man1/notmuch.rst b/doc/man1/notmuch.rst
index c488f12a..376f60b2 100644
--- a/doc/man1/notmuch.rst
+++ b/doc/man1/notmuch.rst
@@ -61,6 +61,13 @@ Supported global options for ``notmuch`` include
    string is a permitted and sometimes useful value of *FILE*, which
    tells ``notmuch`` to use only configuration metadata from the database.
 
+.. option:: --profile=PROFILE
+
+   Select among notmuch configurations. This overrides
+   :envvar:`NOTMUCH_PROFILE` for selecting which profile's configuration
+   to use. See :any:`notmuch-config(1)` for details on the profile
+   search order.
+
 .. option:: --uuid=HEX
 
    Enforce that the database UUID (a unique identifier which persists
@@ -69,9 +76,9 @@ Supported global options for ``notmuch`` include
    counts on messages. You can find this UUID using e.g. ``notmuch
    count --lastmod``
 
-All global options except ``--config`` can also be specified after the
-command. For example, ``notmuch subcommand --uuid=HEX`` is equivalent
-to ``notmuch --uuid=HEX subcommand``.
+All global options except ``--config`` and ``--profile`` can also be
+specified after the command. For example, ``notmuch subcommand
+--uuid=HEX`` is equivalent to ``notmuch --uuid=HEX subcommand``.
 
 COMMANDS
 ========
-- 
2.53.0

_______________________________________________
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-leave@notmuchmail.org