[PATCH] NEWS: add news entry for tree navigation changes

[PATCH] NEWS: add news entry for tree navigation changes

[William Casarin]

Signed-off-by: William Casarin <jb55@jb55.com>
---
 NEWS | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/NEWS b/NEWS
index b25bfaa3..9e635ab6 100644
--- a/NEWS
+++ b/NEWS
@@ -6,6 +6,8 @@ Emacs
 
 The minimum supported major version of GNU Emacs is now 25.1.
 
+Support for moving between threads after notmuch-tree-from-search-thread.
+
 Notmuch-Mutt
 ------------
 
-- 
2.28.0

Re: [PATCH] NEWS: add news entry for tree navigation changes

[David Bremner]

William Casarin <jb55@jb55.com> writes:

> Signed-off-by: William Casarin <jb55@jb55.com>
> ---
>  NEWS | 2 ++
>  1 file changed, 2 insertions(+)
>

Applied to master and release, with a tiny wording change.

I realized when looking at this that I had completely forgotten
notmuch-tree-from-search-thread.  I suspect some of emacs interface is
not as discoverable as we think it is, and it would be worth updating
(not for the upcoming release, but afterwards) doc/notmuch-emacs.rst
with some of the nifty features that have been added since I
optimistically wrote (eb6fb36d)

    This is pretty minimal, but will hopefully inspire others to
    contribute more complete documentation

Re: [PATCH] NEWS: add news entry for tree navigation changes

[William Casarin]

David Bremner <david@tethera.net> writes:

> William Casarin <jb55@jb55.com> writes:
>
>> Signed-off-by: William Casarin <jb55@jb55.com>
>> ---
>>  NEWS | 2 ++
>>  1 file changed, 2 insertions(+)
>>
>
> Applied to master and release, with a tiny wording change.
>
> I realized when looking at this that I had completely forgotten
> notmuch-tree-from-search-thread.  I suspect some of emacs interface is
> not as discoverable as we think it is

Indeed, I only discovered this function after Teemu mentioned[1] it in a
mailing list thread. I've always like the magit docs, maybe we can get
to something like that eventually.

[1] id:87pnhxceoy.fsf@iki.fi

The elisp code has plenty of comments that document each function,
perhaps there could be a way to generate documentation from that? Not
sure how magit does it.

> and it would be worth updating
> (not for the upcoming release, but afterwards) doc/notmuch-emacs.rst
> with some of the nifty features that have been added since I
> optimistically wrote (eb6fb36d)
>
>     This is pretty minimal, but will hopefully inspire others to
>     contribute more complete documentation

Oh good to know! Didn't realize this was a thing.

Cheers,
Will

Re: [PATCH] NEWS: add news entry for tree navigation changes

[David Bremner]

William Casarin <jb55@jb55.com> writes:


> The elisp code has plenty of comments that document each function,
> perhaps there could be a way to generate documentation from that? Not
> sure how magit does it.

We already have the docstrings available in the notmuch-emacs manual,
but they need to be referenced in the rst source.