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#58602: 29.0.50; Please document (:documentation FORM) spec for closures Date: Thu, 20 Oct 2022 16:50:44 +0000 Message-ID: References: <87r0z69cxj.fsf@web.de> <87h701izxa.fsf@web.de> <8735bkobbd.fsf@web.de> <87y1tb75z9.fsf@web.de> <87ilkeg7mo.fsf@gmx.de> 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="25057"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "michael_heerdegen@web.de" To: Michael Albinus , "58602@debbugs.gnu.org" <58602@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Oct 20 18:52:16 2022 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 1olYmG-0006MU-82 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 Oct 2022 18:52:16 +0200 Original-Received: from localhost ([::1]:58780 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1olYmA-0000We-Pr for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 Oct 2022 12:52:11 -0400 Original-Received: from [::1] (helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1olYlD-00052y-Sm for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 Oct 2022 12:51:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35042) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1olYl6-0004Y3-3Q for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2022 12:51:07 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36952) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1olYl4-00072Q-IF for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2022 12:51:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1olYl4-0005ub-2c for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2022 12:51:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2022 16:51:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 58602 X-GNU-PR-Package: emacs Original-Received: via spool by 58602-submit@debbugs.gnu.org id=B58602.166628465322705 (code B ref 58602); Thu, 20 Oct 2022 16:51:01 +0000 Original-Received: (at 58602) by debbugs.gnu.org; 20 Oct 2022 16:50:53 +0000 Original-Received: from localhost ([127.0.0.1]:36029 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1olYkv-0005u8-8s for submit@debbugs.gnu.org; Thu, 20 Oct 2022 12:50:53 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:35356) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1olYkr-0005ty-Ne for 58602@debbugs.gnu.org; Thu, 20 Oct 2022 12:50:51 -0400 Original-Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 29KFimtr022117; Thu, 20 Oct 2022 16:50:48 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-2022-7-12; bh=s6WkFt7rdl5yeb64aqo3Fkt6/pw0BGybhWv2sXaXr4U=; b=1IpUgQyqsn4h28qwe0B2Tn4zMME6O+1j3agjHoE0DsLBfKjqe69sxA6NZ1HyU0YApQIo JnYbJipFeDFP8PtelJNjiHy5L+YNbD4OmqRX8bJEk3aYdK9Xco34hB2WsXLqI9cLnSby skrMTEKcJ5ZLV7fW8j44anMspn5r0+bF851vCzT0PaxKeEc8hpsmo8jmMLwtk5p1zt7+ DPsHatVi35+kyMurz/OtUSkTidOORokV2g1x8AK+5qHknmDtdstUpUuc3O+jMUxQ9aWj CHtaON7sXO34JZnTUtkrR0srJFUW89KY/3f8eV1Pdx0HaR0HzTS6JSDU1WnTdfdxhnlM CA== Original-Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3k7ndtpkbb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 20 Oct 2022 16:50:48 +0000 Original-Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 29KFKCMV027499; Thu, 20 Oct 2022 16:50:46 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2174.outbound.protection.outlook.com [104.47.55.174]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3k8htjrmjm-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 20 Oct 2022 16:50:46 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=JmJrM6n2l3pAN4vzxUAuEV83fMLST1NebSb3FPRQGx16e1TD9edPgSNOlruv2SayJ61M1oi4+c0xVWxsJQhqRlm+dREn8ygFXiDfQaWdeUvRZ0VVWa+ipP0wIMdhEn520AxfraKcwc68PisqeUv2NrmoPEneLhER3shDawGhO+afIubKwWgBzAC/LZmjB3ORvSgMVcUpHVqjrsL/95tCvdRqrHLT4gpQ5O1AknIkdeNmiClxrFqjH16WrkerWJh2Mn6t3D+1qGwiaIBXCqma6cFUzrXwzmdzhCnoOSvDbvQPKjstE9Dp0swtldFTTrFLDBDEJyqrTvb4S+stHbHaCA== 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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=s6WkFt7rdl5yeb64aqo3Fkt6/pw0BGybhWv2sXaXr4U=; b=V45yfPB06KvFIIF5VXAjaQoue/YWBs4xrqjMAHZjp70CcOtPLKSwZKsAIX1LI3TkKojG6mD+cNY9Mm3C8LZdM/UuBYEtqG04a6aHXKSkf2bxoDkwAdMCSgesSx6Uy7mw3xmBjx/ElYGVHTe08mAeLa2gPg+2sKNsO6hx5gH2vqwDfSAobbJeHZne4TpF5D5gI1MRRzA9o3Ll/xa3JH5jeX4BBqrgiTdTGhoRPPu8bGuE8Ankd0YaZTLgXM/kqHNz4+Hc0wjUnySRzOuf4P4+MUwC9OXRycBbRlYvmPd0+K7W1cXV+Wokd45a+z+fmH0rE4LLOAWOUQ8p96IA6aq+DQ== 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=s6WkFt7rdl5yeb64aqo3Fkt6/pw0BGybhWv2sXaXr4U=; b=ZklLm+Bif/Clq3XIp2oM2wvRjADxElQ9HVxT2+SW3VjS4+pbTBCnYJLXKPqIa6YXHBnvMSGb5QG3XBMHRru39U4yEtc++NcfJChAt1CbXU/EbxO6nHPMUlaq2zvKRRrh+PG71Nb8dbja5gu7armWlVgBu3gvK0iByXSQ8kArpV0= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DS7PR10MB5133.namprd10.prod.outlook.com (2603:10b6:5:3a7::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5723.34; Thu, 20 Oct 2022 16:50:45 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::2e97:93c5:7222:5b31]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::2e97:93c5:7222:5b31%5]) with mapi id 15.20.5723.033; Thu, 20 Oct 2022 16:50:44 +0000 Thread-Topic: [External] : bug#58602: 29.0.50; Please document (:documentation FORM) spec for closures Thread-Index: AQHY5GgxX357BaeDnkih3w6aALSSg64XcuoA In-Reply-To: <87ilkeg7mo.fsf@gmx.de> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|DS7PR10MB5133:EE_ x-ms-office365-filtering-correlation-id: d68f2ad5-e079-4f1a-a35d-08dab2bb3b46 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: idRheVwOMt7vDz7jSP0nZ7f4VCQh+r9LDcmeMlBLoMqy2/OKAtdrvSrwef5n8xJJsl6x4lU2ylNobke1xXzbqEISdr+d/zrtRTZQPCKsDoxDohPq7iJeVhKfONSewlp/oLoy0mufN1zOjhBmvvlTtfIkynaRDGv0/lM3NPEjBRZQbg6oIBzzKkBis0m+evRcp5b0ADCLS7diwf+fKbsCYmyG4qjHp/roH4oM1YU4FxTCaGms5/aYEPCfNZDDwXiuUd1YQIbxsOK3UzvfAVQzwJSV1G09OXr5fiasbLLQgCyo1tXc8Ow8Zt+JXObdy+c1tvChCeKmP+8OevaQKh08im7aTTu0rA6b2/7HxXbACkf/feLDUHvHjApYOHa1sN3JXAyfX4qJ2ht7ds03K3PjVQPGz5qFyUoo45OR/TYRk5YBp7JGYGQzIVXPqj35xj3EMcY6m2OyhEEBQt5ELxhHS7IXEn7yM/zInOS09t9pIRV41E2KvGUxKANnKuWrZG3BtNUaXORsXKMfOyacuq92mJYt/W22dbb2m3N+6lgqf2+/dkVjzOqSfKxDJp9BjR1LzvfEd2PTttILO2mYOcvVL0gfeGfZaAumzT63Bv08YYcX6uhBdpv+KDuP+qmCVhTPrzYbfBL52vXJGsp89KRAuQQTtp2PAVGJjPm7yJcAgYE9ptOIT4MMlJ8g+McvpKd95CgrNaeqyxaDT6Z+iPEG4agguOsaaTKFzxDeg2ZtVx7LOUhf2MWc/z4L3M+Du 1xS91KU690X/6Ougtl68RuwXQ== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(396003)(346002)(39860400002)(136003)(376002)(366004)(451199015)(71200400001)(478600001)(86362001)(66946007)(66476007)(66556008)(66446008)(316002)(110136005)(41300700001)(26005)(52536014)(76116006)(44832011)(8936002)(4326008)(9686003)(5660300002)(8676002)(6506007)(55016003)(7696005)(2906002)(186003)(33656002)(64756008)(122000001)(38070700005)(38100700002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: CAiVpHN7H4xAH6QgWn1iHmZpZASuo+rb1cbWt9McHGFzEIe+wnMDi6GgFZ0/3dJhQfZJUqqctp3kqNCkGOHb5skAconP+oagbRngbhllVMOJNm8XAQ2l92vkukAIH72WyAz8DFCTjws9+xPdQctWvP+2HstuQohqQw93DBN5CAkj/DDehkArhg7NVm0tBAxj436jNSawzRxWsgaVV15EpLSJrv0tf3jr0QHBWl2yhZ6h26GpWnglfcYfNM10qxhvxhxBAkdE3Sj/E4vgM58pRxdmuLnH0tg18TPG9XdmM3R17CcoZTMzrZAyxzmomYCd9Djr75H+kswmiDDCEr7bxa6IlHyPvwchq7Rmsph0giqIbGwNureakBKyFE4oYKFIIPqIBK2JVD7xEDTPyd+T3eqoh6BzphAUXEnlLkXTk9TI377GoTvtFkHr94AmDagqtXrZOYzVK9WTi/zdF7Jc7KH/mQ+Zgb2ckJUyEbNy9+LgIdaCiLCqrNjmOaTS55gPzWMa2IAk1YrKjfW8PFvCZdbf1C0DyeZZ07x3onYOQx8b7wH/dPz0j7XPsqMgHkIEinsCUnmdZxeOlRgb2BYwcXMcLudywLkYEgbXji8ZqpupDmr87ge9ZKnx6h68fXN4tvXqXQggroQV09JfvHe+cFFMKJfQ3lqKv18q2WkQAeW6rUZUvrfVt7obMnl9HdqbpVhrJMHlT0WYm0f5pJGg8dqg2+8vIw0wOQ1biKYdNdwFHVscXE14doz5jY RaGPCnHJqEB8yGm4YOcR7gDnSgbiqTwEw8ELx/WCJNbD9HPkxnLOhZTOeItdljYwtl05t7ouZt7QHjEiPYzudQpMLsbjf0Ee/A X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: d68f2ad5-e079-4f1a-a35d-08dab2bb3b46 X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Oct 2022 16:50:44.9303 (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: cN7bAKpffTHms1NV8JQ8SF//xcQTRYrfmL5pPnUrY0jLH9sMRbuFVUACkEvT10jwFmMyjCytsc05lGiwVl5CvQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR10MB5133 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.895,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-10-20_07,2022-10-20_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 phishscore=0 suspectscore=0 spamscore=0 adultscore=0 mlxscore=0 malwarescore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2209130000 definitions=main-2210200100 X-Proofpoint-ORIG-GUID: 8pBWR-94-lnHHPEHtEoo9JIgEaQ353oE X-Proofpoint-GUID: 8pBWR-94-lnHHPEHtEoo9JIgEaQ353oE 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:245939 Archived-At: > I prefer searching in info via 's', like 's :documentation RET'. This > has also the advantage over the 'i' command to show me dark corners of a > manual which haven't been indexed properly :-) 1. We _can_ have index entries that start with `:', and we do have some. E.g., these `Key (Character) Index' entries in the Emacs manual: * :d (Dired): Operating on Files. (line 124) * :e (Dired): Operating on Files. (line 136) * :s (Dired): Operating on Files. (line 132) * :v (Dired): Operating on Files. (line 128) And _if you go to that index_ you can follow those entries to their nodes, with no problem. And we have command `info-apropos', which checks all indexes of all manuals. And with that you can input a string that starts with `:', and you can get to the locations targeted by such entries with no problem. The problem is only (?) with `i' (`Info-index'). With that you can type, say, `:d TAB', which correctly shows you the completion `:d (Dired)'. But choosing that completion takes you to the wrong node - it finds 5 matches for `d (Dired)', instead of one match for `:d (Dired)'. (It does find the desired match, but mixed in with other noise - non-matches.) 2. If we can't fix this directly, then what Michael A. says maybe points to a workaround that Emacs could provide. Many (most?) users won't have a clue about this=20 difficulty of using `i' with index entries that start with `:'. And they won't understand what's going on. What we could do, is to tell a user, when s?he tries to use `i' with a name that starts with `:', that `i' only searches for index entries with that name _minus_ the `:'. We could then suggest that s?he use `C-s :' instead. IOW, if this defect of our Info interface isn't directly fixable then we might at least let users know that (1) they can't reasonably use `i :' and (2) they can at least use `C-s :' as a workaround.