-The vim based front end to notmuch is deprecated and moved to contrib.
-We haven't been able to support this as well as we would like, and it
-has accumulated bugs and gaps in functionality. We recommend that
-people packaging notmuch no longer provide binary packages for
-notmuch-vim, but of course that is their decision.
+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.
+
+Emacs Interface
+---------------
+
+New keymap to view/save parts
+
+ To view or save a single MIME part of a message, use the new "."
+ submap (e.g., ". s" to save, ". v" to view). Previously, these keys
+ were only available when point was on a part button and they did not
+ have the "." prefix, so they were difficult to invoke (impossible if
+ a part did not have a button) and clashed with other bindings.
+ These new bindings also appear in show's help, so you don't 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`.
+
+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 results
+
+ Communication between search mode 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.
+
+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.
+
+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.