From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id E7ILCBGzrGFvNgAAgWs5BA (envelope-from ) for ; Sun, 05 Dec 2021 13:39:45 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id kL0JAxGzrGFOaAAAB5/wlQ (envelope-from ) for ; Sun, 05 Dec 2021 12:39:45 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [IPv6:2607:5300:201:3100::1657]) (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 CD516F3CE for ; Sun, 5 Dec 2021 13:39:44 +0100 (CET) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id DBDAA26EB1; Sun, 5 Dec 2021 07:39:39 -0500 (EST) Received: from fethera.tethera.net (fethera.tethera.net [IPv6:2607:5300:60:c5::1]) by mail.notmuchmail.org (Postfix) with ESMTP id 76BCB26993 for ; Sun, 5 Dec 2021 07:39:36 -0500 (EST) Received: by fethera.tethera.net (Postfix, from userid 1001) id 657B05FC42; Sun, 5 Dec 2021 07:39:36 -0500 (EST) Received: (nullmailer pid 687524 invoked by uid 1000); Sun, 05 Dec 2021 12:39:35 -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> Date: Sun, 05 Dec 2021 08:39:35 -0400 Message-ID: <87o85vql88.fsf@tethera.net> MIME-Version: 1.0 Message-ID-Hash: PJCJZRGCIO5L74K5UEH7VL4LDKEYZTHG X-Message-ID-Hash: PJCJZRGCIO5L74K5UEH7VL4LDKEYZTHG 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; digests; suspicious-header X-Mailman-Version: 3.3.3 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN X-Migadu-Country: FR ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1638707984; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to: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-owner:list-unsubscribe:list-subscribe:list-post; bh=1FWLXVuSKoeKFr33nWxGgghf5NNkBfjkXJD0w0tq1D8=; b=dejigJQDsXFKcTc1cUn9S1csHPYRBKQQKuXDmD/oKYzOIv/UfqXP5m65U3SzfHprY2RRS7 BmF2/f2MLxZceWM1hNZFsNP1exm/DC1ovRLCjIh/xX+Blcki+w0H1UL3Wnwal0TI2we4kV 35YpqC6wT7Wz1sL/hAg8tCpiAVoqXO0xim2NK1zHOSSRAlRtHBTumzG/rYAL9SYlxx/tsp Y6B+eIbpd6+3HTwxRBS9UJEA6tMOm3eb2kRUX4tPRC0AUpPmAqZvJ9KkmbFLpqX6KHy0n4 kDsn+kpKu2IaFIl+4chRJirX+VsMLYxg7Rv1XVtC1Mb7iJ1e4IQwcAWEzPrSYw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638707984; a=rsa-sha256; cv=none; b=EGPxhe1OmGTkbF8hqQgi1i4RNn4aT45V4+fzmRUkiLikUM8YDe1TREXAVGwGLkQHuA913V C7ztzXvfgnQm68jLptULiGH+IyzasW8CNG/Vc0dwnsXAJxs9vH1H/bqM1sHPZKhCqJUfbk 8+VTHzqBdaEz0vjjUwFeUjzdUvHOmpCvRcuYLhJkUzmDhl94oR2BD/AJSMx9WGyLWImqCl RvAdmEdQf6BnZgHnMQxWRMUEa6M2bRDGcFQKEhjcX9k3q7+Ef78E4bP7yVvNvGQjXc1W+L zJLWEGctWPj8okxr8C45WiQBv2ST3bRBPWv7rWSJi1MZubXsLjiOkxSt5hbEEA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: -1.99 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: CD516F3CE X-Spam-Score: -1.99 X-Migadu-Scanner: scn0.migadu.com X-TUID: yGqNYLOiYZbQ "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'. To move to the previous widget I use > or . And why does move backward but > (which ought to be equivalent to , no?) moves forward? > > 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. > > 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. Also, the description for is empty (this also happens > in the help buffer for Notmuch-Hello). > > 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." ? > > 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? > I think I've fixed all I'm going to in 0.34.1-37-gc0115288 (should be part of 0.35). If you think there are specific things that important and still unresolved, please send one message per issue, it's much easier to keep track of that way. d