notmuch/doc
Mohsin Kaleem cd89065dc3 emacs: Add new option notmuch-search-hide-excluded
The new notmuch-search-hide-excluded option allows users to configure whether
to show or hide excluded messages (as determined by search.exclude_tags
in the local notmuch config file). It defaults to true for now to maintain
backwards-compatibility with how notmuch-{search,tree} already worked.

New commands notmuch-search-toggle-hide-excluded and
notmuch-tree-toggle-exclude have also been added. They toggle the value
of notmuch-search-hide-excluded for the search in the current search or
tree buffer. It's bound to "i" in the respective keymaps for these
modes.

Lastly I've amended some calls to notmuch-tree and notmuch-unthreaded
which didn't pass through the buffer local value of
notmuch-search-oldest-first (and now notmuch-search-exclude).
Examples of where I've done this include:
  + notmuch-jump-search
  + notmuch-tree-from-search-current-query
  + notmuch-unthreaded-from-search-current-query
  + notmuch-tree-from-search-thread

A new test file for Emacs has been added which covers the usage of the
new `notmuch-search-hide-excluded' option and interactively hiding or
showing mail with excluded tags. These test cover the basic usage of
the `notmuch-search-toggle-hide-excluded' command in notmuch-search,
notmuch-tree and notmuch-unthreaded searches. These tests also cover
the persistence of the current value of the hide-excluded mail option
as a user switches from between these different search commands.

[1]: id:87ilxlxsng.fsf@kisara.moe

Amended-by: db, fix indentation in T461-emacs-search-exclude.sh
2024-04-06 15:03:45 -03:00
..
man1 doc: fix typos 2023-04-13 11:14:58 -03:00
man5 doc: make post-hook description more precise 2022-02-11 13:39:07 -04:00
man7 doc: fix typos 2023-04-13 11:14:58 -03:00
.gitignore Use rooted paths in .gitignore files 2017-08-18 19:42:35 -03:00
command-line.rst doc: reorganize sphinx toctree 2022-07-14 16:31:11 -04:00
conf.py doc: update copyright years to include 2024 2024-03-09 22:47:37 -04:00
doxygen.cfg docs: drop deprecated doxygen TCL_SUBST flag 2021-01-09 11:25:43 -04:00
elisp.py doc/emacs: split index category from label 2022-08-11 07:43:17 -03:00
index.rst doc: drop module index from ToC 2022-07-14 16:31:11 -04:00
INSTALL doc: remove support for rst2man 2015-01-22 08:37:25 +01:00
Makefile doc: convert sphinx based docs 2014-03-09 10:41:08 -03:00
Makefile.local build: clean up __pycache__ directories 2023-09-12 08:07:37 -03:00
notmuch-emacs.rst emacs: Add new option notmuch-search-hide-excluded 2024-04-06 15:03:45 -03:00
python-bindings.rst doc: add new python bindings to main documentation tree. 2020-07-15 08:37:11 -03:00
queries.rst doc: reorganize sphinx toctree 2022-07-14 16:31:11 -04:00