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:06:47 +0000 Message-ID: References: <835z2o4fes.fsf@gnu.org> <83ft1qzpon.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="6806"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "larsi@gnus.org" , "stefan@marxist.se" , "46627@debbugs.gnu.org" <46627@debbugs.gnu.org> To: Eli Zaretskii , "rms@gnu.org" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Feb 20 21:07:46 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 1lDYXZ-0001fN-JS for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Feb 2021 21:07:45 +0100 Original-Received: from localhost ([::1]:56488 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDYXY-0004Ik-8L for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Feb 2021 15:07:44 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54688) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDYWs-0004IR-5N for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2021 15:07:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41391) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDYWr-0001So-Un for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2021 15:07:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lDYWr-0002jB-PP for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2021 15:07:01 -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:07: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.161385162010478 (code B ref 46627); Sat, 20 Feb 2021 20:07:01 +0000 Original-Received: (at 46627) by debbugs.gnu.org; 20 Feb 2021 20:07:00 +0000 Original-Received: from localhost ([127.0.0.1]:52937 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDYWp-0002iv-HA for submit@debbugs.gnu.org; Sat, 20 Feb 2021 15:07:00 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:34612) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lDYWm-0002ia-3Y for 46627@debbugs.gnu.org; Sat, 20 Feb 2021 15:06:59 -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 11KK2vdX052073; Sat, 20 Feb 2021 20:06:49 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=jabY9xBOIfYB8rwh5QQil2Dg0sZPivWcUDhWpeOO6Yk=; b=khQe9M0Yr7ioM0v5tU6koj8RV/unRKOyMW/CSZD/wKkm5eGgvAJMRCaJBk0Ikeye2rkv 99A2onZDue719TgCdPOe+BUSjUmw1UDaXlALv1g87LPCRIpbE35nq5wqgqd8Gu7RixFt Yc+7FDs/JI+mByEgJGr8vQPzWP2+uEKB0BjfBFK+tlIWGMlXCaFh2/XL3S3jmc9mpl9Q S9LFZOWA/r+itKm8NUAo5wKR+vsHn16KBa4r7/3AT2pMwkUYYP+VS+ZVS1Poiw27xJI1 mSWwiD3687cL1Px2HqUSto5u6vbMk2HQuiQ8FFqRnPzL/9HWQx7lj1Km8xXoln2GaD5V 3Q== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2120.oracle.com with ESMTP id 36ttcm0u87-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 20 Feb 2021 20:06:49 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 11KK6YeJ126733; Sat, 20 Feb 2021 20:06:49 GMT Original-Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10lp2105.outbound.protection.outlook.com [104.47.70.105]) by aserp3030.oracle.com with ESMTP id 36trf9rgda-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 20 Feb 2021 20:06:49 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=PRSCXAl3N7xAZ+kfo9vyu5XwbQFXlgMjszPOKjqOsFDCaET/AHXgAa9tEUwvQxSRUIQbJsW6hvhnub2xFkmUUuY15CtCQo+NyCy0XLztVsQI5H+TDAKYWZlq7dsHlUQrQumDm3ee52gfv05ZvYB21FW9YYQvbxammv26Mw2h8tfWa/1eY8PYtY+ceIqmjUeKBN1SNF7ZfLga6ijRTjt2fP7Ut/RC5kYosFHWy8gyqv5TUQm073UPW5RfQFmwSOQDhpbaApyyhh2aPsUa6HXQ0RzV9Mi1wr6ASCcGjf41HlW1hGhTzQY1vSwXZwP0Q+vjge1K69bryFOhZXtBQjoGrQ== 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=jabY9xBOIfYB8rwh5QQil2Dg0sZPivWcUDhWpeOO6Yk=; b=E3Z9deAxBhnGsX/9lG8qefDyKKnQRa6ib4D2odQDxNGbAkNAD4/cJ/F8+GWXI5K0oy0Y475FyECdW5PGLLUU5r0ys0miTB9juH3hkCSN7Ug/njr5NSPC6fyeik27ztLuxeXgYUQdGZ8R85sF/NAF3wdHAY6sefwcNaWcNtKBGmQbgBPf/hZOe9P/KXqVS6PsgWDIN4zRWEVEASjsDGkL6Jyum2CAhcR/peN6+3F1jA3mP8Ry5jVHZvR8FDDbYyEmV/PMk0Xjx12U432JnSpVFZ+Wbr/rXDzk+AGzOy4yR8dkzwTdbtFMBbMNyZlqH2ZhlzEisCYrTRTq7ClMSLAaig== 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=jabY9xBOIfYB8rwh5QQil2Dg0sZPivWcUDhWpeOO6Yk=; b=HeSRsBaZq1fJZkr7ufb467BZUZmKxp6bPDMxo5r221hLja29obGBMsThTnrOFcF2dhTBwfbDWcNgU/SUOdHtxezsVuKWmDEJvpnIEVLPsC6SJpCG0l11dYdFatgvLx3W4CL7fQ8quX94ucNNohwUQtZKso5bRHVngmWl6ACfr40= Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com (2603:10b6:806:11b::15) by SN6PR10MB2781.namprd10.prod.outlook.com (2603:10b6:805:d4::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3868.30; Sat, 20 Feb 2021 20:06:47 +0000 Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::b8d2:db6d:3e4b:d315]) by SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::b8d2:db6d:3e4b:d315%5]) with mapi id 15.20.3846.043; Sat, 20 Feb 2021 20:06:47 +0000 Thread-Topic: [External] : bug#46627: [PATCH] Add new help command 'describe-command' Thread-Index: AQHXB6LfBfT3Z98+M0e+w+txT3KM+qphdBlQ In-Reply-To: <83ft1qzpon.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: 70faebf7-2dac-4f2b-0aa4-08d8d5db0d5c x-ms-traffictypediagnostic: SN6PR10MB2781: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:5516; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: cIajfqjF0j0ThOLxrPnBUD4jd2aNZ98xQCWyCggaZfvYDCMP4F+0xFtzc66eIFcfr/HlgBNtE4XubBKBrjDd2ErvGMQzYVP0DRWEfNlf4MFngv69yfHxAzrG8Y6pxta1eiWzhEPXhcMAhkMupTOWngslooDgSQjN3uT54x4NNdXkp9rXKZ8n0t5bGK3kzmPpxu8QbS2Pfrnr4ukllOUtk5v429dunG2Kjg3opz4dfxbG4Gknqime5ShxQU7jAqwOUCncYfyEV1E6ATnE7GX02cG4luBPSdlJLVSlPjyL6xDRA6HI9fViHOosexOf4oQGMHsDYEb/tmyoJ7sDyzsqNlZJ4NbkwSiOsJc47aey4JAXwkHAahf4r5oVmBDG3vU25inppuFGFh/Da0NLqCBqpCwKVmH50UaKWIs4NgV3t+ZgoDylXujscAiZUmy/0FuFTcmWAq2YECiZSUGirFLUhvQCE+bMZ/DU95j4zIWRlM4+GAe1seL4iSmSWl2hRp9uUuHBpjAYQunx/29hKOiAqg== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4474.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(376002)(396003)(39860400002)(136003)(346002)(478600001)(66556008)(5660300002)(76116006)(66946007)(66476007)(4744005)(6506007)(52536014)(64756008)(66446008)(7696005)(26005)(55016002)(186003)(44832011)(9686003)(54906003)(86362001)(8676002)(71200400001)(110136005)(316002)(33656002)(2906002)(8936002)(4326008); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: EeqJ/C9Q7NNU90nqze1ds0IfGuyikDja12fxlz/5Ob1YU8E1eT5OX8GXjzX9yyM84I0p2LtczprrycwEXTAkfvGjtwDvB1w9LjF5Wsyj6HEMAXChJZWe3uGQ5WxZLvukuYOi8uMLOcdTSNh8tdvcGUdPU/fD9KcK/1WD4JNChQ1qs3X9Mp2YE+whOLFLtAI4q5jZ1g5w9Ie6/thwHYYumclY0C0eryg2pnVP2BbA5vgnu5hGNjEIHJ4xaVRjIqoa5j+ZjuKvDAOPft5BJK+nH5mUNgkCHQi+/VHfhXwuhcPSNJ2HWOYF3p4Ff2LfXXp6PMfu/dzv3pmlNxHwIy3iNyW3R0WoH6VCNLD4018eW06FDIoDDVZVS5JDqiSNZdBfd+kqpGnjOsgGyq8KAOWE7VieSMdW8974XkUMVQg0DkbBw/ZTe6iLX6dnEZzdhOzBryBErMhRpPGxBacl7h/nKeSGg1Tu79WgdIXBTH9Kq/Xwcf5UsVimnBw2wo96zfCfklicxBskY/aCGTKVAQzokhtvM75wHLuwG23c5txfO8uNqorERsf9saHWrct9UyGRwaR96yEw0bln9Qe3hS8kzvE9bzWT2ZwmHL3DBl8iJwakz5Q2y593rCsiLOqyM47M2gL3clkClEVHTlpVriQSif3HtfOLxbhrYsIW9pVcbkF8XhqSVTulQEE3S7ztclsjBGM7e5toI+b8P/ZTbYb7H502sySlO2RpP9Nx8/qa8NDIK2Xii0veokiSSbcO 89cr1t4y6Uh826z23OV0B79zqKuSBVYmlayRmDEobi619H/haKa/PFWJ0TIqjUc6ZwgCKiwfSE/brBMhXA9AyCChf4c2GpwcIz x-ms-exchange-transport-forked: True X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4474.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 70faebf7-2dac-4f2b-0aa4-08d8d5db0d5c X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Feb 2021 20:06:47.0559 (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: Skdb9ZcJ+GUkA9NBEYRLWhD9yFf+8oDEg49DkhFmX2ypfP0PpQ5FWb4aAAADmC+ZUQzouLpa7m6Ji/BkJuGgRA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR10MB2781 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9901 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxscore=0 phishscore=0 mlxlogscore=999 adultscore=0 suspectscore=0 spamscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2102200187 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-2102200186 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:200456 Archived-At: > > There seems to be little difference between the proposed > > describe-command command and the existing describe-function command. > > Whatever the former could do, the latter already does. Yes, the latter can do more. Just as `integerp' can do more than `natnump'. Just as `eval-buffer' can do more than `eval-region'. > 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. (At least that's what my implementation does. `completing-read' uses `commandp' as PREDICATE and `t' as REQUIRE-MATCH.)