]> git.cworth.org Git - obsolete/notmuch-wiki/commitdiff
Update news & manpages to notmuch version 0.16 master
authorTomi Ollila <tomi.ollila@iki.fi>
Sat, 3 Aug 2013 20:33:08 +0000 (23:33 +0300)
committerTomi Ollila <tomi.ollila@iki.fi>
Sat, 3 Aug 2013 20:33:08 +0000 (23:33 +0300)
Executed

  ../notmuch/devel/news2wiki.pl ../notmuch/NEWS news
  ../notmuch/devel/man-to-mdwn.pl ../notmuch/man/ .
  git add manpages/notmuch-insert-1.mdwn
  git add news/release-0.16.mdwn
  git commit -a

in debootstrapped Debian 7 (Wheezy) inside lxc container running
in Fedora 19.

16 files changed:
manpages.mdwn
manpages/notmuch-1.mdwn
manpages/notmuch-config-1.mdwn
manpages/notmuch-count-1.mdwn
manpages/notmuch-dump-1.mdwn
manpages/notmuch-hooks-5.mdwn
manpages/notmuch-insert-1.mdwn [new file with mode: 0644]
manpages/notmuch-new-1.mdwn
manpages/notmuch-reply-1.mdwn
manpages/notmuch-restore-1.mdwn
manpages/notmuch-search-1.mdwn
manpages/notmuch-search-terms-7.mdwn
manpages/notmuch-setup-1.mdwn
manpages/notmuch-show-1.mdwn
manpages/notmuch-tag-1.mdwn
news/release-0.16.mdwn [new file with mode: 0644]

index 6bb01fac00411709c556dd73e42a00e21c80ca76..8c49ec4225ca98d7791719caa28d075203398846 100644 (file)
@@ -5,6 +5,7 @@ Manual page index
 * <a href='notmuch-config-1/'>notmuch-config</a>(1) - access notmuch configuration file
 * <a href='notmuch-count-1/'>notmuch-count</a>(1) - count messages matching the given search terms
 * <a href='notmuch-dump-1/'>notmuch-dump</a>(1) - creates a plain-text dump of the tags of each message
 * <a href='notmuch-config-1/'>notmuch-config</a>(1) - access notmuch configuration file
 * <a href='notmuch-count-1/'>notmuch-count</a>(1) - count messages matching the given search terms
 * <a href='notmuch-dump-1/'>notmuch-dump</a>(1) - creates a plain-text dump of the tags of each message
+* <a href='notmuch-insert-1/'>notmuch-insert</a>(1) - add a message to the maildir and notmuch database
 * <a href='notmuch-new-1/'>notmuch-new</a>(1) - incorporate new mail into the notmuch database
 * <a href='notmuch-reply-1/'>notmuch-reply</a>(1) - constructs a reply template for a set of messages
 * <a href='notmuch-restore-1/'>notmuch-restore</a>(1) - restores the tags from the given file (see notmuch dump)
 * <a href='notmuch-new-1/'>notmuch-new</a>(1) - incorporate new mail into the notmuch database
 * <a href='notmuch-reply-1/'>notmuch-reply</a>(1) - constructs a reply template for a set of messages
 * <a href='notmuch-restore-1/'>notmuch-restore</a>(1) - restores the tags from the given file (see notmuch dump)
index 131258dd8fc37e1b3213e3dbfc16fd5169d34b5e..5359098d8f2c1c05fa86bd8c02e3b7acfd2b2c36 100644 (file)
@@ -7,7 +7,7 @@
 
 <h2>SYNOPSIS</h2>
 <pre>
 
 <h2>SYNOPSIS</h2>
 <pre>
-       <b>notmuch</b> <u>command</u> [<u>args</u> ...]
+       <b>notmuch</b> [<u>option</u> ...] <u>command</u> [<u>arg</u> ...]
 </pre>
 
 <h2>DESCRIPTION</h2>
 </pre>
 
 <h2>DESCRIPTION</h2>
        the most widely used at this time.
 </pre>
 
        the most widely used at this time.
 </pre>
 
+<h2>OPTIONS</h2>
+<pre>
+       Supported global options for <b>notmuch</b> include
+
+           <b>--help</b>
+
+               Print a synopsis of available commands and exit.
+
+           <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}.
+</pre>
+
 <h2>COMMANDS</h2>
 
 <h3> &nbsp; SETUP</h3>
 <pre>
 <h2>COMMANDS</h2>
 
 <h3> &nbsp; SETUP</h3>
 <pre>
-       The <b>notmuch</b> <b>setup</b> command is used to configure Notmuch for  first  use,
+       The  <b>notmuch</b>  <b>setup</b> command is used to configure Notmuch for first use,
        (or to reconfigure it later).
 
        (or to reconfigure it later).
 
-       The  setup  command  will prompt for your full name, your primary email
-       address, any alternate email addresses you use, and the directory  con-
+       The setup command will prompt for your full name,  your  primary  email
+       address,  any alternate email addresses you use, and the directory con-
        taining your email archives. Your answers will be written to a configu-
        taining your email archives. Your answers will be written to a configu-
-       ration file in ${NOTMUCH_CONFIG} (if set) or ${HOME}/.notmuch-config  .
+       ration  file in ${NOTMUCH_CONFIG} (if set) or ${HOME}/.notmuch-config .
        This configuration file will be created with descriptive comments, mak-
        This configuration file will be created with descriptive comments, mak-
-       ing it easy to edit by hand later to change the configuration.  Or  you
+       ing  it  easy to edit by hand later to change the configuration. Or you
        can run <b>notmuch</b> <b>setup</b> again to change the configuration.
 
        can run <b>notmuch</b> <b>setup</b> again to change the configuration.
 
-       The  mail  directory you specify can contain any number of sub-directo-
+       The mail directory you specify can contain any number  of  sub-directo-
        ries and should primarily contain only files with individual email mes-
        ries and should primarily contain only files with individual email mes-
