notmuch/emacs/notmuch.el, branch 0.30

emacs docstrings: consistent indentation, newlines, periods

2020-06-06T10:55:58Z

Fixed emacs docstrings to be consistent. No functional change. - removed some (accidental) indentation - removed some trailing newlines - added trailing periods where missing (some exclusions)

emacs: Respect `load-prefer-newer` when loading `notmuch-init-file'

2020-06-01T10:52:28Z

Before this change, `load-prefer-newer' was ignored. Set NOERROR and MUST-SUFFIX arguments of `load' to t, and NOSUFFIX argument to nil, to preserve the behaviour of the deleted `let' form.

emacs: Use `cl-lib' instead of deprecated `cl'

2020-04-27T10:36:10Z

Starting with Emacs 27 the old `cl' implementation is finally considered obsolete. Previously its use was strongly discouraged at run-time but one was still allowed to use it at compile-time. For the most part the transition is very simple and boils down to adding the "cl-" prefix to some symbols. A few replacements do not follow that simple pattern; e.g. `first' is replaced with `car', even though the alias `cl-first' exists, because the latter is not idiomatic emacs-lisp. In a few cases we start using `pcase-let' or `pcase-lambda' instead of renaming e.g. `first' to `car'. That way we can remind the reader of the meaning of the various parts of the data that is being deconstructed. An obsolete `lexical-let' and a `lexical-let*' are replaced with their regular variants `let' and `let*' even though we do not at the same time enable `lexical-binding' for that file. That is the right thing to do because it does not actually make a difference in those cases whether lexical bindings are used or not, and because this should be enabled in a separate commit. We need to explicitly depend on the `cl-lib' package because Emacs 24.1 and 24.2 lack that library. When using these releases we end up using the backport from GNU Elpa. We need to explicitly require the `pcase' library because `pcase-dolist' was not autoloaded until Emacs 25.1.

emacs: introduce notmuch-search-by-tag

2020-04-14T15:29:31Z

This is like notmuch-search-filter-by-tag, but creates a new search rather than filtering the current search. We add this to notmuch-common-keymap since this can be used by many contexts. We bind to the key "t", which is the same key used by notmuch-search-filter-by-tag in notmuch-search-mode-map. This is done intentionally since the keybinding for notmuch-search-mode-map can be seen as a specialization of creating a new search. This change was motivated for use in "notmuch-hello". It is a more convenient way to search a tag than expanding the list of all tags. I also noticed many saved searches people use are simply tags.

Add a U binding to switch to unthreaded from other views

2020-03-20T01:07:51Z

We have shortcuts S and Z to let the user switch to Search view and Tree view with the current search. Add U to let the user switch to unthreaded view from the current search, and ensure that S and Z switch from unthreaded to search and tree veiew respectively.

emacs: bind M-RET to notmuch-tree-from-search-thread

2019-12-03T11:43:36Z

This is an unbound function that is quite useful. It opens a selected thread in notmuch-tree from the current search query. Signed-off-by: William Casarin

emacs: Move notmuch-search-interactive-region to notmuch-lib as notmuch-interactive-region

2019-05-07T09:31:19Z

emacs: filter tag completions by current query

2018-12-07T01:22:40Z

When filtering by tags in notmuch-search-filter-by-tag, only return tags related to the current query. Before, it was returning all tags. There's no reason to refine the current query with tags that don't exist in the current result set. Signed-off-by: William Casarin

emacs: escape quote in docstring

2018-10-21T13:30:51Z

This prevents emacs from turning it into a fancy, non-evaluable docstring (and also makes it easier to deal with during extraction to sphinx).

emacs: Add commentary for MELPA users

2017-07-20T10:01:17Z

We have a steady trickle of people using notmuch-emacs from melpa with distro packages of notmuch, and then being confused when it doesn't work. Try to warn people what a foot-gun this is; this commentary should be copied to the melpa web site.