X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-1.mdwn;h=d9629249fdcb064732fd35ba284ccd6911110940;hb=7ab49d222b1bafd16ce17aa2a8f21648fb3ac8fd;hp=da44ca94f1bf151deb1b8f375e2872cf167dc924;hpb=46b88668029f0f014c4ecf7a220b7a99a13776f3;p=notmuch-wiki diff --git a/manpages/notmuch-1.mdwn b/manpages/notmuch-1.mdwn index da44ca9..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.
@@ -122,7 +124,18 @@
        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‐
-       riden using external commands.
+       ridden using external commands.
+
+ +

  OPTION SYNTAX

+
+       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

ENVIRONMENT

@@ -136,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 @@ -148,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
@@ -172,7 +185,7 @@

COPYRIGHT

-       2009-2017, Carl Worth and many others
+       2009-2021, Carl Worth and many others
-

0.24

+

0.32