-       sages  (eg.  maildir  or  mh archives are perfect). If there are other,
-       non-email files (such as indexes maintained by  other  email  programs)
+       sages (eg. maildir or mh archives are perfect).  If  there  are  other,
+       non-email  files  (such  as indexes maintained by other email programs)
        then notmuch will do its best to detect those and ignore them.
 
        then notmuch will do its best to detect those and ignore them.
 
-       Mail  storage that uses mbox format, (where one mbox file contains many
-       messages), will not work with notmuch. If that&apos;s how your mail is  cur-
+       Mail storage that uses mbox format, (where one mbox file contains  many
+       messages),  will not work with notmuch. If that&apos;s how your mail is cur-
        rently stored, it is recommended you first convert it to maildir format
        with a utility such as mb2md before running <b>notmuch</b> <b>setup</b> <b>.</b>
 
        rently stored, it is recommended you first convert it to maildir format
        with a utility such as mb2md before running <b>notmuch</b> <b>setup</b> <b>.</b>
 
-       Invoking <b>notmuch</b> with no command argument will run <b>setup</b> if  the  setup
+       Invoking  <b>notmuch</b>  with no command argument will run <b>setup</b> if the setup
        command has not previously been completed.
 </pre>
 
 <h3> &nbsp; OTHER COMMANDS</h3>
 <pre>
        command has not previously been completed.
 </pre>
 
 <h3> &nbsp; OTHER COMMANDS</h3>
 <pre>
-       Several  of the notmuch commands accept search terms with a common syn-
+       Several of the notmuch commands accept search terms with a common  syn-
        tax. See notmuch-search-terms(7) for more details on the supported syn-
        tax.
 
        tax. See notmuch-search-terms(7) for more details on the supported syn-
        tax.
 
-       The  <b>search</b>,  <b>show</b>  and  <b>count</b>  commands  are  used  to query the email
-       database.
+       The <b>search</b>, <b>show</b> and <b>count</b> commands are used to query the  email  data-
+       base.
 
 
-       The <b>reply</b> command is useful for  preparing  a  template  for  an  email
+       The  <b>reply</b>  command  is  useful  for  preparing a template for an email
        reply.
 
        The <b>tag</b> command is the only command available for manipulating database
        contents.
 
        reply.
 
        The <b>tag</b> command is the only command available for manipulating database
        contents.
 
-       The <b>dump</b> and <b>restore</b> commands can be used to create a textual  dump  of
+       The  <b>dump</b>  and <b>restore</b> commands can be used to create a textual dump of
        email tags for backup purposes, and to restore from that dump.
 
        email tags for backup purposes, and to restore from that dump.
 
-       The  <b>config</b>  command can be used to get or set settings int the notmuch
+       The <b>config</b> command can be used to get or set settings int  the  notmuch
        configuration file.
 </pre>
 
        configuration file.
 </pre>
 
        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.
               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.
