From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#61183: 29.0.60; Add describe-repeat-maps to the manual Date: Wed, 01 Feb 2023 20:06:08 +0200 Organization: LINKOV.NET Message-ID: <86y1ph6z1r.fsf@mail.linkov.net> References: <86pmawgl17.fsf@mail.linkov.net> <838rhj52en.fsf@gnu.org> <86tu07evv6.fsf@mail.linkov.net> <83y1pj3m4z.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27903"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) Cc: 61183@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Feb 01 19:09:18 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pNHXp-00078z-Mw for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 01 Feb 2023 19:09:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pNHXd-0001bC-4a; Wed, 01 Feb 2023 13:09:05 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pNHXb-0001ae-T8 for bug-gnu-emacs@gnu.org; Wed, 01 Feb 2023 13:09:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pNHXa-0000FK-BI for bug-gnu-emacs@gnu.org; Wed, 01 Feb 2023 13:09:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pNHXZ-00067Q-QF for bug-gnu-emacs@gnu.org; Wed, 01 Feb 2023 13:09:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 01 Feb 2023 18:09:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 61183 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 61183-submit@debbugs.gnu.org id=B61183.167527491023478 (code B ref 61183); Wed, 01 Feb 2023 18:09:01 +0000 Original-Received: (at 61183) by debbugs.gnu.org; 1 Feb 2023 18:08:30 +0000 Original-Received: from localhost ([127.0.0.1]:59800 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pNHX4-00066c-Ap for submit@debbugs.gnu.org; Wed, 01 Feb 2023 13:08:30 -0500 Original-Received: from relay1-d.mail.gandi.net ([217.70.183.193]:36041) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pNHX0-00066B-NG for 61183@debbugs.gnu.org; Wed, 01 Feb 2023 13:08:29 -0500 Original-Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 2EE6E240007; Wed, 1 Feb 2023 18:08:19 +0000 (UTC) In-Reply-To: <83y1pj3m4z.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 30 Jan 2023 20:36:28 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:254593 Archived-At: >> >> +navigate @code{next-error} matches, @kbd{C-x ] ] [ [} to navigate >> >> +through pages, and other listed in @code{describe-repeat-maps}. >> > >> > "and other commands", I presume? >> >> This is what I already tried, but noticed that it's talking about >> key sequences. But "other key sequences" looks awkward too. > > "Other key sequences" sounds OK to me. > >> > Also, saying that commands are "listed in" a function sounds >> > awkwardly; I guess you meant in the window shown by >> > describe-repeat-maps instead? >> >> Maybe simply "listed by describe-repeat-maps"? > > Also works. Pushed. >> Its output is easy to understand for anyone who uses this feature >> and just wants to check what commands are already supported. > > That's not the correct criterion for judging documentation, definitely > not when the manual is concerned. The manual should be clear enough > to explain the command's effect even to someone who reads about > repeated commands for the first time. > > And even if you only consider experienced users, how can a user > understand that these commands support repeating? Which part(s) of > that buffer say that in terns that are clear enough? A naïve reader > of the buffer will just see a list of commands and their bindings, > preceded by a sentence whose intent is hard to understand without some > background in Emacs keymaps. Maybe this should be explained in the docstring of describe-repeat-maps.