]> git.notmuchmail.org Git - notmuch-wiki/blobdiff - manpages/notmuch-1.mdwn
manpages updates for release 0.32
[notmuch-wiki] / manpages / notmuch-1.mdwn
index 0340ca8519509fd79a141bff8d3ae9b5d6c4c8f7..d9629249fdcb064732fd35ba284ccd6911110940 100644 (file)
@@ -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‐
        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  <u>https://notmuchmail.org</u>  for more about
-       alternate interfaces to notmuch. The emacs-based interface  to  notmuch
+       much  library interface. See <u>https://notmuchmail.org</u> for more about al‐
+       ternate interfaces to notmuch. The  emacs-based  interface  to  notmuch
        (available under <b>emacs/</b> in the Notmuch source distribution) is probably
        the most widely used at this time.
 </pre>
        (available under <b>emacs/</b> in the Notmuch source distribution) is probably
        the most widely used at this time.
 </pre>
        Supported global options for <b>notmuch</b> include
 
        <b>--help</b> <b>[command-name]</b>
        Supported global options for <b>notmuch</b> include
 
        <b>--help</b> <b>[command-name]</b>
-              Print a  synopsis  of  available  commands  and  exit.  With  an
-              optional command name, show the man page for that subcommand.
+              Print a synopsis of available commands and  exit.  With  an  op‐
+              tional command name, show the man page for that subcommand.
 
        <b>--version</b>
               Print the installed version of notmuch, and exit.
 
        <b>--config=FILE</b>
               Specify  the  configuration file to use. This overrides any con‐
 
        <b>--version</b>
               Print the installed version of notmuch, and exit.
 
        <b>--config=FILE</b>
               Specify  the  configuration file to use. This overrides any con‐
-              figuration file specified by ${NOTMUCH_CONFIG}.
+              figuration file specified by ${NOTMUCH_CONFIG}. The empty string
+              is  a  permitted and sometimes useful value of <u>FILE</u>, which tells
+              <b>notmuch</b> to use only configuration metadata from the database.
 
        <b>--uuid=HEX</b>
               Enforce that the database UUID (a unique identifier  which  per‐
 
        <b>--uuid=HEX</b>
               Enforce that the database UUID (a unique identifier  which  per‐
        The  <b>search</b>,  <b>show</b>,  <b>address</b>  and  <b>count</b> commands are used to query the
        email database.
 
        The  <b>search</b>,  <b>show</b>,  <b>address</b>  and  <b>count</b> commands are used to query the
        email database.
 
-       The <b>reply</b> command is useful for  preparing  a  template  for  an  email
-       reply.
+       The <b>reply</b> command is useful for preparing a template for an  email  re‐
+       ply.
 
        The <b>tag</b> command is the only command available for manipulating database
        contents.
 
        The <b>tag</b> command is the only command available for manipulating database
        contents.
               set.
 
        <b>NOTMUCH</b>_<b>TALLOC</b>_<b>REPORT</b>
               set.
 
        <b>NOTMUCH</b>_<b>TALLOC</b>_<b>REPORT</b>
-              Location  to  write  a  talloc  memory  usage  report.  See <b>tal-</b>
-              <b>loc</b>_<b>enable</b>_<b>leak</b>_<b>report</b>_<b>full</b> in <b>talloc</b>(3) for more information.
+              Location  to  write a talloc memory usage report. See <b>talloc</b>_<b>en-</b>
+              <b>able</b>_<b>leak</b>_<b>report</b>_<b>full</b> in <b>talloc</b>(3) for more information.
 
        <b>NOTMUCH</b>_<b>DEBUG</b>_<b>QUERY</b>
               If set to a non-empty value, the notmuch library will print  (to
 
        <b>NOTMUCH</b>_<b>DEBUG</b>_<b>QUERY</b>
               If set to a non-empty value, the notmuch library will print  (to
 <pre>
        <a href='../notmuch-address-1/'>notmuch-address</a>(1),    <a href='../notmuch-compact-1/'>notmuch-compact</a>(1),    <a href='../notmuch-config-1/'>notmuch-config</a>(1),   <a href='../notmuch-count-1/'>not‐</a>
        <a href='../notmuch-count-1/'>much-count</a>(1),  <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),
 <pre>
        <a href='../notmuch-address-1/'>notmuch-address</a>(1),    <a href='../notmuch-compact-1/'>notmuch-compact</a>(1),    <a href='../notmuch-config-1/'>notmuch-config</a>(1),   <a href='../notmuch-count-1/'>not‐</a>
        <a href='../notmuch-count-1/'>much-count</a>(1),  <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),
-       <a href='../notmuch-new-1/'>notmuch-new</a>(1),    <a href='../notmuch-properties-7/'>notmuch-properties</a>(7),    <a href='../notmuch-reindex-1/'>notmuch-reindex</a>(1),   <a href='../notmuch-reply-1/'>not‐</a>
-       <a href='../notmuch-reply-1/'>much-reply</a>(1),     <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),     <a href='../notmuch-search-1/'>notmuch-search</a>(1),      <a href='../notmuch-search-terms-7/'>not‐</a>
-       <a href='../notmuch-search-terms-7/'>much-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
+       <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-properties-7/'>notmuch-properties</a>(7), <a href='../notmuch-reindex-1/'>notmuch-reindex</a>(1), <a href='../notmuch-reply-1/'>notmuch-re‐</a>
+       <a href='../notmuch-reply-1/'>ply</a>(1), <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <a href='../notmuch-search-1/'>notmuch-search</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7),
+       <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
 
        The notmuch website: <b>https://notmuchmail.org</b>
 </pre>
 
        The notmuch website: <b>https://notmuchmail.org</b>
 </pre>
 
 <h2>COPYRIGHT</h2>
 <pre>
 
 <h2>COPYRIGHT</h2>
 <pre>
-       2009-2020, Carl Worth and many others
+       2009-2021, Carl Worth and many others
 </pre>
 
 </pre>
 
-<h2>0.31</h2>
+<h2>0.32</h2>