+
+       <b>NOTMUCH</b>_<b>DEBUG</b>_<b>QUERY</b>
+              If  set to a non-empty value, the notmuch library will print (to
+              stderr) Xapian queries it constructs.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5),
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5),
-       <a href='../notmuch-new-1/'>notmuch-new</a>(1),    <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),    <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),    <a href='../notmuch-search-1/'>notmuch-</a>
-       <a href='../notmuch-search-1/'>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)
+       <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),     <a href='../notmuch-new-1/'>notmuch-new</a>(1),    <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),    <a href='../notmuch-restore-1/'>notmuch-</a>
+       <a href='../notmuch-restore-1/'>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-</a>
+       <a href='../notmuch-show-1/'>show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
 
        The notmuch website: <b>http://notmuchmail.org</b>
 </pre>
 
        The notmuch website: <b>http://notmuchmail.org</b>
 </pre>
        (server: irc.freenode.net, channel: #notmuch).
 </pre>
 
        (server: irc.freenode.net, channel: #notmuch).
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index d5250186ec853f212ccc8ae9e72b54ad859f06cb..bb2248a4a26972fe7bfe9356b5b2e5ee92889807 100644 (file)
 
 <h2>SEE ALSO</h2>
 <pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-count-1/'>notmuch-count</a>(1),  <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-new-1/'>not-</a>
-       <a href='../notmuch-new-1/'>much-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-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-1/'>notmuch</a>(1),  <a href='../notmuch-count-1/'>notmuch-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/'>not-</a>
+       <a href='../notmuch-insert-1/'>much-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 7efe4930a4a1628f5bae830c54ee6e01c535d98c..8f7ed4640c5f86a7209c09d92d30641977d2203f 100644 (file)
@@ -16,8 +16,8 @@
 
        The number of matching messages (or threads) is output to stdout.
 
 
        The number of matching messages (or threads) is output to stdout.
 
-       With  no  search  terms,  a  count  of all messages (or threads) in the
-       database will be displayed.
+       With no search terms, a count of all messages (or threads) in the data-
+       base will be displayed.
 
        See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of  the  supported  syntax  for
        &lt;search-terms&gt;.
 
        See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of  the  supported  syntax  for
        &lt;search-terms&gt;.
 
                Specify whether to omit  messages  matching  search.tag_exclude
                from the count (the default) or not.
 
                Specify whether to omit  messages  matching  search.tag_exclude
                from the count (the default) or not.
+
+           <b>--batch</b>
+
+               Read  queries from a file (stdin by default), one per line, and
+               output the number of matching messages (or threads) to  stdout,
+               one  per line. On an empty input line the count of all messages
+               (or threads) in the database will be output. This option is not
+               compatible with specifying search terms on the command line.
+
+           <b>--input=</b>&lt;filename&gt;
+
+               Read  input  from  given  file,  instead of from stdin. Implies
+               <b>--batch</b>.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-new-1/'>not-</a>
-       <a href='../notmuch-new-1/'>much-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-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-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</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/'>not-</a>
+       <a href='../notmuch-insert-1/'>much-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-show-1/'>notmuch-show</a>(1),  <a href='../notmuch-tag-1/'>notmuch-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 2f4db7f04d8f5c82c745301ac32c0ec0cf14669a..76eac67748a6e6c5d9eac7e5d97cde86dfbb40cb 100644 (file)
@@ -27,7 +27,9 @@
            Notmuch restore supports two plain text dump formats, both with one
            message-id per line, followed by a list of tags.
 
            Notmuch restore supports two plain text dump formats, both with one
            message-id per line, followed by a list of tags.
 
-           <b>sup</b>  The <b>sup</b> dump file format is specifically chosen to be compati-
+           <b>sup</b>
+
+               The <b>sup</b> dump file format is specifically chosen to be  compati-
                ble  with  the  format  of  files  produced by sup-dump.  So if
                you&apos;ve previously been using sup for  mail,  then  the  <b>notmuch</b>
                <b>restore</b>  command  provides you a way to import all of your tags
                ble  with  the  format  of  files  produced by sup-dump.  So if
                you&apos;ve previously been using sup for  mail,  then  the  <b>notmuch</b>
                <b>restore</b>  command  provides you a way to import all of your tags
                Tags are hex-encoded by replacing every byte not  matching  the
                regex <b>[A-Za-z0-9@=.,</b>_<b>+-]</b> with <b>%nn</b> where nn is the two digit hex
                encoding.  The message ID is a valid Xapian query, quoted using
                Tags are hex-encoded by replacing every byte not  matching  the
                regex <b>[A-Za-z0-9@=.,</b>_<b>+-]</b> with <b>%nn</b> where nn is the two digit hex
                encoding.  The message ID is a valid Xapian query, quoted using
-               Xapian  boolean  term quoting rules: if the ID contains whites-
-               pace or a close paren or starts with a double quote, it must be
-               enclosed  in double quotes and double quotes inside the ID must
-               be doubled.  The astute reader will notice this  is  a  special
-               case  of  the  batch input format for <a href='../notmuch-tag-1/'>notmuch-tag</a>(1); note that
-               the  single  message-id  query  is   mandatory   for   <a href='../notmuch-restore-1/'>notmuch-</a>
+               Xapian  boolean  term  quoting rules: if the ID contains white-
+               space or a close paren or starts with a double quote,  it  must
+               be  enclosed  in  double quotes and double quotes inside the ID
+               must be doubled.  The astute reader will notice this is a  spe-
+               cial  case  of  the batch input format for <a href='../notmuch-tag-1/'>notmuch-tag</a>(1); note
+               that the single message-id  query  is  mandatory  for  <a href='../notmuch-restore-1/'>notmuch-</a>
                <a href='../notmuch-restore-1/'>restore</a>(1).
 
            With  no  search terms, a dump of all messages in the database will
                <a href='../notmuch-restore-1/'>restore</a>(1).
 
            With  no  search terms, a dump of all messages in the database will
 
 <h2>SEE ALSO</h2>
 <pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-new-1/'>not-</a>
-       <a href='../notmuch-new-1/'>much-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-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-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-insert-1/'>not-</a>
+       <a href='../notmuch-insert-1/'>much-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-show-1/'>notmuch-show</a>(1),  <a href='../notmuch-tag-1/'>notmuch-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 4546280afe8be878d32768c5cbc736a5437d88a4..4e9f1c6b35617e84b696d8f7f1e3dd8a74b19695 100644 (file)
 
 <h2>SEE ALSO</h2>
 <pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-new-1/'>not-</a>
-       <a href='../notmuch-new-1/'>much-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-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-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-insert-1/'>not-</a>
+       <a href='../notmuch-insert-1/'>much-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-show-1/'>notmuch-show</a>(1),  <a href='../notmuch-tag-1/'>notmuch-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
diff --git a/manpages/notmuch-insert-1.mdwn b/manpages/notmuch-insert-1.mdwn
new file mode 100644 (file)
index 0000000..8ccfda1
--- /dev/null
@@ -0,0 +1,63 @@
+<h1>NOTMUCH-INSERT(1)</h1>
+
+<h2>NAME</h2>
+<pre>
+       notmuch-insert - add a message to the maildir and notmuch database
+</pre>
+
+<h2>SYNOPSIS</h2>
+<pre>
+       <b>notmuch</b> <b>insert</b> [<u>options</u>] [ +&lt;<u>tag</u>&gt;|-&lt;<u>tag</u>&gt; ... ]
+</pre>
+
+<h2>DESCRIPTION</h2>
+<pre>
+       <b>notmuch</b> <b>insert</b> reads a message from standard input and delivers it into
+       the maildir directory given by configuration option <b>database.path</b>, then
+       incorporates  the message into the notmuch database.  It is an alterna-
+       tive to using a separate tool to deliver the message then running  <b>not-</b>
+       <b>much</b> <b>new</b> afterwards.
+
+       The  new message will be tagged with the tags specified by the <b>new.tags</b>
+       configuration option, then by operations specified on the command-line:
+       tags prefixed by &apos;+&apos; are added while those prefixed by &apos;-&apos; are removed.
+
+       If  the  new message is a duplicate of an existing message in the data-
+       base (it has same Message-ID), it will be added to the  maildir  folder
+       and notmuch database, but the tags will not be changed.
+
+       Option  arguments must appear before any tag operation arguments.  Sup-
+       ported options for <b>insert</b> include
+
+           <b>--folder=</b>&lt<b>&</b>lt;<u>folder</u>&gt<b>&</b>gt;
+
+               Deliver the message to the specified folder,  relative  to  the
+               top-level  directory  given by the value of <b>database.path</b>.  The
+               default is to deliver to the top-level directory.
+
+           <b>--create-folder</b>
+
+               Try to create the folder named by the <b>--folder</b>  option,  if  it
+               does  not  exist.   Otherwise the folder must already exist for
+               mail delivery to succeed.
+</pre>
+
+<h2>EXIT STATUS</h2>
+<pre>
+       This command returns exit status 0  if  the  message  was  successfully
+       added  to  the mail directory, even if the message could not be indexed
+       and added to the notmuch database.  In the latter case, a warning  will
+       be printed to standard error but the message file will be left on disk.
+
+       If the message could not be written to disk then a non-zero exit status
+       is returned.
+</pre>
+
+<h2>SEE ALSO</h2>
+<pre>
+       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
+</pre>
+
+<h2>Notmuch 0.16</h2>
index 18169ff4d3a31203739deee07d07230ebae7431c..60bd880f69f0e03e148529eaab2d5fb56c510f7a 100644 (file)
@@ -46,8 +46,9 @@
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-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-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-insert-1/'>notmuch-insert</a>(1), <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 41320dc1383cff6107fcccd84532088b291329b6..9dde8c4922a5e43aa2bca17837c9c8451df8c97d 100644 (file)
                   Decrypt  any MIME encrypted parts found in the selected con-
                   tent  (ie.  &quot;multipart/encrypted&quot;  parts).  Status  of   the
                   decryption  will  be reported (currently only supported with
                   Decrypt  any MIME encrypted parts found in the selected con-
                   tent  (ie.  &quot;multipart/encrypted&quot;  parts).  Status  of   the
                   decryption  will  be reported (currently only supported with
-                  --format=json and --format=sexp) and the multipart/encrypted
-                  part will be replaced by the decrypted content.
+                  --format=json and --format=sexp) and on  successful  decryp-
+                  tion  the  multipart/encrypted  part will be replaced by the
+                  decrypted content.
+
+                  Decryption expects a functioning <b>gpg-agent</b>(1) to provide any
+                  needed credentials. Without one, the decryption will fail.
 
        See  <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7)  for  details  of the supported syntax for
        &lt;search-terms&gt;.
 
        See  <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7)  for  details  of the supported syntax for
        &lt;search-terms&gt;.
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</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)
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</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-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index a01cb3845f920c248e04adcd6a9fa46d5d4adc03..8164f92cd6c0169174b39871fbf05e756aff60e1 100644 (file)
@@ -32,7 +32,9 @@
                line specifying a message-id and a set of tags.  For details of
                the actual formats, see <a href='../notmuch-dump-1/'>notmuch-dump</a>(1).
 
                line specifying a message-id and a set of tags.  For details of
                the actual formats, see <a href='../notmuch-dump-1/'>notmuch-dump</a>(1).
 
