news for notmch 0.32.1

[notmuch-wiki] / manpages / notmuch-1.mdwn

diff --git a/manpages/notmuch-1.mdwn b/manpages/notmuch-1.mdwn
index a337685d70f57e8351cdfadb59a5292151f721c3..d9629249fdcb064732fd35ba284ccd6911110940 100644 (file)
--- 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‐
        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>


@@ -42,15 +42,17 @@
        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‐


@@ -103,8 +105,8 @@
        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.


@@ -128,9 +130,8 @@
 <h3> &nbsp; OPTION SYNTAX</h3>
 <pre>
        All options accepting an argument can be used with &apos;=&apos; or &apos;:&apos; as a sep‐
 <h3> &nbsp; OPTION SYNTAX</h3>
 <pre>
        All options accepting an argument can be used with &apos;=&apos; or &apos;:&apos; as a sep‐

-       arator. For the cases where it&apos;s not ambiguous (in particular excluding
-       boolean options), a space can also  be  used.  The  following  are  all
-       equivalent:
+       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
           notmuch --config:alt-config config get user.name


@@ -143,37 +144,37 @@
        of notmuch.
 
        <b>NOTMUCH</b>_<b>CONFIG</b>
        of notmuch.
 
        <b>NOTMUCH</b>_<b>CONFIG</b>

-              Specifies the location of the notmuch configuration  file.  Not‐
-              much  will  use  ${HOME}/.notmuch-config if this variable is not
+              Specifies  the  location of the notmuch configuration file. Not‐
+              much will use ${HOME}/.notmuch-config if this  variable  is  not

               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>
 
        <b>NOTMUCH</b>_<b>DEBUG</b>_<b>QUERY</b>

-              If  set to a non-empty value, the notmuch library will print (to
+              If set to a non-empty value, the notmuch library will print  (to

               stderr) Xapian queries it constructs.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
               stderr) Xapian queries it constructs.
 </pre>
 
 <h2>SEE ALSO</h2>
 <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-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-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>
 
 <h2>CONTACT</h2>
 <pre>
 
        The notmuch website: <b>https://notmuchmail.org</b>
 </pre>
 
 <h2>CONTACT</h2>
 <pre>

-       Feel free to send questions, comments, or kudos to the notmuch  mailing
-       list  &lt;<u>notmuch@notmuchmail.org</u>&gt;  .  Subscription is not required before
+       Feel  free to send questions, comments, or kudos to the notmuch mailing
+       list &lt;<u>notmuch@notmuchmail.org</u>&gt; . Subscription is  not  required  before

        posting, but is available from the notmuchmail.org website.
 
        posting, but is available from the notmuchmail.org website.
 

-       Real-time interaction with the Notmuch community is available  via  IRC
+       Real-time  interaction  with the Notmuch community is available via IRC

        (server: irc.freenode.net, channel: #notmuch).
 </pre>
 
        (server: irc.freenode.net, channel: #notmuch).
 </pre>
 


@@ -184,7 +185,7 @@
 
 <h2>COPYRIGHT</h2>
 <pre>
 
 <h2>COPYRIGHT</h2>
 <pre>

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

 </pre>
 
 </pre>
 

-<h2>0.28</h2>
+<h2>0.32</h2>