git.cworth.org Git - notmuch-wiki/blob - news/release-0.21.mdwn

   1 [[!meta date="2015-10-29"]]
   2
   3 Notmuch 0.21 (2015-10-29)
   4 =========================
   5
   6 General
   7 -------
   8
   9 Notmuch now requires gmime >= 2.6.7. The gmime 2.4 series is no longer
  10 supported.
  11
  12 ### Database revision tracking: `lastmod:` queries
  13
  14 Each message now has a metadata revision number that increases with
  15 every tagging operation. See the discussion of `lastmod:` in
  16 `notmuch-search-terms(7)` for more information.
  17
  18 ### Date queries now support `date:<expr>..!` shorthand for `date:<expr>..<expr>`
  19
  20 You can use, for example, `date:yesterday..!` to match from the
  21 beginning of yesterday to the end of yesterday. For further details,
  22 please refer to the `notmuch-search-terms` manual page.
  23
  24 ### Notmuch database upgrade to support `lastmod:` queries
  25
  26 The above mentioned `lastmod:` prefix. This will be done
  27 automatically, without prompting on the next time `notmuch new` is
  28 run after the upgrade. The upgrade is not reversible, and the
  29 upgraded database will not be readable by older versions of
  30 Notmuch. As a safeguard, a database dump will be created in the
  31 `.notmuch` directory before upgrading.
  32
  33 Build System
  34 ------------
  35
  36 The ruby bindings are now built as part of the main notmuch build
  37 process. This can be disabled with the `--without-ruby` option to
  38 configure.
  39
  40 Building the documentation can be disabled with the `--without-docs`
  41 option to configure.
  42
  43 Skipped individual tests are no longer considered as failures.
  44
  45 Command Line Interface
  46 ----------------------
  47
  48 ### Database revision tracking
  49
  50 Two new options were added to support revision tracking. A global
  51 option "--uuid" (`notmuch(1)`) was added for to detect counter
  52 rollover and reinitialization, and `notmuch-count(1)` gained a
  53 `--lastmod` option to query database revision tracking data.
  54
  55 ### The `notmuch address` command supports new deduplication schemes
  56
  57 `notmuch address` has gained a new `--deduplicate` option to specify
  58 how the results should be deduplicated, if at all. The alternatives
  59 are `no` (do not deduplicate, useful for processing the results with
  60 external tools), `mailbox` (deduplicate based on the full, case
  61 sensitive name and email address), and `address` (deduplicate based
  62 on the case insensitive address part). See the `notmuch-address`
  63 manual page for further information.
  64
  65 Emacs Interface
  66 ---------------
  67
  68 ### `notmuch-emacs-version` is used in `User-Agent` header
  69
  70 The value of recently introduced variable `notmuch-emacs-version` is
  71 now used as a part of `User-Agent` header when sending emails.
  72
  73 ### Removed `notmuch-version` function by renaming it to `notmuch-cli-version`
  74
  75 With existing variable `notmuch-emacs-version` the accompanied
  76 function which retrieves the version of `notmuch-command` is
  77 better named as `notmuch-cli-version`.
  78
  79 ### Query input now supports completion for "is:<tag>"
  80
  81 ### New message composition mode: `notmuch-compose-mode`
  82
  83 This is mainly to fix fcc handling, but may be useful for user
  84 customization as well.
  85
  86 ### Allow filtering of search results in `notmuch-show`
  87
  88 ### Add function to rerun current tree-view search in search mode
  89
  90 ### Bug fix for replying to encrypted messages in `notmuch-tree` mode
  91
  92 ### Allow saved searched to specify tree view rather than search view
  93
  94 Applies to saved searches run from `notmuch-hello`, or by a keyboard
  95 shortcut (`notmuch-jump`).  Can be set in the customize interface, or
  96 by adding :search-type tree to the appropriate saved search plist in
  97 `notmuch-saved-searches`.
  98
  99 ### Increase maximum size of rendered text parts
 100
 101 The variable `notmuch-show-max-text-part-size` controls the maximum
 102 size (in bytes) which is automatically rendered. This may make
 103 rendering large threads slower. To get the previous behaviour set
 104 this variable to 10000.
 105
 106 Library
 107 -------
 108
 109 ### The use of absolute paths is now enforced when calling `notmuch_database_{open, create}`
 110
 111 ### New function `notmuch_directory_delete` to delete directory documents
 112
 113 Previously there was no way to delete directory documents from the
 114 database, leading to confusing results when the "ghost" directory
 115 document of a renamed or deleted filesystem directory was
 116 encountered every time the parent directory was being scanned by
 117 `notmuch new`. The mtime of the old directory document was also used
 118 if a directory by the same name was added again in the filesystem,
 119 potentially bypassing the scan for the directory. The issues are
 120 fixed by providing a library call to delete directory documents, and
 121 deleting the old documents in `notmuch new` on filesystem directory
 122 removal or rename.
 123
 124 ### Database revision tracking
 125
 126 Revision tracking is supported via a new prefix "lastmod:" in the
 127 query parser and the new function
 128 `notmuch_database_get_revision`. For the latter, see `notmuch(3)`.
 129
 130 ### New status code returning API for n_query_count_{messages,threads}
 131
 132 ### Deprecated functions
 133
 134 `notmuch_query_search_threads`, `notmuch_query_search_messages`,
 135 `notmuch_query_count_messages`, and `notmuch_query_count_threads`
 136 are all deprecated as of this release.  Clients are encouraged to
 137 transition to the `_st` variants supporting better error reporting.
 138
 139 nmbug-status
 140 ------------
 141
 142 `nmbug-status` now supports specifying the sort order for each view.