-               <b>sup</b>  The <b>sup</b> dump file format is specifically chosen to be com-
+               <b>sup</b>
+
+                   The  <b>sup</b> dump file format is specifically chosen to be com-
                    patible with the format of files produced by sup-dump.   So
                    if you&apos;ve previously been using sup for mail, then the <b>not-</b>
                    <b>much</b> <b>restore</b> command provides you a way to  import  all  of
                    patible with the format of files produced by sup-dump.   So
                    if you&apos;ve previously been using sup for mail, then the <b>not-</b>
                    <b>much</b> <b>restore</b> command provides you a way to  import  all  of
@@ -41,8 +43,8 @@
                <b>batch-tag</b>
 
                    The  <b>batch-tag</b>  dump  format  is  intended  to  more robust
                <b>batch-tag</b>
 
                    The  <b>batch-tag</b>  dump  format  is  intended  to  more robust
-                   against malformed message-ids and tags  containing  whites-
-                   pace  or  non-<b>ascii</b>(7) characters.  See <a href='../notmuch-dump-1/'>notmuch-dump</a>(1) for
+                   against malformed message-ids and  tags  containing  white-
+                   space  or non-<b>ascii</b>(7) characters.  See <a href='../notmuch-dump-1/'>notmuch-dump</a>(1) for
                    details on this format.
 
                    <b>notmuch</b> <b>restore</b> updates the maildir flags according to  tag
                    details on this format.
 
                    <b>notmuch</b> <b>restore</b> updates the maildir flags according to  tag
@@ -60,8 +62,9 @@
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-reply</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)
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),   <a href='../notmuch-reply-1/'>notmuch-reply</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-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 11c3ba6366fdebda7d1eec55f31d11f1512cc98c..e8b6c279d39d364d44f8556352293b1b90f2e058 100644 (file)
@@ -82,8 +82,8 @@
            <b>--sort=</b>(<b>newest-first</b>|<b>oldest-first</b>)
 
                This option can be used to present results in either chronolog-
            <b>--sort=</b>(<b>newest-first</b>|<b>oldest-first</b>)
 
                This option can be used to present results in either chronolog-
-               ical   order  (<b>oldest-first</b>)  or  reverse  chronological  order
-               (<b>newest-first</b>).
+               ical  order (<b>oldest-first</b>) or reverse chronological order (<b>new-</b>
+               <b>est-first</b>).
 
                Note: The thread order  will  be  distinct  between  these  two
                options  (beyond  being  simply reversed). When sorting by <b>old-</b>
 
                Note: The thread order  will  be  distinct  between  these  two
                options  (beyond  being  simply reversed). When sorting by <b>old-</b>
 
                Limit the number of displayed results to N.
 
 
                Limit the number of displayed results to N.
 
-           <b>--exclude=(true|false|flag)</b>
+           <b>--exclude=(true|false|all|flag)</b>
 
 
-               Specify whether to omit  messages  matching  search.tag_exclude
-               from  the search results (the default) or not. The extra option
-               <b>flag</b> only has an effect when <b>--output=summary</b> In this case  all
-               matching threads are returned but the &quot;match count&quot; is the num-
-               ber of matching non-excluded messages in the thread.
+               A message is called &quot;excluded&quot; if it matches at least  one  tag
+               in  search.tag_exclude  that  does not appear explicitly in the
+               search terms.  This option specifies whether to  omit  excluded
+               messages in the search process.
+
+               The default value, <b>true</b>, prevents excluded messages from match-
+               ing the search terms.
+
+               <b>all</b> additionally prevents excluded messages from  appearing  in
+               displayed  results,  in  effect behaving as though the excluded
+               messages do not exist.
+
+               <b>false</b> allows excluded messages to match search terms and appear
+               in displayed results. Excluded messages are still marked in the
+               relevant outputs.
+
+               <b>flag</b> only has an effect when <b>--output=summary</b>.  The  output  is
+               almost  identical to <b>false</b>, but the &quot;match count&quot; is the number
+               of matching non-excluded messages in the  thread,  rather  than
+               the number of matching messages.
 </pre>
 
 <h2>EXIT STATUS</h2>
 </pre>
 
 <h2>EXIT STATUS</h2>
 
 <h2>SEE ALSO</h2>
 <pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),  <a href='../notmuch-restore-1/'>notmuch-restore</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)
