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: Thu, 18 Feb 2021 17:06:16 -0800 Message-ID: Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="00000000000031267705bba60fb0" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9860"; mail-complaints-to="usenet@ciao.gmane.io" To: 46627@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Feb 19 02:07: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 1lCuGF-0002SW-7c for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 19 Feb 2021 02:07:11 +0100 Original-Received: from localhost ([::1]:50636 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lCuGD-0004MN-OR for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 18 Feb 2021 20:07:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48472) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lCuG6-0004Lf-Ib for bug-gnu-emacs@gnu.org; Thu, 18 Feb 2021 20:07:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36928) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lCuG6-0006n9-BO for bug-gnu-emacs@gnu.org; Thu, 18 Feb 2021 20:07:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lCuG6-0006Lo-6h for bug-gnu-emacs@gnu.org; Thu, 18 Feb 2021 20:07: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: Fri, 19 Feb 2021 01:07:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 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.161369678324365 (code B ref -1); Fri, 19 Feb 2021 01:07:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 Feb 2021 01:06:23 +0000 Original-Received: from localhost ([127.0.0.1]:48474 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lCuFS-0006Ku-Um for submit@debbugs.gnu.org; Thu, 18 Feb 2021 20:06:23 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:52246) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lCuFR-0006Kn-6R for submit@debbugs.gnu.org; Thu, 18 Feb 2021 20:06:21 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48422) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lCuFQ-0004Hj-Vg for bug-gnu-emacs@gnu.org; Thu, 18 Feb 2021 20:06:21 -0500 Original-Received: from mail-pj1-f41.google.com ([209.85.216.41]:37345) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lCuFP-0006U8-0d for bug-gnu-emacs@gnu.org; Thu, 18 Feb 2021 20:06:20 -0500 Original-Received: by mail-pj1-f41.google.com with SMTP id t2so3117883pjq.2 for ; Thu, 18 Feb 2021 17:06:18 -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:mime-version:date:message-id:subject:to; bh=+H7zgs9TUHGGKyqarPLS2y5W05WPLn09svT8X6OH4c4=; b=g0AZElLBo/lSWl4/N7KcpJu2+WKW/4srB/sTaq8GlsPv3R0D3AerXVur4hzrzQ6s3i Wf2g5EuQx4RR/2UrtSin1TR79acCrMgiMriprW1li9btqBA75yBKm2MP3Y6eMPuvR7QZ KV+GTXNK8AWmP43I+Eu/nqEN4+diDMfrD1r5R4ukaD5MBPwmShwp2SlVywisOmIdY2ed N5lpOv2UHe8S90z3xTA00T7Is4acbJlG6MXHNpuE04KulQANvhglPDt/axbuVXGQHf5l fpJ1oywCxAwPsbFJxzqee2uHxPlwjH0EBjJ8ftNkGrtVVMZqpEA+iyOLsOKyh0l+j7db 0S/g== X-Gm-Message-State: AOAM533E0+ZLE/VORBqO/a08V7SDR1my3BdcAB6XcVXYnm4na9r0xWHJ w6O2buJOmTzNdXK5fMiLXpUAwBOIpQW9CB0Q+KWQevUj X-Google-Smtp-Source: ABdhPJzeY0hlLUwCFr3+yiF8Y32IV9Wyum979m25yXg/bYZkdRLxtOdxE/U85yqhco67Mqf9btsBseo3S9YyrV6tNkM= X-Received: by 2002:a17:90a:ea88:: with SMTP id h8mr6526174pjz.175.1613696777387; Thu, 18 Feb 2021 17:06:17 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 18 Feb 2021 17:06:16 -0800 Received-SPF: pass client-ip=209.85.216.41; envelope-from=stefankangas@gmail.com; helo=mail-pj1-f41.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, 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:200301 Archived-At: --00000000000031267705bba60fb0 Content-Type: text/plain; charset="UTF-8" Severity: wishlist As recently discussed on emacs-devel, it could be useful to have a command `describe-command' to search for commands. Please find attached a patch that adds such a command. I don't know if we should add a key binding, since the most obvious place to put it, `C-h c', is unfortunately already taken. Perhaps `C-h x' would make some sense in analogy with `M-x'. (Or perhaps it is worth moving `describe-key-briefly'...) So I solved it here by not adding any key at all, for now. Thoughts? --00000000000031267705bba60fb0 Content-Type: text/x-diff; charset="US-ASCII"; name="0001-Add-new-help-command-describe-command.patch" Content-Disposition: attachment; filename="0001-Add-new-help-command-describe-command.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: 7d78ca8eb802a14c_0.1 RnJvbSBlZDg5N2QwZDc1NDY1YzZlNWMzN2M0YmEwYzVhMTcxNmQ4NjI1MGNhIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5AbWFyeGlzdC5zZT4KRGF0 ZTogRnJpLCAxOSBGZWIgMjAyMSAwMTo0ODo1NSArMDEwMApTdWJqZWN0OiBbUEFUQ0hdIEFkZCBu ZXcgaGVscCBjb21tYW5kICdkZXNjcmliZS1jb21tYW5kJwoKKiBsaXNwL2hlbHAtZm5zLmVsIChk ZXNjcmliZS1jb21tYW5kKTogTmV3IGNvbW1hbmQuCihoZWxwLWZucy0tZGVzY3JpYmUtZnVuY3Rp b24tb3ItY29tbWFuZC1wcm9tcHQpOiBOZXcgaGVscGVyCmZ1bmN0aW9uIHRvIHByb21wdCBmb3Ig YSBmdW5jdGlvbiBvciBmdW5jdGlvbi4KKGRlc2NyaWJlLWZ1bmN0aW9uKTogVXNlIGFib3ZlIG5l dyBoZWxwZXIgZnVuY3Rpb24uCi0tLQogZXRjL05FV1MgICAgICAgICB8ICA0ICsrKysKIGxpc3Av aGVscC1mbnMuZWwgfCA1NCArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKy0tLS0tLS0t LS0tLS0tLS0KIDIgZmlsZXMgY2hhbmdlZCwgNDAgaW5zZXJ0aW9ucygrKSwgMTggZGVsZXRpb25z KC0pCgpkaWZmIC0tZ2l0IGEvZXRjL05FV1MgYi9ldGMvTkVXUwppbmRleCA3NjY1ZDQ3NDBmLi4y NjllNzYwYzViIDEwMDY0NAotLS0gYS9ldGMvTkVXUworKysgYi9ldGMvTkVXUwpAQCAtODU3LDYg Kzg1NywxMCBAQCBza2lwcGVkLgogLS0tCiAqKiogJ2cnICgncmV2ZXJ0LWJ1ZmZlcicpIGluICdo ZWxwLW1vZGUnIG5vIGxvbmdlciByZXF1aXJlcyBjb25maXJtYXRpb24uCiAKKyoqKiBOZXcgY29t bWFuZCAnZGVzY3JpYmUtY29tbWFuZCcgc2hvd3MgaGVscCBmb3IgYSBjb21tYW5kLgorVGhpcyBj YW4gYmUgdXNlZCBpbnN0ZWFkIG9mICdkZXNjcmliZS1mdW5jdGlvbicgdGhhdCBkZXNjcmliZXMg YW55CitmdW5jdGlvbi4KKwogKysrCiAqKiogTmV3IGNvbW1hbmQgJ2Rlc2NyaWJlLWtleW1hcCcg ZGVzY3JpYmVzIGtleWJpbmRpbmdzIGluIGEga2V5bWFwLgogCmRpZmYgLS1naXQgYS9saXNwL2hl bHAtZm5zLmVsIGIvbGlzcC9oZWxwLWZucy5lbAppbmRleCBjZWI2YmMwOTAxLi4zMzU0YWNjZDY3 IDEwMDY0NAotLS0gYS9saXNwL2hlbHAtZm5zLmVsCisrKyBiL2xpc3AvaGVscC1mbnMuZWwKQEAg LTE3NCwyNiArMTc0LDM5IEBAIGRlc2NyaWJlLWZ1bmN0aW9uLW9yaWctYnVmZmVyCiBGdW5jdGlv bnMgb24gYGhlbHAtZm5zLWRlc2NyaWJlLWZ1bmN0aW9uLWZ1bmN0aW9ucycgY2FuIHVzZSB0aGlz CiB0byBnZXQgYnVmZmVyLWxvY2FsIHZhbHVlcy4iKQogCisoZGVmdW4gaGVscC1mbnMtLWRlc2Ny aWJlLWZ1bmN0aW9uLW9yLWNvbW1hbmQtcHJvbXB0ICgmb3B0aW9uYWwgd2FudC1jb21tYW5kKQor ICAiUHJvbXB0IGZvciBhIGZ1bmN0aW9uIGZyb20gYGRlc2NyaWJlLWZ1bmN0aW9uJyBvciBgZGVz Y3JpYmUtY29tbWFuZCcuCitJZiBvcHRpb25hbCBhcmd1bWVudCBXQU5ULUNPTU1BTkQgaXMgbm9u LW5pbCwgcHJvbXB0IGZvciBhbgoraW50ZXJhY3RpdmUgY29tbWFuZC4iCisgIChsZXQqICgoZm4g KGlmIHdhbnQtY29tbWFuZAorICAgICAgICAgICAgICAgICAoY2FhciBjb21tYW5kLWhpc3Rvcnkp CisgICAgICAgICAgICAgICAoZnVuY3Rpb24tY2FsbGVkLWF0LXBvaW50KSkpCisgICAgICAgICAo cHJvbXB0IChmb3JtYXQtcHJvbXB0IChpZiB3YW50LWNvbW1hbmQKKyAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICJEZXNjcmliZSBjb21tYW5kIgorICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICJEZXNjcmliZSBmdW5jdGlvbiIpCisgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgIGZuKSkKKyAgICAgICAgIChlbmFibGUtcmVjdXJzaXZlLW1pbmlidWZmZXJz IHQpCisgICAgICAgICAodmFsIChjb21wbGV0aW5nLXJlYWQKKyAgICAgICAgICAgICAgIHByb21w dAorICAgICAgICAgICAgICAgIydoZWxwLS1zeW1ib2wtY29tcGxldGlvbi10YWJsZQorICAgICAg ICAgICAgICAgKGxhbWJkYSAoZikgKGlmIHdhbnQtY29tbWFuZAorICAgICAgICAgICAgICAgICAg ICAgICAgICAoY29tbWFuZHAgZikKKyAgICAgICAgICAgICAgICAgICAgICAgIChvciAoZmJvdW5k cCBmKSAoZ2V0IGYgJ2Z1bmN0aW9uLWRvY3VtZW50YXRpb24pKSkpCisgICAgICAgICAgICAgICB0 IG5pbCBuaWwKKyAgICAgICAgICAgICAgIChhbmQgZm4gKHN5bWJvbC1uYW1lIGZuKSkpKSkKKyAg ICAodW5sZXNzIChlcXVhbCB2YWwgIiIpCisgICAgICAoc2V0cSBmbiAoaW50ZXJuIHZhbCkpKQor ICAgICh1bmxlc3MgKGFuZCBmbiAoc3ltYm9scCBmbikpCisgICAgICAodXNlci1lcnJvciAiWW91 IGRpZG4ndCBzcGVjaWZ5IGEgZnVuY3Rpb24gc3ltYm9sIikpCisgICAgKHVubGVzcyAob3IgKGZi b3VuZHAgZm4pIChnZXQgZm4gJ2Z1bmN0aW9uLWRvY3VtZW50YXRpb24pKQorICAgICAgKHVzZXIt ZXJyb3IgIlN5bWJvbCdzIGZ1bmN0aW9uIGRlZmluaXRpb24gaXMgdm9pZDogJXMiIGZuKSkKKyAg ICAobGlzdCBmbikpKQorCiA7OzsjIyNhdXRvbG9hZAogKGRlZnVuIGRlc2NyaWJlLWZ1bmN0aW9u IChmdW5jdGlvbikKICAgIkRpc3BsYXkgdGhlIGZ1bGwgZG9jdW1lbnRhdGlvbiBvZiBGVU5DVElP TiAoYSBzeW1ib2wpLgogV2hlbiBjYWxsZWQgZnJvbSBsaXNwLCBGVU5DVElPTiBtYXkgYWxzbyBi ZSBhIGZ1bmN0aW9uIG9iamVjdC4iCi0gIChpbnRlcmFjdGl2ZQotICAgKGxldCogKChmbiAoZnVu Y3Rpb24tY2FsbGVkLWF0LXBvaW50KSkKLSAgICAgICAgICAoZW5hYmxlLXJlY3Vyc2l2ZS1taW5p YnVmZmVycyB0KQotICAgICAgICAgICh2YWwgKGNvbXBsZXRpbmctcmVhZAotICAgICAgICAgICAg ICAgIChmb3JtYXQtcHJvbXB0ICJEZXNjcmliZSBmdW5jdGlvbiIgZm4pCi0gICAgICAgICAgICAg ICAgIydoZWxwLS1zeW1ib2wtY29tcGxldGlvbi10YWJsZQotICAgICAgICAgICAgICAgIChsYW1i ZGEgKGYpIChvciAoZmJvdW5kcCBmKSAoZ2V0IGYgJ2Z1bmN0aW9uLWRvY3VtZW50YXRpb24pKSkK LSAgICAgICAgICAgICAgICB0IG5pbCBuaWwKLSAgICAgICAgICAgICAgICAoYW5kIGZuIChzeW1i b2wtbmFtZSBmbikpKSkpCi0gICAgICh1bmxlc3MgKGVxdWFsIHZhbCAiIikKLSAgICAgICAoc2V0 cSBmbiAoaW50ZXJuIHZhbCkpKQotICAgICAodW5sZXNzIChhbmQgZm4gKHN5bWJvbHAgZm4pKQot ICAgICAgICh1c2VyLWVycm9yICJZb3UgZGlkbid0IHNwZWNpZnkgYSBmdW5jdGlvbiBzeW1ib2wi KSkKLSAgICAgKHVubGVzcyAob3IgKGZib3VuZHAgZm4pIChnZXQgZm4gJ2Z1bmN0aW9uLWRvY3Vt ZW50YXRpb24pKQotICAgICAgICh1c2VyLWVycm9yICJTeW1ib2wncyBmdW5jdGlvbiBkZWZpbml0 aW9uIGlzIHZvaWQ6ICVzIiBmbikpCi0gICAgIChsaXN0IGZuKSkpCisgIChpbnRlcmFjdGl2ZSAo aGVscC1mbnMtLWRlc2NyaWJlLWZ1bmN0aW9uLW9yLWNvbW1hbmQtcHJvbXB0KSkKIAogICA7OyBX ZSBzYXZlIGRlc2NyaWJlLWZ1bmN0aW9uLW9yaWctYnVmZmVyIG9uIHRoZSBoZWxwIHhyZWYgc3Rh Y2ssIHNvCiAgIDs7IGl0IGlzIHJlc3RvcmVkIGJ5IHRoZSBiYWNrL2ZvcndhcmQgYnV0dG9ucy4g ICdoZWxwLWJ1ZmZlcicKQEAgLTIyMyw5ICsyMzYsMTQgQEAgZGVzY3JpYmUtZnVuY3Rpb24KICAg ICAgICAgKGRlc2NyaWJlLWZ1bmN0aW9uLTEgZnVuY3Rpb24pCiAgICAgICAgICh3aXRoLWN1cnJl bnQtYnVmZmVyIHN0YW5kYXJkLW91dHB1dAogICAgICAgICAgIDs7IFJldHVybiB0aGUgdGV4dCB3 ZSBkaXNwbGF5ZWQuCi0gICAgICAgICAgKGJ1ZmZlci1zdHJpbmcpKSkpCi0gICAgKSkKKyAgICAg ICAgICAoYnVmZmVyLXN0cmluZykpKSkpKQogCis7OzsjIyNhdXRvbG9hZAorKGRlZnVuIGRlc2Ny aWJlLWNvbW1hbmQgKGNvbW1hbmQpCisgICJEaXNwbGF5IHRoZSBmdWxsIGRvY3VtZW50YXRpb24g b2YgQ09NTUFORCAoYSBzeW1ib2wpLgorV2hlbiBjYWxsZWQgZnJvbSBsaXNwLCBDT01NQU5EIG1h eSBhbHNvIGJlIGEgZnVuY3Rpb24gb2JqZWN0LiIKKyAgKGludGVyYWN0aXZlIChoZWxwLWZucy0t ZGVzY3JpYmUtZnVuY3Rpb24tb3ItY29tbWFuZC1wcm9tcHQgJ2lzLWNvbW1hbmQpKQorICAoZGVz Y3JpYmUtZnVuY3Rpb24gY29tbWFuZCkpCiAKIDs7IENvdWxkIGJlIHRoaXMsIGlmIHdlIG1ha2Ug c3ltYm9sLWZpbGUgZG8gdGhlIHdvcmsgYmVsb3cuCiA7OyAoZGVmdW4gaGVscC1DLWZpbGUtbmFt ZSAoc3Vici1vci12YXIga2luZCkKLS0gCjIuMzAuMAoK --00000000000031267705bba60fb0--