From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#46627: [PATCH] Add new help command 'describe-command' Date: Sun, 21 Feb 2021 01:17:55 -0600 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="28989"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 46627@debbugs.gnu.org To: rms@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Feb 21 08:19:11 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 1lDj1L-0007Ob-Cg for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 08:19:11 +0100 Original-Received: from localhost ([::1]:35944 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDj1K-0003CG-Ej for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 02:19:10 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50900) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDj1C-0003Bp-Ng for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 02:19:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41915) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDj1C-0006mx-GA for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 02:19:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lDj1C-0006Yj-BW for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 02:19:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Feb 2021 07:19: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.161389188525121 (code B ref 46627); Sun, 21 Feb 2021 07:19:02 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 21 Feb 2021 07:18:05 +0000 Original-Received: from localhost ([127.0.0.1]:53458 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDj0G-0006X4-FL for submit@debbugs.gnu.org; Sun, 21 Feb 2021 02:18:04 -0500 Original-Received: from mail-pl1-f180.google.com ([209.85.214.180]:42404) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDj0E-0006WW-2s for 46627@debbugs.gnu.org; Sun, 21 Feb 2021 02:18:03 -0500 Original-Received: by mail-pl1-f180.google.com with SMTP id s16so5712612plr.9 for <46627@debbugs.gnu.org>; Sat, 20 Feb 2021 23:18:02 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc; bh=hqAAk+rP+Qm4y5elrStabyTffPCDfSV9ylPrNNoIRo4=; b=ECXjoGr618V1+4W6W4+JPbMQebx3TggWhDpfpFldkFvGruFkjCoHv3NT+ICYd5pjZ3 kyTbCCucKi1cLgSnIpGi792xO9NPLCc1CwQsl6VXBAtIdvdXz1CtumgZf4gxwMiDG8Td 3i29kO4j7OlIShjcC4CWkVQQ4xs40V66vzv+GhF+eWxs8UEIV7ANGHOfcFvtgAwjrXvA NuLyF8PBe9U9tS6CrI2+OzcmqpFf7J7BlSC/cR3F5P5pnS96QuRB0Fd2dv8yD2sw3cl3 ed9wkmMu+SeytD1933Vjtw0UhHzWsBX9xZM8Ty00Y58Yxtj0mK2h8JGaJoMLZ/mcQ4BO hGEA== X-Gm-Message-State: AOAM532G046AsY28edpD+UC1/+sqf1D/pyUp4BF3DqwOHb5S4r+1vuKJ EjMq+YNPjKe2HEqblEdVQDsYaB5SqxN6Fz0uE9z6r5kX X-Google-Smtp-Source: ABdhPJylDnOXDd5vpgxnKlS5HIzN2l/X3JEZIAYCOanfWoUldpNMgAjtHkrgbNS88OdTyuPwCgy8beaQyQLW/3s9+7A= X-Received: by 2002:a17:90a:bd84:: with SMTP id z4mr17016680pjr.179.1613891876242; Sat, 20 Feb 2021 23:17:56 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 21 Feb 2021 01:17:55 -0600 In-Reply-To: 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:200478 Archived-At: Richard Stallman writes: > > It would be like `describe-function' but show only commands. > > Are you perhaps talking about limiting the candidates for completion? Yes. > If the only difference between these commands is completion of the > argument, here's an idea. > > * Make TAB and ?, when a completion list is displayed, toggle the > completion mode between commands-only and all-functions. > > * Arrange a way to show on the screen which completion mode is in use. > Perhaps in the completions list buffer. > > * Make C-h f start out with completion in commands-only mode. That > will be good for beginners. If you want to complete a noninteractive > function name, toggle the completion mode. > > This interface involves no new commands, and no new bindings, and it > is easy to discover. To me, it certainly sounds more complicated to learn, and harder to use, than just having two separate commands. If your concern is complexity, the above is the more complex UI. Just compare the above explanation with this: - `C-h f' for any function - `C-h x' for commands Also, the patch is really not that big.