+       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),   <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
+       <a href='../notmuch-restore-1/'>notmuch-restore</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-</a>
+       <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 634fde4f647c431c04feac5c10e058ead0d61743..c4fe11db2ce7020458bd7ca13940cfb0f386fccd 100644 (file)
 
             &lt;initial-timestamp&gt;..&lt;final-timestamp&gt;
 
 
             &lt;initial-timestamp&gt;..&lt;final-timestamp&gt;
 
-       Each timestamp is a number representing the  number  of  seconds  since
+       Each  timestamp  is  a  number representing the number of seconds since
        1970-01-01 00:00:00 UTC.
 
        1970-01-01 00:00:00 UTC.
 
-       In  addition  to  individual terms, multiple terms can be combined with
-       Boolean operators ( <b>and</b>, <b>or</b>, <b>not</b> , etc.). Each term in the  query  will
-       be  implicitly  connected  by  a logical AND if no explicit operator is
-       provided, (except that terms with a common prefix  will  be  implicitly
+       In addition to individual terms, multiple terms can  be  combined  with
+       Boolean  operators  ( <b>and</b>, <b>or</b>, <b>not</b> , etc.). Each term in the query will
+       be implicitly connected by a logical AND if  no  explicit  operator  is
+       provided,  (except  that  terms with a common prefix will be implicitly
        combined with OR until we get Xapian defect #402 fixed).
 
        combined with OR until we get Xapian defect #402 fixed).
 
-       Parentheses  can also be used to control the combination of the Boolean
-       operators, but will have to be protected  from  interpretation  by  the
-       shell,  (such  as  by  putting quotation marks around any parenthesized
+       Parentheses can also be used to control the combination of the  Boolean
+       operators,  but  will  have  to be protected from interpretation by the
+       shell, (such as by putting quotation  marks  around  any  parenthesized
        expression).
 </pre>
 
 <h2>DATE AND TIME SEARCH</h2>
 <pre>
        expression).
 </pre>
 
 <h2>DATE AND TIME SEARCH</h2>
 <pre>
-       notmuch understands a variety of standard and natural ways of  express-
+       notmuch  understands a variety of standard and natural ways of express-
        ing dates and times, both in absolute terms (&quot;2012-10-24&quot;) and in rela-
        ing dates and times, both in absolute terms (&quot;2012-10-24&quot;) and in rela-
-       tive terms (&quot;yesterday&quot;). Any number of relative terms can be  combined
-       (&quot;1  hour  25  minutes&quot;) and an absolute date/time can be combined with
-       relative terms to further adjust it. A  non-exhaustive  description  of
+       tive  terms (&quot;yesterday&quot;). Any number of relative terms can be combined
+       (&quot;1 hour 25 minutes&quot;) and an absolute date/time can  be  combined  with
+       relative  terms  to  further adjust it. A non-exhaustive description of
        the syntax supported for absolute and relative terms is given below.
 
            <b>The</b> <b>range</b> <b>expression</b>
 
                date:&lt;since&gt;..&lt;until&gt;
 
        the syntax supported for absolute and relative terms is given below.
 
            <b>The</b> <b>range</b> <b>expression</b>
 
                date:&lt;since&gt;..&lt;until&gt;
 
-               The  above  expression  restricts  the results to only messages
+               The above expression restricts the  results  to  only  messages
                from &lt;since&gt; to &lt;until&gt;, based on the Date: header.
 
                &lt;since&gt; and &lt;until&gt; can describe imprecise times, such as &quot;yes-
                from &lt;since&gt; to &lt;until&gt;, based on the Date: header.
 
                &lt;since&gt; and &lt;until&gt; can describe imprecise times, such as &quot;yes-
-               terday&quot;.   In  this case, &lt;since&gt; is taken as the earliest time
-               it could describe (the beginning of yesterday) and  &lt;until&gt;  is
-               taken  as the latest time it could describe (the end of yester-
+               terday&quot;.  In this case, &lt;since&gt; is taken as the  earliest  time
+               it  could  describe (the beginning of yesterday) and &lt;until&gt; is
+               taken as the latest time it could describe (the end of  yester-
                day). Similarly, date:january..february matches from the begin-
                ning of January to the end of February.
 
                day). Similarly, date:january..february matches from the begin-
                ning of January to the end of February.
 
-               Currently,  we  do not support spaces in range expressions. You
+               Currently, we do not support spaces in range  expressions.  You
                can replace the spaces with &apos;_&apos;, or (in most cases) &apos;-&apos;, or (in
                can replace the spaces with &apos;_&apos;, or (in most cases) &apos;-&apos;, or (in
-               some  cases)  leave the spaces out altogether. Examples in this
+               some cases) leave the spaces out altogether. Examples  in  this
                man page use spaces for clarity.
 
                Open-ended ranges are supported (since Xapian 1.2.1), i.e. it&apos;s
                man page use spaces for clarity.
 
                Open-ended ranges are supported (since Xapian 1.2.1), i.e. it&apos;s
-               possible  to  specify  date:..&lt;until&gt;  or date:&lt;since&gt;.. to not
-               limit the start or end  time,  respectively.  Pre-1.2.1  Xapian
-               does  not report an error on open ended ranges, but it does not
+               possible to specify date:..&lt;until&gt;  or  date:&lt;since&gt;..  to  not
+               limit  the  start  or  end time, respectively. Pre-1.2.1 Xapian
+               does not report an error on open ended ranges, but it does  not
                work as expected either.
 
                work as expected either.
 
-               Entering date:expr without &quot;..&quot;  (for  example  date:yesterday)
-               won&apos;t  work,  as  it&apos;s not interpreted as a range expression at
-               all. You can achieve the expected  result  by  duplicating  the
-               expr  both  sides of &quot;..&quot;  (for example date:yesterday..yester-
+               Entering  date:expr  without  &quot;..&quot; (for example date:yesterday)
+               won&apos;t work, as it&apos;s not interpreted as a  range  expression  at
+               all.  You  can  achieve  the expected result by duplicating the
+               expr both sides of &quot;..&quot;  (for  example  date:yesterday..yester-
                day).
 
            <b>Relative</b> <b>date</b> <b>and</b> <b>time</b>
                day).
 
            <b>Relative</b> <b>date</b> <b>and</b> <b>time</b>
 
                All refer to past, can be repeated and will be accumulated.
 
 
                All refer to past, can be repeated and will be accumulated.
 
-               Units  can  be  abbreviated  to  any length, with the otherwise
+               Units can be abbreviated to  any  length,  with  the  otherwise
                ambiguous single m being m for minutes and M for months.
 
                ambiguous single m being m for minutes and M for months.
 
-               Number can also be written out one, two, ..., ten, dozen,  hun-
-               dred.  Additionally,  the  unit  may  be  preceded by &quot;last&quot; or
+               Number  can also be written out one, two, ..., ten, dozen, hun-
+               dred. Additionally, the unit  may  be  preceded  by  &quot;last&quot;  or
                &quot;this&quot; (e.g., &quot;last week&quot; or &quot;this month&quot;).
 
                &quot;this&quot; (e.g., &quot;last week&quot; or &quot;this month&quot;).
 
-               When combined with absolute date and time,  the  relative  date
-               and  time  specification  will  be  relative from the specified
+               When  combined  with  absolute date and time, the relative date
+               and time specification will  be  relative  from  the  specified
                absolute date and time.
 
                Examples: 5M2d, two weeks
                absolute date and time.
 
                Examples: 5M2d, two weeks
 
 <h2>SEE ALSO</h2>
 <pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),  <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),
