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: Mon, 22 Feb 2021 01:46:50 +0200 Message-ID: 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> 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="16581"; 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 Mon Feb 22 00:48:10 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 1lDySQ-0004CE-6A for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 22 Feb 2021 00:48:10 +0100 Original-Received: from localhost ([::1]:54744 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDySO-000146-Tr for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Feb 2021 18:48:08 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52998) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDySI-00013t-B4 for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 18:48:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43720) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDySI-0008D8-37 for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 18:48:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lDySI-0006Km-1j for bug-gnu-emacs@gnu.org; Sun, 21 Feb 2021 18:48:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Feb 2021 23:48: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.161395122324279 (code B ref 46627); Sun, 21 Feb 2021 23:48:02 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 21 Feb 2021 23:47:03 +0000 Original-Received: from localhost ([127.0.0.1]:55266 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDyRK-0006JW-Nu for submit@debbugs.gnu.org; Sun, 21 Feb 2021 18:47:02 -0500 Original-Received: from mail-wm1-f46.google.com ([209.85.128.46]:51552) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDyRH-0006J1-Vq for 46627@debbugs.gnu.org; Sun, 21 Feb 2021 18:47:01 -0500 Original-Received: by mail-wm1-f46.google.com with SMTP id o82so11920724wme.1 for <46627@debbugs.gnu.org>; Sun, 21 Feb 2021 15:46:59 -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=FPJe6MquCGtELcRaNJvKIuij7aX0PwdkuIL6o60l96c=; b=DU52NLL42baD63HRkYmDDNUKnflt36We8/8yNqeJVcfpDhO1BRTFkfyhPfyfW0o32+ pJ3K98T+tMeOy2+RkzGaRfLCNF2AV0FcOr6nuVO7yhZuNGvLCXxjVNyK8mN/xGB+nwQg 4Pp1rcRwvchgfsZgXmP7/wDnTgZManEfKV6dssUPAcOSvNza5qCCfL4EQ/xDa6tHmnmY kufBMOwm9EeEqWtj2jT14NQPTjCQvXUytN28PDgKPrjrHs0KS+T8LxQgwctiycy/NWM4 GTbgt1Jx/X1HdEONNVX4Rqr/gUuz7oRHB+qnd6rztIlmPWoogwzHPyU+7rQiYyUwqQ+B 55wg== 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=FPJe6MquCGtELcRaNJvKIuij7aX0PwdkuIL6o60l96c=; b=X5Sug/+ft6zzDMJK6qGYj7Ysqgh4OymoMOda7T4m2voQXzZqPrkxFVknZrYZeDa+wz zgM2sUeorp7lOEPWSUSZnnsjaeKqKN8VKQXTZc0AaVSMN48DMc9r5HJLgDUvI2MKyAB/ 6V3xsqEt2rSrAf1Cuc0z5uQkfau+B9a83xNUiZTd03XEnpnQQ4PAR46ugVDVQ1uaeeRG QLWPj2sDq1Pd2LwZeNgmUUf/Kxggop94/aeFDVEc2udT2C7RPi6uQsqTy6co4tmkIpk7 AQsAYjGk2xLNWVvGBxiE+Xmp/ACT+Mc1voTezbfXLYia3OYlYFwMRTsNDWrsfIZgREVG 07cQ== X-Gm-Message-State: AOAM533Ej8Fqm6COnWSMyZbsZb4DFi5VH4hqZ5Px3gmK51zCcrmLfmiA VaVO1KiG75gpPn5yuH9ekqsCTl43NFM= X-Google-Smtp-Source: ABdhPJy02WeT1DJCfjNL3UiTinAlLcpoYmbhEH+HHyXE24jXO4tUK3F4McddbVS39U/Rycbmke8ulQ== X-Received: by 2002:a1c:a98c:: with SMTP id s134mr16149369wme.174.1613951214072; Sun, 21 Feb 2021 15:46:54 -0800 (PST) Original-Received: from [192.168.0.6] ([46.251.119.176]) by smtp.googlemail.com with ESMTPSA id o124sm23743538wmo.41.2021.02.21.15.46.52 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 21 Feb 2021 15:46:53 -0800 (PST) In-Reply-To: <83pn0tw564.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:200534 Archived-At: On 21.02.2021 22:13, Eli Zaretskii wrote: >> I think we've "had it" ever since 'M-x' started providing completion. > And I tried to explain why this is a bad starting point. I think Stefan explained quite well that 'M-x apropos' is very often not an optimal alternative. Nor is this a first discussion about how users discover new functions using completion. It came at least once before when we talked about Elisp function naming and consistency. Saying "Emacs has these functions for doc discovery" is totally fine, but I don't think we can stop there and ignore the current practice among our users, or the experience from other editing environments.