X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-1.mdwn;h=d9629249fdcb064732fd35ba284ccd6911110940;hb=7ab49d222b1bafd16ce17aa2a8f21648fb3ac8fd;hp=6fe3db346985ad57c10fa0aff2574fbd405eb488;hpb=972d44d9cb20af9363eb251fc6e748912ad0ca32;p=notmuch-wiki diff --git a/manpages/notmuch-1.mdwn b/manpages/notmuch-1.mdwn index 6fe3db3..d962924 100644 --- a/manpages/notmuch-1.mdwn +++ b/manpages/notmuch-1.mdwn @@ -31,8 +31,8 @@ it does not provide the most convenient interface for that functionalâ ity. More sophisticated interfaces are expected to be built on top of either the command-line interface, or more likely, on top of the notâ - much library interface. See https://notmuchmail.org for more about - alternate interfaces to notmuch. The emacs-based interface to notmuch + much library interface. See https://notmuchmail.org for more about alâ + ternate interfaces to notmuch. The emacs-based interface to notmuch (available under emacs/ in the Notmuch source distribution) is probably the most widely used at this time. @@ -41,23 +41,25 @@
Supported global options for notmuch include - --help [command-name] - Print a synopsis of available commands and exit. With an - optional command name, show the man page for that subcommand. + --help [command-name] + Print a synopsis of available commands and exit. With an opâ + tional command name, show the man page for that subcommand. - --version - Print the installed version of notmuch, and exit. + --version + Print the installed version of notmuch, and exit. - --config=FILE - Specify the configuration file to use. This overrides any - configuration file specified by ${NOTMUCH_CONFIG}. + --config=FILE + Specify the configuration file to use. This overrides any conâ + figuration file specified by ${NOTMUCH_CONFIG}. The empty string + is a permitted and sometimes useful value of FILE, which tells + notmuch to use only configuration metadata from the database. - --uuid=HEX - Enforce that the database UUID (a unique identifier which - persists until e.g. the database is compacted) is HEX; exit - with an error if it is not. This is useful to detect rollover - in modification counts on messages. You can find this UUID - using e.g. notmuch count --lastmod + --uuid=HEX + Enforce that the database UUID (a unique identifier which perâ + sists until e.g. the database is compacted) is HEX; exit with an + error if it is not. This is useful to detect rollover in modifiâ + cation 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 comâ mand. For example, notmuch subcommand --uuid=HEX is equivalent to not- @@ -103,8 +105,8 @@ The search, show, address and count commands are used to query the email database. - The reply command is useful for preparing a template for an email - reply. + The reply command is useful for preparing a template for an email reâ + ply. The tag command is the only command available for manipulating database contents. @@ -116,6 +118,26 @@ configuration file.+
+ If the given command is not known to notmuch, notmuch tries to execute + the external notmuch-<subcommand> in ${PATH} instead. This allows users + to have their own notmuch related tools to be run via the notmuch comâ + mand. By design, this does not allow notmuch's own commands to be overâ + ridden using external commands. ++ +
+ All options accepting an argument can be used with '=' or ':' as a sepâ + arator. Except for boolean options (which would be ambiguous), a space + can also be used as a separator. The following are all equivalent: + + notmuch --config=alt-config config get user.name + notmuch --config:alt-config config get user.name + notmuch --config alt-config config get user.name ++
The following environment variables can be used to control the behavior @@ -127,8 +149,8 @@ set. NOTMUCH_TALLOC_REPORT - Location to write a talloc memory usage report. See tal- - loc_enable_leak_report_full in talloc(3) for more information. + Location to write a talloc memory usage report. See talloc_en- + able_leak_report_full in talloc(3) for more information. NOTMUCH_DEBUG_QUERY If set to a non-empty value, the notmuch library will print (to @@ -139,9 +161,9 @@notmuch-address(1), notmuch-compact(1), notmuch-config(1), notâ much-count(1), notmuch-dump(1), notmuch-hooks(5), notmuch-insert(1), - notmuch-new(1), notmuch-reply(1), notmuch-restore(1), notâ - much-search(1), notmuch-search-terms(7), notmuch-show(1), notâ - much-tag(1) + notmuch-new(1), notmuch-properties(7), notmuch-reindex(1), notmuch-reâ + ply(1), notmuch-restore(1), notmuch-search(1), notmuch-search-terms(7), + notmuch-show(1), notmuch-tag(1) The notmuch website: https://notmuchmail.org@@ -163,7 +185,7 @@COPYRIGHT
- 2009-2016, Carl Worth and many others + 2009-2021, Carl Worth and many others-0.23
+0.32