-       <a href='../notmuch-search-1/'>notmuch-search</a>(1), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
+       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),   <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
+       <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <a href='../notmuch-search-1/'>notmuch-search</a>(1), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index 131258dd8fc37e1b3213e3dbfc16fd5169d34b5e..5359098d8f2c1c05fa86bd8c02e3b7acfd2b2c36 100644 (file)
@@ -7,7 +7,7 @@
 
 <h2>SYNOPSIS</h2>
 <pre>
 
 <h2>SYNOPSIS</h2>
 <pre>
-       <b>notmuch</b> <u>command</u> [<u>args</u> ...]
+       <b>notmuch</b> [<u>option</u> ...] <u>command</u> [<u>arg</u> ...]
 </pre>
 
 <h2>DESCRIPTION</h2>
 </pre>
 
 <h2>DESCRIPTION</h2>
        the most widely used at this time.
 </pre>
 
        the most widely used at this time.
 </pre>
 
+<h2>OPTIONS</h2>
+<pre>
+       Supported global options for <b>notmuch</b> include
+
+           <b>--help</b>
+
+               Print a synopsis of available commands and exit.
+
+           <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}.
+</pre>
+
 <h2>COMMANDS</h2>
 
 <h3> &nbsp; SETUP</h3>
 <pre>
 <h2>COMMANDS</h2>
 
 <h3> &nbsp; SETUP</h3>
 <pre>
-       The <b>notmuch</b> <b>setup</b> command is used to configure Notmuch for  first  use,
+       The  <b>notmuch</b>  <b>setup</b> command is used to configure Notmuch for first use,
        (or to reconfigure it later).
 
        (or to reconfigure it later).
 
-       The  setup  command  will prompt for your full name, your primary email
-       address, any alternate email addresses you use, and the directory  con-
+       The setup command will prompt for your full name,  your  primary  email
+       address,  any alternate email addresses you use, and the directory con-
        taining your email archives. Your answers will be written to a configu-
        taining your email archives. Your answers will be written to a configu-
-       ration file in ${NOTMUCH_CONFIG} (if set) or ${HOME}/.notmuch-config  .
+       ration  file in ${NOTMUCH_CONFIG} (if set) or ${HOME}/.notmuch-config .
        This configuration file will be created with descriptive comments, mak-
        This configuration file will be created with descriptive comments, mak-
-       ing it easy to edit by hand later to change the configuration.  Or  you
+       ing  it  easy to edit by hand later to change the configuration. Or you
        can run <b>notmuch</b> <b>setup</b> again to change the configuration.
 
        can run <b>notmuch</b> <b>setup</b> again to change the configuration.
 
-       The  mail  directory you specify can contain any number of sub-directo-
+       The mail directory you specify can contain any number  of  sub-directo-
        ries and should primarily contain only files with individual email mes-
        ries and should primarily contain only files with individual email mes-
-       sages  (eg.  maildir  or  mh archives are perfect). If there are other,
-       non-email files (such as indexes maintained by  other  email  programs)
+       sages (eg. maildir or mh archives are perfect).  If  there  are  other,
+       non-email  files  (such  as indexes maintained by other email programs)
        then notmuch will do its best to detect those and ignore them.
 
        then notmuch will do its best to detect those and ignore them.
 
-       Mail  storage that uses mbox format, (where one mbox file contains many
-       messages), will not work with notmuch. If that&apos;s how your mail is  cur-
+       Mail storage that uses mbox format, (where one mbox file contains  many
+       messages),  will not work with notmuch. If that&apos;s how your mail is cur-
        rently stored, it is recommended you first convert it to maildir format
        with a utility such as mb2md before running <b>notmuch</b> <b>setup</b> <b>.</b>
 
        rently stored, it is recommended you first convert it to maildir format
        with a utility such as mb2md before running <b>notmuch</b> <b>setup</b> <b>.</b>
 
-       Invoking <b>notmuch</b> with no command argument will run <b>setup</b> if  the  setup
+       Invoking  <b>notmuch</b>  with no command argument will run <b>setup</b> if the setup
        command has not previously been completed.
 </pre>
 
 <h3> &nbsp; OTHER COMMANDS</h3>
 <pre>
        command has not previously been completed.
 </pre>
 
 <h3> &nbsp; OTHER COMMANDS</h3>
 <pre>
