X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=NEWS;h=668281c55008a72dc8531c754401fa77f9f5332d;hp=c0cb3a28750d10ddc293ec114225caf83fc5dc40;hb=0c950146a14fa2bb0a0bf542073b2cdca141afd1;hpb=f1c6e22ee60c6e546315368aa3c3d90be36cd945 diff --git a/NEWS b/NEWS index c0cb3a28..668281c5 100644 --- a/NEWS +++ b/NEWS @@ -1,24 +1,17 @@ -Notmuch 0.13 (2012-xx-xx) +Notmuch 0.13 (2012-05-15) ========================= Command-Line Interface ---------------------- -Reply to sender - - "notmuch reply" has gained the ability to create a reply template - for replying just to the sender of the message, in addition to reply - to all. The feature is available through the new command line option - --reply-to=(all|sender). - JSON reply format - "notmuch reply" can now produce JSON output that contains the headers + `notmuch reply` can now produce JSON output that contains the headers for a reply message and full information about the original message - begin replied to. This allows MUAs to create replies intelligtently. + begin replied to. This allows MUAs to create replies intelligently. For example, an MUA that can parse HTML might quote HTML parts. - Calling notmuch reply with --format=json imposes the restriction that + Calling notmuch reply with `--format=json` imposes the restriction that only a single message is returned by the search, as replying to multiple messages does not have a well-defined behavior. The default retains its current behavior for multiple message replies. @@ -26,24 +19,24 @@ JSON reply format Tag exclusion Tags can be automatically excluded from search results by adding them - to the new 'search.exclude_tags' option in the Notmuch config file. + to the new `search.exclude_tags` option in the Notmuch config file. This behaviour can be overridden by explicitly including an excluded tag in your query, for example: - notmuch search $your_query and tag:$excluded_tag + notmuch search $your_query and tag:$excluded_tag - Existing users will probably want to run "notmuch setup" again to add + Existing users will probably want to run `notmuch setup` again to add the new well-commented [search] section to the configuration file. For new configurations, accepting the default setting will cause the tags "deleted" and "spam" to be excluded, equivalent to running: - notmuch config set search.exclude_tags deleted spam + notmuch config set search.exclude_tags deleted spam Raw show format changes - The output of show --format=raw has changed for multipart and + The output of show `--format=raw` has changed for multipart and message parts. Previously, the output was a mash of somewhat-parsed headers and transfer-decoded bodies. Now, such parts are reproduced faithfully from the original source. Message parts (which includes @@ -54,12 +47,24 @@ Raw show format changes Listing configuration items - The new "config list" command prints out all configuration items and + The new `config list` command prints out all configuration items and their values. Emacs Interface --------------- +Changes to tagging interface + + The user-facing tagging functions in the Emacs interface have been + normalized across all notmuch modes. The tagging functions are now + notmuch-search-tag in search-mode, and notmuch-show-tag in + show-mode. They accept a string representing a single tag change, + or a list of tag changes. See 'M-x describe-function notmuch-tag' + for more information. + + NOTE: This breaks compatibility with old tagging functions, so user + may need to update in custom configurations. + Reply improvement using the JSON format Emacs now uses the JSON reply format to create replies. It obeys @@ -71,29 +76,40 @@ Reply improvement using the JSON format New add-on tool: notmuch-mutt ----------------------------- -The new contrib/ tool "notmuch-mutt" provides Notmuch integration for +The new contrib/ tool `notmuch-mutt` provides Notmuch integration for the Mutt mail user agent. Using it, Mutt users can perform mail search, thread reconstruction, and mail tagging/untagging without leaving Mutt. notmuch-mutt, formerly distributed under the name -"mutt-notmuch" by Stefano Zacchiroli, will be maintained as a notmuch +`mutt-notmuch` by Stefano Zacchiroli, will be maintained as a notmuch contrib/ from now on. Library changes --------------- -The function notmuch_database_close has been split into -notmuch_database_close and notmuch_database_destroy +The API changes detailed below break binary and source compatibility, +so libnotmuch has been bumped to version 3.0.0. + +The function `notmuch_database_close` has been split into +`notmuch_database_close` and `notmuch_database_destroy` This makes it possible for long running programs to close the xapian database and thus release the lock associated with it without destroying the data structures obtained from it. -notmuch_database_open and notmuch_database_create now return errors +`notmuch_database_open`, `notmuch_database_create`, and +`notmuch_database_get_directory` now return errors + + The type signatures of these functions have changed so that the + functions now return a `notmuch_status_t` and take an out-argument for + returning the new database object or directory object. + +Go bindings changes +------------------- + +Go 1 compatibility - The type signatures of notmuch_database_open and - notmuch_database_create have changed so that the functions now - return a notmuch_status_t and take an out-argument for returning the - new database object. + The go bindings and the `notmuch-addrlookup` utility are now + compatible with go 1. Notmuch 0.12 (2012-03-20) =========================