From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#46627: [External] : bug#46627: [PATCH] Add new help command 'describe-command' Date: Sat, 20 Feb 2021 20:54:36 +0000 Message-ID: References: <835z2o4fes.fsf@gnu.org> <83ft1qzpon.fsf@gnu.org> <83zgzyxzmi.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12648"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "larsi@gnus.org" , "stefan@marxist.se" , "rms@gnu.org" , "46627@debbugs.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 Sat Feb 20 21:55:12 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 1lDZHT-0003BV-LW for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Feb 2021 21:55:11 +0100 Original-Received: from localhost ([::1]:47584 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDZHS-0007RF-4U for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Feb 2021 15:55:10 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35506) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDZHK-0007Qb-H9 for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2021 15:55:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41434) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDZHK-0006Kc-8s for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2021 15:55:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lDZHK-0003qF-5K for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2021 15:55:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 20 Feb 2021 20:55: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.161385449114747 (code B ref 46627); Sat, 20 Feb 2021 20:55:02 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 20 Feb 2021 20:54:51 +0000 Original-Received: from localhost ([127.0.0.1]:52980 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDZH9-0003pm-Bu for submit@debbugs.gnu.org; Sat, 20 Feb 2021 15:54:51 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:50740) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDZH6-0003pZ-73 for 46627@debbugs.gnu.org; Sat, 20 Feb 2021 15:54:49 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 11KKsg6m112013; Sat, 20 Feb 2021 20:54:42 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=mi4t5XxLJ9abEfBkVMqwh4DwJdI1bgE7O0rAhsvXBD4=; b=dPD+lXLvL4t9w2e+M0I7SEPaIHZplNLwmoSs1sb6GevwARbgTfTyICB/RiudSdzJJDzq Sr0VMyyJru1wZHPaywLXMINpwdoCkQa4W6FS0ulXzmZbU69CVlzrvn9wy9zN/yPgKRG6 4kj2KFBYatoa5sjvgsLeTuKsGTNsAoPTxoMnuILm2uLtsWGVAXY+iiDT0wQdpKpID+gs TqUadwJmCfHJ7jQPdj/a9JpXKwotTq1ew86zZJpCleiiEZF1rL7+Y1nhyWMXz+SJIZNa HfxdADSH48m2l7fyd2vBYyrghbn6oJto3/+tuxOK9nD0+cc9ZMd/bJbLT63qkGRXyT/Z hA== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by aserp2120.oracle.com with ESMTP id 36ttcm0uud-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 20 Feb 2021 20:54:41 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 11KKoIAV190373; Sat, 20 Feb 2021 20:54:41 GMT Original-Received: from nam02-dm3-obe.outbound.protection.outlook.com (mail-dm3nam07lp2044.outbound.protection.outlook.com [104.47.56.44]) by userp3030.oracle.com with ESMTP id 36tqhsc0yk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 20 Feb 2021 20:54:40 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=HStuieEpspol7FA0usl4CAGARmJ6sYiJX5SQ2TZxy/rnSNKW0ZJxz3i2G/orQfUe3ZZQ+8tiqLdI3YYxvpdLHlf7ybZQAy6MmR98Rj0zUF5itokmkIbiu9CkOhyPMoyMPv1p2kDwiaUHMbZtiPJ8K4tpDW6si0ZTO6bnFoCz7wk2LkvI6PZDI/yif2JRVvtQw1lYW0jCc3kHLLGffobYce+1rASqip41JonM1BELqVg+I7ezRMImX+FeVYLEtxqRw9kYya4QltsaKdCEBDxKWSa7Aw0l286dpfq0V+2WJ1X+EN2Lw2C64TObEltbQSNddLTOpZ2R+0nV5oksW3QqZw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=mi4t5XxLJ9abEfBkVMqwh4DwJdI1bgE7O0rAhsvXBD4=; b=aG3nIoImZurXIAt+yr79HROyNlt603MI14XxfJq0WEymfKAljYsHRWDA2dXhIzLHBCoiHj2AmvG5RXhtN0qvI0BXtsCZ9Ol226SUIjeeTW3H01y0zUNmBaCDhQ/tujKBLUhBaxzjtQviY6Dbpe1nySDrXbOWj6P2XbzBvz80vZ5UD7j6MoH8iNBcsRuFLjF4PGIMoTbBbJapgYxA3JRNHTj9e2R6HtQqWZpm/kXz1pu6TcfwfDhCthzjM+lyMooaOE+ZEF+Awa49DOEOAf5y2lVkwAXj2VlFflqGoqthR9LLulwHJyL3XoKoIwDUexDU4ZS+fdCawGPzdoUIGYmsqQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=mi4t5XxLJ9abEfBkVMqwh4DwJdI1bgE7O0rAhsvXBD4=; b=qzZrUBL022Sf7aIjZL/OQ3uB/vP6dtiIiWlHDR8zhiUQKVSAcAeVebzZBtE6Xjvlnws8anQTn66nEUqoHhpMycQF0innU9I3rm6Xz0sUjtLT+uQPPp9/ZYRGwa9rwoPsJ6NYbRzznGp3ja7Hfhc96OCbwegimk23bvPCh4zvlsw= Original-Received: from CO1PR10MB4466.namprd10.prod.outlook.com (2603:10b6:303:9b::10) by MWHPR10MB1885.namprd10.prod.outlook.com (2603:10b6:300:10a::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3846.27; Sat, 20 Feb 2021 20:54:37 +0000 Original-Received: from CO1PR10MB4466.namprd10.prod.outlook.com ([fe80::6c75:86a7:a64:6c72]) by CO1PR10MB4466.namprd10.prod.outlook.com ([fe80::6c75:86a7:a64:6c72%3]) with mapi id 15.20.3868.031; Sat, 20 Feb 2021 20:54:37 +0000 Thread-Topic: [External] : bug#46627: [PATCH] Add new help command 'describe-command' Thread-Index: AQHXB8VwSRYGVywLG0KF1oc4Xrc3rqphgyBg In-Reply-To: <83zgzyxzmi.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US authentication-results: gnu.org; dkim=none (message not signed) header.d=none;gnu.org; dmarc=none action=none header.from=oracle.com; x-originating-ip: [73.170.83.28] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: eae5e182-9b6f-4e6c-c125-08d8d5e1bbfd x-ms-traffictypediagnostic: MWHPR10MB1885: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:4941; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: jdlk1QPrupEd992fardQllrTEZm4ghOEM/2guyvGVQhliJ+SqaECSXDyRvdN0y/R42WMHBA++adxT7l1uyt6hwszNN8gTvgZvzAw8je9ldk1S6EKLvjSpuiDVC3vCASJtEJatDpHJ1C49/987X2S4cp3YlCmtpQzUs+1/6N/e/gJGrKdxOq2HxGBsHEQBWhnKi9esh3ulhD6seNvN3DfxdJGXUgsZYLVYu775YalT6bmCaSadZhN9hhg1qCFXdLHumAKz2cy9ggRylZjefm9qVuuU92/e8lfLo4/KcdnFS+E3Y5skx7KMd6ck3BPMk+7O3lme3dYo8Rl9AK+64bpEM6lUg/ttcKbT6GWEF486uijp4zFwZZb0xpzCgNAnzRiZnfvexe52DyCVxpkJJX/VfYsmIhU5Mo0QTFJbwhsYGVRGRybU6Bu5C0EgrDOgenRm7g7pvwpJDryqlHH513VkJFZJ3+w42hL+54v2+RF8eEC5eYE7AhTKk6YR6yb4aB/p7xxNoEY8x6lqgEawXlwNg== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CO1PR10MB4466.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(376002)(136003)(39860400002)(366004)(396003)(346002)(71200400001)(8676002)(186003)(6506007)(4326008)(478600001)(54906003)(316002)(6916009)(26005)(4744005)(8936002)(7696005)(33656002)(76116006)(64756008)(66556008)(86362001)(44832011)(2906002)(66476007)(66446008)(66946007)(5660300002)(52536014)(55016002)(9686003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: 15u5rLvpEwOgaW5+t/QRrNPU0/GTzYR/Mq7x5VOQ84BlMQSD4rTGtbeZEL0+0Aoy1oFg/zTqzo2F7a55UWPTHvjvek1nmY78xKjic4TyjD7zbZuLFR8vQcfC6JUgUwxrkzE9G3UUERwu6TlS4gsjcF6cKo3cmNDpdkaKt520kdwn4uUMc1DQ/D1B+0PaTtpK0RgPqh18y3pqZEKOjidGQpU/KCX5GPiQYd9r1MP13Q2mP8XqNEXPpOM5b+UkFCp6Yuuyyg6YNXo8fzWQHWAxrJhUDL8ipH2kNgPNEV0e0LuGY1xZRuCrOyHZLrMAwmW2KgBjlULdByTknT48YZEyO5X0sk2YeHRFdoCoTvX8grFBBNU9cx8F5GJcQ9gTA3DdkCg2s9qGzKuh7kDGcSTGj6EBOOWmk38xIi/RezEv2G5uyim4w3U7zCWhUHpLGssy+bu5AeYP9Xva3gM9xGcg9lgjHNpdEY8Bjw8Mxdrq/HZ/JrO8SJUmcRON6ZmkiV5aCmnHIeJY3wNkRIgcttdzDtC2FG5CynVDf12c5D7pvfVi9arS8m9Z/II9HJKyRkN17elp5DVLCvbr5JaW0XUkufaDvhtpKrWlC/UQbmvCmlIKCEiccladHa1BagSWSHFEGqYXnZM+p/pW72q/ylrOYxjd/cPYJZa7tQdo1fYMAk7Sni0IkD2vSBRDI4ijOB2G8+7srPuWd4MgKYToat7Xhvn3rBRQTphHnEgFbglp+1EInv7aVAovNjKWNzMb wC1cNROGK5gryIK7d8lLpwCAy6e4Ehcpx3NUOsTDNddKZ3wi8vzSLOmtoNGWReOKsKW+d6BY/0OyanJRHylETN6YkYAReZwLWT x-ms-exchange-transport-forked: True X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: CO1PR10MB4466.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: eae5e182-9b6f-4e6c-c125-08d8d5e1bbfd X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Feb 2021 20:54:36.9569 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: yOQHHdg0z9T8tfcSw2KDzsZD2Shyj1x+5fcxctuB792TjofvfZMsZYYEPK+O7otLWX33jZP0x0AEvM5o+WRUfw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR10MB1885 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9901 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 phishscore=0 suspectscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2102200195 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9901 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 adultscore=0 lowpriorityscore=0 spamscore=0 mlxscore=0 bulkscore=0 clxscore=1015 priorityscore=1501 malwarescore=0 impostorscore=0 suspectscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2102200195 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:200461 Archived-At: > > > The main difference is in the completion these commands > > > offer. describe-command completes only on commands. > > > > Yes, that's an important difference. In addition, > > _only commands are accepted_ as input, regardless > > of whether you use completion. >=20 > No, because RET does completion. (We're getting into nits now. OK.) Only if REQUIRE-MATCH is non-nil. And _that_ provides the feature I mentioned: only commands are accepted as input. With REQUIRE-MATCH =3D nil, RET does no completion: (completing-read "Command?: " obarray 'commandp nil) You can input `xxxxxxxxxxxxxxxxxxxx' if you like, and it's accepted without being a command name. What you emphasized is the result of a PREDICATE arg of `commandp'. But accepting only commands has nothing to do with completing. It has to do with REQUIRE-MATCH. Both are important here.