-       Several  of the notmuch commands accept search terms with a common syn-
+       Several of the notmuch commands accept search terms with a common  syn-
        tax. See notmuch-search-terms(7) for more details on the supported syn-
        tax.
 
        tax. See notmuch-search-terms(7) for more details on the supported syn-
        tax.
 
-       The  <b>search</b>,  <b>show</b>  and  <b>count</b>  commands  are  used  to query the email
-       database.
+       The <b>search</b>, <b>show</b> and <b>count</b> commands are used to query the  email  data-
+       base.
 
 
-       The <b>reply</b> command is useful for  preparing  a  template  for  an  email
+       The  <b>reply</b>  command  is  useful  for  preparing a template for an email
        reply.
 
        The <b>tag</b> command is the only command available for manipulating database
        contents.
 
        reply.
 
        The <b>tag</b> command is the only command available for manipulating database
        contents.
 
-       The <b>dump</b> and <b>restore</b> commands can be used to create a textual  dump  of
+       The  <b>dump</b>  and <b>restore</b> commands can be used to create a textual dump of
        email tags for backup purposes, and to restore from that dump.
 
        email tags for backup purposes, and to restore from that dump.
 
-       The  <b>config</b>  command can be used to get or set settings int the notmuch
+       The <b>config</b> command can be used to get or set settings int  the  notmuch
        configuration file.
 </pre>
 
        configuration file.
 </pre>
 
        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.
               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.
+
+       <b>NOTMUCH</b>_<b>DEBUG</b>_<b>QUERY</b>
+              If  set to a non-empty value, the notmuch library will print (to
+              stderr) Xapian queries it constructs.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5),
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5),
-       <a href='../notmuch-new-1/'>notmuch-new</a>(1),    <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),    <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),    <a href='../notmuch-search-1/'>notmuch-</a>
-       <a href='../notmuch-search-1/'>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)
+       <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),     <a href='../notmuch-new-1/'>notmuch-new</a>(1),    <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),    <a href='../notmuch-restore-1/'>notmuch-</a>
+       <a href='../notmuch-restore-1/'>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-</a>
+       <a href='../notmuch-show-1/'>show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
 
        The notmuch website: <b>http://notmuchmail.org</b>
 </pre>
 
        The notmuch website: <b>http://notmuchmail.org</b>
 </pre>
        (server: irc.freenode.net, channel: #notmuch).
 </pre>
 
        (server: irc.freenode.net, channel: #notmuch).
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index ceac45c6d6ec4a624ffa2c9dd0fae1df241337a8..00666bd2358972120f1c0823b874f1d55f111433 100644 (file)
                Decrypt any MIME encrypted parts found in the selected  content
                (ie.  &quot;multipart/encrypted&quot;  parts).  Status  of the decryption
                will be reported (currently only supported  with  --format=json
                Decrypt any MIME encrypted parts found in the selected  content
                (ie.  &quot;multipart/encrypted&quot;  parts).  Status  of the decryption
                will be reported (currently only supported  with  --format=json
-               and --format=sexp) and the multipart/encrypted part will be re-
-               placed by the decrypted content.  Implies --verify.
+               and  --format=sexp)  and  on  successful  decryption the multi-
+               part/encrypted part will be replaced by the decrypted content.
+
+               Decryption expects a functioning <b>gpg-agent</b>(1)  to  provide  any
+               needed credentials. Without one, the decryption will fail.
+
+               Implies --verify.
 
            <b>--exclude=(true|false)</b>
 
 
            <b>--exclude=(true|false)</b>
 
-               Specify whether to omit threads  only  matching  search.tag_ex-
-               clude  from  the search results (the default) or not. In either
-               case the excluded message will be marked with the exclude  flag
-               (except  when  output=mbox  when  there  is  nowhere to put the
+               Specify  whether  to  omit threads only matching search.tag_ex-
+               clude from the search results (the default) or not.  In  either
+               case  the excluded message will be marked with the exclude flag
+               (except when output=mbox when  there  is  nowhere  to  put  the
                flag).
 
                flag).
 
-               If --entire-thread is specified then complete threads  are  re-
+               If  --entire-thread  is specified then complete threads are re-
                turned regardless (with the excluded flag being set when appro-
                turned regardless (with the excluded flag being set when appro-
-               priate) but threads that only match in an excluded message  are
+               priate)  but threads that only match in an excluded message are
                not returned when <b>--exclude=true.</b>
 
                The default is <b>--exclude=true.</b>
 
            <b>--body=(true|false)</b>
 
                not returned when <b>--exclude=true.</b>
 
                The default is <b>--exclude=true.</b>
 
            <b>--body=(true|false)</b>
 
-               If  true  (the default) <b>notmuch</b> <b>show</b> includes the bodies of the
-               messages  in  the  output;  if  false,  bodies   are   omitted.
-               <b>--body=false</b>  is only implemented for the json and sexp formats
+               If true (the default) <b>notmuch</b> <b>show</b> includes the bodies  of  the
+               messages   in   the  output;  if  false,  bodies  are  omitted.
+               <b>--body=false</b> is only implemented for the json and sexp  formats
                and it is incompatible with <b>--part</b> &gt<b>&</b>gt; <b>0.</b>
 
                and it is incompatible with <b>--part</b> &gt<b>&</b>gt; <b>0.</b>
 
-               This is useful if the caller only needs the  headers  as  body-
+               This  is  useful  if the caller only needs the headers as body-
                less output is much faster and substantially smaller.
 
                less output is much faster and substantially smaller.
 
-       A  common  use  of  <b>notmuch</b> <b>show</b> is to display a single thread of email
+       A common use of <b>notmuch</b> <b>show</b> is to display a  single  thread  of  email
        messages. For this, use a search term of &quot;thread:&lt;thread-id&gt;&quot; as can be
        seen in the first column of output from the <b>notmuch</b> <b>search</b> command.
 </pre>
        messages. For this, use a search term of &quot;thread:&lt;thread-id&gt;&quot; as can be
        seen in the first column of output from the <b>notmuch</b> <b>search</b> command.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
+       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),   <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-tag-1/'>not-</a>
+       <a href='../notmuch-tag-1/'>much-tag</a>(1)
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
index cb0df554c33d2ed74c30e8d53a86d7c5826f6070..29a1a8996508bc985b76f7aaa070327b16764690 100644 (file)
@@ -8,7 +8,7 @@
 
 <h2>SYNOPSIS</h2>
 <pre>
 
 <h2>SYNOPSIS</h2>
 <pre>
-       <b>notmuch</b> <b>tag</b> +&lt;<u>tag</u>&gt;|-&lt;<u>tag</u>&gt; [...] [--] &lt;<u>search-term</u>&gt; [...]
+       <b>notmuch</b> <b>tag</b> [<u>options</u>...] +&lt;<u>tag</u>&gt;|-&lt;<u>tag</u>&gt; [...] [--] &lt;<u>search-term</u>&gt; [...]
 
        <b>notmuch</b> <b>tag</b> --batch [ --input=&lt;<u>filename</u>&gt; ]
 </pre>
 
        <b>notmuch</b> <b>tag</b> --batch [ --input=&lt;<u>filename</u>&gt; ]
 </pre>
 
        Supported options for <b>tag</b> include
 
 
        Supported options for <b>tag</b> include
 
+           <b>--remove-all</b>
+
+               Remove all tags from each message  matching  the  search  terms
+               before  applying the tag changes appearing on the command line.
+               This means setting the tags of each message to the tags  to  be
+               added. If there are no tags to be added, the messages will have
+               no tags.
+
            <b>--batch</b>
 
                Read batch tagging operations from a file (stdin  by  default).
            <b>--batch</b>
 
                Read batch tagging operations from a file (stdin  by  default).
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
 <h2>SEE ALSO</h2>
 <pre>
        <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1),
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),   <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-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/'>notmuch-search-terms</a>(7),  <a href='../notmuch-show-1/'>not-</a>
+       <a href='../notmuch-show-1/'>much-show</a>(1),
 </pre>
 
 </pre>
 
