From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#46627: [PATCH] Add new help command 'describe-command' Date: Tue, 02 Mar 2021 07:31:10 +0200 Message-ID: <83h7lu6s0x.fsf@gnu.org> References: <835z2o4fes.fsf@gnu.org> <83k0r1xwyy.fsf@gnu.org> <83blcdxqzy.fsf@gnu.org> <831rd9xox5.fsf@gnu.org> <3801b6be-dd65-c256-6c57-52894fad2b12@yandex.ru> <83pn0tw564.fsf@gnu.org> <83k0r0w2q5.fsf@gnu.org> <83v9acm7bk.fsf@gnu.org> <30bc14e5-febb-aab1-410b-5a56f9fe1843@yandex.ru> <83k0qr8l3y.fsf@gnu.org> <0e909cd9-a123-e5da-a414-0783e52ff2ad@yandex.ru> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22333"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, stefan@marxist.se, rms@gnu.org, 46627@debbugs.gnu.org To: Dmitry Gutov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Mar 02 06:32:14 2021 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 1lGxdm-0005h6-2p for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 02 Mar 2021 06:32:14 +0100 Original-Received: from localhost ([::1]:59272 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGxdk-0003iX-W3 for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 02 Mar 2021 00:32:13 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35056) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lGxda-0003iB-ES for bug-gnu-emacs@gnu.org; Tue, 02 Mar 2021 00:32:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39840) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lGxda-0003Xi-6Z for bug-gnu-emacs@gnu.org; Tue, 02 Mar 2021 00:32:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lGxda-0004ag-1t for bug-gnu-emacs@gnu.org; Tue, 02 Mar 2021 00:32:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 02 Mar 2021 05:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46627 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 46627-submit@debbugs.gnu.org id=B46627.161466309217609 (code B ref 46627); Tue, 02 Mar 2021 05:32:02 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 2 Mar 2021 05:31:32 +0000 Original-Received: from localhost ([127.0.0.1]:51386 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGxd6-0004Zx-82 for submit@debbugs.gnu.org; Tue, 02 Mar 2021 00:31:32 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:45364) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGxd4-0004Zl-BV for 46627@debbugs.gnu.org; Tue, 02 Mar 2021 00:31:30 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:33064) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGxcy-0003Au-La; Tue, 02 Mar 2021 00:31:24 -0500 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:4572 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lGxcn-0004pH-Na; Tue, 02 Mar 2021 00:31:14 -0500 In-Reply-To: <0e909cd9-a123-e5da-a414-0783e52ff2ad@yandex.ru> (message from Dmitry Gutov on Tue, 2 Mar 2021 03:40:02 +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" Xref: news.gmane.io gmane.emacs.bugs:201183 Archived-At: > Cc: larsi@gnus.org, stefan@marxist.se, rms@gnu.org, 46627@debbugs.gnu.org > From: Dmitry Gutov > Date: Tue, 2 Mar 2021 03:40:02 +0200 > > >> All of these (with possible exception of completion.el, which I'm not > >> familiar with) determine how completions are shown and/or how matching > >> is performed, but the total set of completions (completion table) is > >> determined by the command the user invokes. > > > > The completion style does determine the set of candidates, if that's > > the only aspect you are interested in. > > Completion style only determines how completions are matched, but not > the total set of them. That's defined either by the completion table, or > by a completion predicate. Perhaps I'm missing something, but if, for example, you use the 'initials' style, then "lch" can complete to list-command-history, but if you don't use 'initials', it will complete to nothing. So maybe you are right from the implementation POV, but the list of the candidates shown to the user is in fact determined by the style. And that displayed list is what matters for discovery; that Emacs internally had some other list is immaterial. > > I wasn't talking only about describe-command, not even in particular > > about it. I was talking about a much more general issue. If > > describe-command is the only addition, then I have no problems with > > that; I only care if that command is the tip of a much larger iceberg. > > I don't think it's going to be. Then we will be fine. > Even if we wanted, there are only so many free key bindings anyway. And > having more and more commands, bound to different keys, is not actually > something that's going to help a new user get oriented quickly. I agree.