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: Sun, 21 Feb 2021 20:21:10 +0200 Message-ID: <831rd9xox5.fsf@gnu.org> References: <835z2o4fes.fsf@gnu.org> <83k0r1xwyy.fsf@gnu.org> <83blcdxqzy.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="34884"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, rms@gnu.org, 46627@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Feb 21 19:22:12 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 1lDtMy-0008xu-CC for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 19:22:12 +0100 Original-Received: from localhost ([::1]:34040 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDtMx-00083H-Db for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 13:22:11 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44890) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDtMo-00080K-BW for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 13:22:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43256) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDtMo-0004nL-2b for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 13:22:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lDtMn-0002cs-S2 for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 13:22:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Feb 2021 18:22:01 +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.161393170510071 (code B ref 46627); Sun, 21 Feb 2021 18:22:01 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 21 Feb 2021 18:21:45 +0000 Original-Received: from localhost ([127.0.0.1]:54802 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDtMX-0002cN-7c for submit@debbugs.gnu.org; Sun, 21 Feb 2021 13:21:45 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:55188) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDtMU-0002cA-Pw for 46627@debbugs.gnu.org; Sun, 21 Feb 2021 13:21:44 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:39360) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDtMP-0004bh-C2; Sun, 21 Feb 2021 13:21:37 -0500 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2995 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lDtMD-00052g-Mb; Sun, 21 Feb 2021 13:21:29 -0500 In-Reply-To: (message from Stefan Kangas on Sun, 21 Feb 2021 12:02:20 -0600) 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:200520 Archived-At: > From: Stefan Kangas > Date: Sun, 21 Feb 2021 12:02:20 -0600 > Cc: rms@gnu.org, larsi@gnus.org, 46627@debbugs.gnu.org > > Eli Zaretskii writes: > > > No, I think you are splitting hair. Typing one more key justifies a > > whole new command? Really? > > Wait, are you now arguing against `C-h x'? No, if I wanted to argue against it, I'd do it before it was installed. I don't mind the command, although I personally will probably never use it. I'm arguing against the tendency to introduce a whole new discovery framework based on completion. I think Emacs doesn't need that in core; whoever wants something like that, can use one of the many packages out there which implement every possible completion paradigm under the sun. We as the core development team should not invest any significant energy in developing such framework, but should instead improve and enhance what we already have. For example, the apropos commands could perhaps benefit from taking some context into account, like the current major mode and the previous apropos searches, and improve accuracy using that. IOW, my problem is not "C-h x", it's that "C-h x" and its ilk is or will be seen as the beginning of a discovery framework that we will now actively develop. > > Displaying completion candidates doesn't use any screen estate? > > It uses more screen estate to display documentation than to just display > the command name. Completion doesn't just display a single command name, it displays a list, which typically takes more than one screen line.