-<h2>Notmuch 0.15.2</h2>
+<h2>Notmuch 0.16</h2>
diff --git a/news/release-0.16.mdwn b/news/release-0.16.mdwn
new file mode 100644 (file)
index 0000000..8087161
--- /dev/null
@@ -0,0 +1,111 @@
+[[!meta date="2013-08-03"]]
+
+Notmuch 0.16 (2013-08-03)
+=========================
+
+Command-Line Interface
+----------------------
+
+### Support for delivering messages to Maildir
+
+There is a new command `insert` that adds a message to a Maildir
+folder and notmuch index.
+
+### `notmuch count --batch` option
+
+`notmuch count` now supports batch operations similar to `notmuch
+tag`. This is mostly an optimization for remote notmuch usage.
+
+### `notmuch tag` option to remove all tags from matching messages
+
+`notmuch tag --remove-all` option has been added to remove all tags
+from matching messages. This can be combined with adding new tags,
+resulting in setting (rather than modifying) the tags of the
+messages.
+
+### Decrypting commands explicitly expect a gpg-agent
+
+Decryption in `notmuch show` and `notmuch reply` has only ever
+worked with a functioning gpg-agent. This is now made explicit in
+code and documentation. The functional change is that it's now
+possible to have gpg-agent running, but gpg "use-agent"
+configuration option disabled, not forcing the user to use the agent
+everywhere.
+
+### Configuration file saves follow symbolic links
+
+The notmuch commands that save the configuration file now follow
+symbolic links instead of overwrite them.
+
+### Top level option to specify configuration file
+
+It's now possible to specify the configuration file to use on the
+command line using the `notmuch --config=FILE` option.
+
+### Bash command-line completion
+
+The notmuch command-line completion support for the bash shell has
+been rewritten. Supported completions include all the notmuch
+commands, command-line arguments, values for keyword arguments,
+search prefixes (such as "subject:" or "from:") in all commands that
+use search terms, tags after + and - in `notmuch tag`, tags after
+"tag:" prefix, user's email addresses after "from:" and "to:"
+prefixes, and config options (and some config option values) in
+`notmuch config`. The new completion support depends on the
+bash-completion package.
+
+Deprecated commands "part" and "search-tags" are removed.
+
+Emacs Interface
+---------------
+
+### New keymap to view/save parts; removed s/v/o/| part button bindings
+
+The commands to view, save, and open MIME parts are now prefixed
+with "." (". s" to save, ". v" to view, etc) and can be invoked with
+point anywhere in a part, unlike the old commands, which were
+restricted to part buttons.  The old "s"/"v"/"o"/"|" commands on
+part buttons have been removed since they clashed with other
+bindings (notably "s" for search!) and could not be invoked when
+there was no part button.  The new, prefixed bindings appear in
+show's help, so you no longer have to memorize them.
+
+### Default part save directory is now `mm-default-directory`
+
+Previously, notmuch offered to save parts and attachments to a mix
+of `mm-default-directory`, `mailcap-download-directory`, and `~/`.
+This has been standardized on `mm-default-directory`.
+
+### Key bindings for next/previous thread
+
+Show view has new key bindings M-n and M-p to move to the next and
+previous thread in the search results.
+
+### Better handling of errors in search buffers
+
+Instead of interleaving errors in search result buffers, search mode
+now reports errors in the minibuffer.
+
+### Faster search and show
+
+Communication between Emacs and the notmuch CLI is now more
+efficient because it uses the CLI's S-expression support.  As a
+result, search mode should now fill search buffers faster and
+threads should show faster.
+
+### No Emacs 22 support
+
+The Emacs 22 support added late 2010 was sufficient only for a short
+period of time. After being incomplete for roughly 2 years the code
+in question was now removed from this release.
+
+Vim Front-End
+-------------
+
+The vim based front-end has been replaced with a new one that uses the Ruby
+bindings. The old font-end is available in the contrib subfolder.
+
+Python Bindings
+---------------
+
+Fix loading of libnotmuch shared library on OS X (Darwin) systems.