<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc/notmuch-emacs.rst, branch master</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=master</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=master'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2026-01-24T01:16:07Z</updated>
<entry>
<title>doc/emacs: correct documentation of n-show-forward-message</title>
<updated>2026-01-24T01:16:07Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2026-01-19T09:37:49Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=fcfd5789f418902064de854b1c1a670e365385c7'/>
<id>urn:sha1:fcfd5789f418902064de854b1c1a670e365385c7</id>
<content type='text'>
Commit 3af10307d started a subsection on message level actions, but
the author (yours truly) mistook their customized behaviour for the
default.
</content>
</entry>
<entry>
<title>doc/emacs: start subsection on message level actions</title>
<updated>2025-06-22T19:37:10Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2024-08-14T11:25:25Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=3af10307d954f2e3ca69322748288edf967e3704'/>
<id>urn:sha1:3af10307d954f2e3ca69322748288edf967e3704</id>
<content type='text'>
In particular this gives a place for documenting how to resume editing
drafts.
</content>
</entry>
<entry>
<title>doc/emacs: refactor navigation commands</title>
<updated>2025-06-22T19:36:31Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2024-08-14T11:25:23Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=93539fa5ca54676a41398fb154dabe414795f628'/>
<id>urn:sha1:93539fa5ca54676a41398fb154dabe414795f628</id>
<content type='text'>
The amount of space saved here is minimal, but I want to migrate to a
more topic focused manual, as opposed to long alphabetical lists of
commands.
</content>
</entry>
<entry>
<title>doc/emacs: start a section on notmuch-message-mode</title>
<updated>2025-06-22T19:36:17Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2024-08-14T11:25:22Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=848e7ae6700ffeda9615584868f8207f9f71d394'/>
<id>urn:sha1:848e7ae6700ffeda9615584868f8207f9f71d394</id>
<content type='text'>
This is mostly just copying docstrings, but putting them into sections
makes them more discoverable.
</content>
</entry>
<entry>
<title>emacs: Add new option notmuch-search-hide-excluded</title>
<updated>2024-04-06T18:03:45Z</updated>
<author>
<name>Mohsin Kaleem</name>
<email>mohkale@kisara.moe</email>
</author>
<published>2024-03-10T18:57:41Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=cd89065dc36e36b22a2a53832d2cac9b06fba41c'/>
<id>urn:sha1:cd89065dc36e36b22a2a53832d2cac9b06fba41c</id>
<content type='text'>
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
</content>
</entry>
<entry>
<title>doc: fix typos</title>
<updated>2023-04-13T14:14:58Z</updated>
<author>
<name>Jakub Wilk</name>
<email>jwilk@jwilk.net</email>
</author>
<published>2023-04-13T13:52:11Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=1b878877d928a5279c3c0003d067d8b875f7e42a'/>
<id>urn:sha1:1b878877d928a5279c3c0003d067d8b875f7e42a</id>
<content type='text'>
</content>
</entry>
<entry>
<title>emacs: notmuch-tree-outline-mode</title>
<updated>2023-02-20T12:58:32Z</updated>
<author>
<name>jao</name>
<email>jao@gnu.org</email>
</author>
<published>2022-12-13T02:15:42Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=f63d14a8c12ad76024d2865c0223a06f6f4bb372'/>
<id>urn:sha1:f63d14a8c12ad76024d2865c0223a06f6f4bb372</id>
<content type='text'>
With this mode, one can fold trees in the notmuch-tree buffer as if
they were outlines, using all the commands provided by
outline-minor-mode.  We also define a couple of movement commands
that, optional, will ensure that only the thread around point is
unfolded.

The implementation is based on registering a :level property in the
messages p-list, that is then used by outline-minor-mode to to
recognise headers.

Amended by db: Copy docstring to manual and edit for presentation. Add
two tests. Fix typo "wether".
</content>
</entry>
<entry>
<title>doc/emacs: use define-key instead of hard-coding markup</title>
<updated>2022-08-11T10:48:54Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2022-07-31T11:33:23Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b76f73efe3a97c707b3b14ca41e7748e21938fea'/>
<id>urn:sha1:b76f73efe3a97c707b3b14ca41e7748e21938fea</id>
<content type='text'>
Add keys to index. Allow indexing of both keys and commands. Use
standard typesetting for multiple keybindings.
</content>
</entry>
<entry>
<title>doc/emacs: replace use of emacsvar with el:defcustom</title>
<updated>2022-08-11T10:48:54Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2022-07-31T11:33:22Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=aebf5b6d84d5d59d712cd47c05239ef55b2f5bc3'/>
<id>urn:sha1:aebf5b6d84d5d59d712cd47c05239ef55b2f5bc3</id>
<content type='text'>
Mainly this allows dropping the ad-hoc directive emacsvar
</content>
</entry>
<entry>
<title>doc/emacs: replace emacscmd with el:define-key</title>
<updated>2022-08-11T10:48:54Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2022-07-31T11:33:21Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=0f3b196144e91cd80d321d896c0b4bf6e0c62249'/>
<id>urn:sha1:0f3b196144e91cd80d321d896c0b4bf6e0c62249</id>
<content type='text'>
This allows us to eliminate the ad-hoc emacscmd directive / role, and
improve indexing.

doc/emacs: convert remaining uses of emacscmd to define-key

This allows us to remove the no-longer used object type.
</content>
</entry>
</feed>
