From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 4O2mIVSQY2FYGAAAgWs5BA (envelope-from ) for ; Mon, 11 Oct 2021 03:16:04 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id aJmIG1SQY2GvDgAAB5/wlQ (envelope-from ) for ; Mon, 11 Oct 2021 01:16:04 +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) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id DE12FB9FF for ; Mon, 11 Oct 2021 03:16:03 +0200 (CEST) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id B49B929071; Sun, 10 Oct 2021 21:15:58 -0400 (EDT) Received: from fethera.tethera.net (fethera.tethera.net [IPv6:2607:5300:60:c5::1]) by mail.notmuchmail.org (Postfix) with ESMTP id 3BEA82906D for ; Sun, 10 Oct 2021 21:15:56 -0400 (EDT) Received: by fethera.tethera.net (Postfix, from userid 1001) id 08A475FD5C; Sun, 10 Oct 2021 21:15:56 -0400 (EDT) Received: (nullmailer pid 1349142 invoked by uid 1000); Mon, 11 Oct 2021 01:15:54 -0000 From: David Bremner To: "Jorge P. de Morais Neto" , notmuch@notmuchmail.org Subject: Re: Notmuch Emacs 0.31.2 documentation and keybinding suggestions In-Reply-To: <878sape5a9.fsf@disroot.org> References: <878sape5a9.fsf@disroot.org> X-List-To: notmuch Date: Sun, 10 Oct 2021 22:15:54 -0300 Message-ID: <87o87ws6np.fsf@tethera.net> MIME-Version: 1.0 Message-ID-Hash: XCODNBTR2FJNMH7Z575VJCKFVRAOQSDJ X-Message-ID-Hash: XCODNBTR2FJNMH7Z575VJCKFVRAOQSDJ X-MailFrom: david@tethera.net 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 CC: Tomi Ollila 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-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1633914964; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=0EgRFEcvAu5sQfq4FZk1HSE8K8tkRAWGZznb4LiKC6c=; b=GC3mlPVr9MM2nNeSUYR1I3c1K9Ij2ytYm5KxwF7ayNN791a3U5YagFJMn97Yq05OvSH5NE 4OAerJYsl06hmAgHfLupgyDxHiOvsLkgfc7LHus8T50Yd/YX3iPZ5iZBBy6rEJ16BE4kMM vRoaCflsH/NY5VPw+Zzehys4yIecmnxOG6cup1HAKaJUQDFvJIv9vK+hdlfyPZn/cKXOZn bQnLGTtX11PwzyuZp/7KQ0ECf0O5wTQBK4xRDnESAxr0IfEz26X43gRfuiN6apbjrJIDD1 f//gfW0Iiwq8BjvMrrdUULZ7TX0MRUNq0GYzCfANWUO8M2eICnntYd0XblWr1w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1633914964; a=rsa-sha256; cv=none; b=U+WK+SPVPJil8rVOzXQa21tYSbAOUAC/iguyhFYgyEpLK4kpJHLW8nE/z3jUw4Vs6O4vfz vZ+nRdLI+QZnQ2d0fUt87gfo9c51qh/iLfn/ZQ8jrCG0oXHhQeGdRTgXLco7xogW7NcNRK mwhBzAOBqz1InLL710ch49hGSF0DYDwWhpikrIPhs6zjqU4J9tQh0+IQUekNwq+HJYZlPT rWcm++sRyj0P5K7JNo20QuN/lU1lZLA6L0k0HEOmZT+ZPmcd2NearwQmpmFFtL0J9mL3ok 1awRyg/XP9FXiLgXsT86Uc2xSal03heRe1HCNtOIDpqb85kFbPvtGDD6OPtonQ== ARC-Authentication-Results: i=1; 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-Migadu-Spam-Score: -2.18 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-Migadu-Queue-Id: DE12FB9FF X-Spam-Score: -2.18 X-Migadu-Scanner: scn0.migadu.com X-TUID: Q6m4BAmsS8I4 "Jorge P. de Morais Neto" writes: > Hi. I would like to report the following documentation and keybinding > imperfections: > > The info page > [[info:notmuch-emacs.info#notmuch-hello key bindings]] says that > moves to the previous widget, but that key is actually bound > to `delete-backward-char'. Apparently Tomi "corrected" to in 703dec7754da477b. > To move to the previous widget I use > or . On the other hand, the keybinding in the code is to "C-", which explains the above. To really be , it should be S-tab. > And why does move backward but > (which ought to be equivalent to , no?) moves forward? You'd think they'd be equivalent, but actually they are not. You can use C-h k to test, even in a GUI/X11 emacs. > Also, it seems that moves forward and moves backward, but > does nothing useful. For consistency with Emacs Info Mode, > Emacs View Mode, and some other applications such as Firefox, perhaps > should move backward too. I note that S-SPC is not accesible in terminals. But if there's concensus that is is useful I don't mind adding it. > The introduction of help buffer for Notmuch-Show (reached by hitting > ) describes the command without mentioning that it can archive > the thread; only in specific description (which does not fit in > the same window; one has to scroll) does it mention the archiving > behavior. I believe the archiving behavior should also be mentioned in > the introduction, lest the user unwittingly archive a thread she wasn't > supposed to. I personally don't think archiving is that destructive, if someone wants to improve this wording, it is the docstring for notmuch-show-mode > Also, the description for is empty (this also happens > in the help buffer for Notmuch-Hello). Yes, that's a bug as the function "notmuch-unthreaded" lacks a docstring. I think the original author of that code doesn't use emacs anymore, so someone else is welcome to contribute one. > In the same help buffer, the description of says "Show help for a > subkeymap." Would it not be better to drop the "a", leaving "Show help > for subkeymap." ? This is the docstring for notmuch-subkeymap-help. In that context I think it's better with the "a". > Finally, the binding for in Notmuch-Show and Notmuch-Hello > inconveniently clobbers the tab-bar-mode binding for that key. Should > not Notmuch be content with // (and > possibly ) and leave alone? > Notmuch has used the binding since 2010 (almost 10 years before tab-bar-mode existed), so people might be used to it; on other hand it does seem redundant since the binding S-tab is also there. I'm not a very serious user of notmuch-hello mode, and I don't use tab-bar-mode at all, so I'd welcome feedback from other people about how attached they are to C-tab.