From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#46627: [PATCH] Add new help command 'describe-command' Date: Tue, 2 Mar 2021 03:40:02 +0200 Message-ID: <0e909cd9-a123-e5da-a414-0783e52ff2ad@yandex.ru> 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> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33409"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 Cc: larsi@gnus.org, stefan@marxist.se, rms@gnu.org, 46627@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Mar 02 02:41:48 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 1lGu2d-0008KI-2M for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 02 Mar 2021 02:41:39 +0100 Original-Received: from localhost ([::1]:56842 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGu2b-0001kf-Kj for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Mar 2021 20:41:37 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38366) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lGu24-0001kT-NF for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 20:41:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39713) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lGu21-00015q-Uz for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 20:41:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lGu21-0007fd-TC for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 20:41:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 02 Mar 2021 01:41: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.161464921429420 (code B ref 46627); Tue, 02 Mar 2021 01:41:01 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 2 Mar 2021 01:40:14 +0000 Original-Received: from localhost ([127.0.0.1]:51259 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGu1G-0007eS-Hb for submit@debbugs.gnu.org; Mon, 01 Mar 2021 20:40:14 -0500 Original-Received: from mail-wr1-f46.google.com ([209.85.221.46]:37175) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGu1E-0007eB-R9 for 46627@debbugs.gnu.org; Mon, 01 Mar 2021 20:40:13 -0500 Original-Received: by mail-wr1-f46.google.com with SMTP id v15so18159366wrx.4 for <46627@debbugs.gnu.org>; Mon, 01 Mar 2021 17:40:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=dNbKRN81VDIsYOnJ09icr/c7YPKOoRf5W5CQGODcMA4=; b=jpNOstnDKvQ8lzb7zQ0cWupF7NtueVGh89PelXw2t+zAp16j0sqzPfbxetIiryp0PJ G+sl2kzJtII+BhB+SRrj1sG/JeiqDvFn4nke0b2qjQedocFs8hZXaP1+ZiEwMnpHNWS9 U96ChcTvfU1Ng6uNkisG5JrSd4TX+eIFmw4XABVPbY+b+Qm/xDUwc5IkwFQJKXMS3lnx 0eYpbsTkYIaJsFg6PzC8kDcsoc6E/N69124xaffom4oqerPJxE4IUsMT+5da/A1jNaCx R0eLB8mjtei4toLq58mN7vNkde0OGVOiq5a39me7SpXnpq/khBTsLBX444b6fvRxU980 B8jA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:subject:to:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=dNbKRN81VDIsYOnJ09icr/c7YPKOoRf5W5CQGODcMA4=; b=tIdtPfcAS9m8hTosVBWF1lTgYZBSxQRhO1c5FQ9TsMvbbyujoLP8A+rkcVI7Hptuqc oA4/Hoj/Uw2YgifaWQ3dVfTuM/be6o9v5USnh4pWZKMEE4GIsHjwKEaKhUcLSjBczym7 buVd7HIpZhHEStGgQodwY4n1ou2iCcLkGWCuWZng2i7afkhS3bT8mNcSa04sU1vHrYEK mlPU/kyObYoAv/aPHY9uQrnUUWnWUeZnnT5Aqgsb6IKcu9E5ID+uspVlk65FkZ7/ZGyK uf9xbZpCopdT+TGm0MlvVL/VDcVhxiVKr9NCgns29ZVhITEoYPs7Egi5WKgfcAklNZ3c M7Dw== X-Gm-Message-State: AOAM530YmQwAtS4sWu1u7A2pIyuWSoashR200Q0cP49F5XVauUPn9nHD 2cxE56qpSAVEz5XyznMnoeLm4P0Tfj4= X-Google-Smtp-Source: ABdhPJzJf+He+3aRqwfWULCmoWNQE+eWuCeVIT3UB9I3LD1fdPA2qMFDibfnLuRPcKlnQXrUhjjSbQ== X-Received: by 2002:a5d:4ac4:: with SMTP id y4mr19298623wrs.86.1614649207027; Mon, 01 Mar 2021 17:40:07 -0800 (PST) Original-Received: from [192.168.0.6] ([46.251.119.176]) by smtp.googlemail.com with ESMTPSA id g11sm15031755wrw.89.2021.03.01.17.40.05 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 01 Mar 2021 17:40:06 -0800 (PST) In-Reply-To: <83k0qr8l3y.fsf@gnu.org> Content-Language: en-US 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:201179 Archived-At: On 01.03.2021 08:05, Eli Zaretskii wrote: >>>> Do you have in mind some particular "completion alternative we have >>>> already" for 'describe-command'? >>> >>> icomplete.el, completion.el, pcomplete.el, and the non-default styles >>> in completion-styles-alist come to mind. >> >> 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. > And the way the candidates are > presented is an important part of how easy and user-friendly discovery > is. Of course. >> So they don't include anything that looks like a replacement for >> 'describe-command'. > > 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. 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.