From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id JR00HqybQl+DGAAA0tVLHw (envelope-from ) for ; Sun, 23 Aug 2020 16:39:08 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id wLbnGaybQl8oagAA1q6Kng (envelope-from ) for ; Sun, 23 Aug 2020 16:39:08 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [144.217.243.247]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (2048 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D00F79403A8 for ; Sun, 23 Aug 2020 16:39:05 +0000 (UTC) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 61B2129BF6; Sun, 23 Aug 2020 12:38:57 -0400 (EDT) Received: from jb55.com (unknown [45.79.91.128]) by mail.notmuchmail.org (Postfix) with ESMTPS id EF7F32711E for ; Sun, 23 Aug 2020 12:38:54 -0400 (EDT) Received: from jb55.com (S010660e327dca171.vc.shawcable.net [24.84.152.187]) by jb55.com (OpenSMTPD) with ESMTPSA id 6295263d (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); Sun, 23 Aug 2020 16:39:22 +0000 (UTC) From: William Casarin To: David Bremner , notmuch@notmuchmail.org Cc: Jonas Bernoulli , Teemu Likonen Subject: Re: [PATCH] NEWS: add news entry for tree navigation changes In-Reply-To: <871rjxegrj.fsf@tethera.net> References: <20200822180544.1745-1-jb55@jb55.com> <871rjxegrj.fsf@tethera.net> Date: Sun, 23 Aug 2020 09:38:49 -0700 Message-ID: <875z99fhba.fsf@jb55.com> MIME-Version: 1.0 Message-ID-Hash: Z24OWLPKSGEESSHZ42IXSNLJHXG32X4J X-Message-ID-Hash: Z24OWLPKSGEESSHZ42IXSNLJHXG32X4J X-MailFrom: jb55@jb55.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 144.217.243.247 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Spam-Score: 0.53 X-TUID: HakwvPfvhv32 David Bremner writes: > William Casarin writes: > >> Signed-off-by: William Casarin >> --- >> 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