From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Howard Melman Newsgroups: gmane.emacs.bugs Subject: bug#46627: [PATCH] Add new help command 'describe-command' Date: Sun, 21 Feb 2021 11:39:14 -0500 Message-ID: References: <835z2o4fes.fsf@gnu.org> <83k0r1xwyy.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="993"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (darwin) To: 46627@debbugs.gnu.org Cancel-Lock: sha1:5u5CruwP/TglKPEDQ7pbUoymsJg= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Feb 21 17:41:40 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 1lDrnf-00009Q-Js for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 17:41:39 +0100 Original-Received: from localhost ([::1]:40442 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDrne-00026g-Kw for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 11:41:38 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54930) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDrm6-0001DN-7B for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 11:40:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43125) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDrm5-0000Mo-Qr for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 11:40:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lDrm5-0000A9-OC for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 11:40:01 -0500 X-Loop: help-debbugs@gnu.org In-Reply-To: Resent-From: Howard Melman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Feb 2021 16:40: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 X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.1613925571566 (code B ref -1); Sun, 21 Feb 2021 16:40:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 21 Feb 2021 16:39:31 +0000 Original-Received: from localhost ([127.0.0.1]:54665 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDrlb-000094-3Q for submit@debbugs.gnu.org; Sun, 21 Feb 2021 11:39:31 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:39180) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDrlY-00008u-2d for submit@debbugs.gnu.org; Sun, 21 Feb 2021 11:39:29 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54856) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDrlX-0000df-9J for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 11:39:27 -0500 Original-Received: from ciao.gmane.io ([116.202.254.214]:55526) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDrlV-0008Tq-Ui for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 11:39:27 -0500 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1lDrlR-00084x-2G for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 17:39:21 +0100 X-Injected-Via-Gmane: http://gmane.org/ Received-SPF: pass client-ip=116.202.254.214; envelope-from=geb-bug-gnu-emacs@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 5 X-Spam_score: 0.5 X-Spam_bar: / X-Spam_report: (0.5 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action 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:200505 Archived-At: FWIW since I started using a third party completion package (first helm, then ivy and now selectrum/consult/marginalia) I use apropos far less. I didn't expect that but it's the case for me. I've configured these package so that they show possible completions vertically, one per line, and show annotations. So now when I type M-x I not only see a list of commands I can invoke, but also their keybinding and the first line of their docstring. As I type and narrow the completions this shows me a list of commands related to what I want and even a brief description if the name is not enough. I know that apropos is more featureful and I know how to invoke it easily, but since I use M-x more commonly and it now includes this basic info, my use of C-h a has decreased as its just anothing thing to remember. Also, when I use M-x normally I now get a kind of background appropos happening all the time which gives me a little more discovery. If I search for "register" to find the jump-to-register command I'll see other register commands, and those that are bound stand out a bit. If I'm not in a rush I might scan it to discover other things I didn't know about. This works for me to with C-h v whose annotations show me the current value (in a clipped narrow column) and the first line of the docstring. Also with C-h f. These are not as complete as apropos as they don't match on the docstrings, but they're more interactive and I've found are good enough and apropos is still there if I need it. -- Howard