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#55853: 28.1; Please document f#(...) syntax in Elisp manual Date: Tue, 5 Jul 2022 19:06:46 +0000 Message-ID: References: <87k09q55ue.fsf@gnus.org> <87pmijwq4v.fsf@web.de> <87o7y3s82o.fsf@web.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="2519"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "55853@debbugs.gnu.org" <55853@debbugs.gnu.org>, Lars Ingebrigtsen To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jul 05 21:08:52 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 1o8nul-0000UM-Dc for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 Jul 2022 21:08:51 +0200 Original-Received: from localhost ([::1]:45154 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o8nuk-0004S9-9V for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 Jul 2022 15:08:50 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45382) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o8ntz-0003Jc-6G for bug-gnu-emacs@gnu.org; Tue, 05 Jul 2022 15:08:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57800) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o8nty-0000AL-U3 for bug-gnu-emacs@gnu.org; Tue, 05 Jul 2022 15:08:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1o8nty-0003p9-Oo for bug-gnu-emacs@gnu.org; Tue, 05 Jul 2022 15:08: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: Tue, 05 Jul 2022 19:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55853 X-GNU-PR-Package: emacs Original-Received: via spool by 55853-submit@debbugs.gnu.org id=B55853.165704803114536 (code B ref 55853); Tue, 05 Jul 2022 19:08:02 +0000 Original-Received: (at 55853) by debbugs.gnu.org; 5 Jul 2022 19:07:11 +0000 Original-Received: from localhost ([127.0.0.1]:51676 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o8nt5-0003mB-G6 for submit@debbugs.gnu.org; Tue, 05 Jul 2022 15:07:11 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:22698) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o8nso-0003lR-OK for 55853@debbugs.gnu.org; Tue, 05 Jul 2022 15:07:05 -0400 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 265HEXKT009213; Tue, 5 Jul 2022 19: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-2021-07-09; bh=zli17BumwU9y93c8bk0R7EJRcrzV5BUuwmegsMXRPgY=; b=u3/2oarKybWfjUW4s6pPA9QCbjgZhK4SjvbF8Cv/5khuQw40DBVMV0RYiDo7xv2rY+RK 8dG5Hz7exdR1YjkyTD9Ks85QbGJpMw/76/IZb3ey931ip1DA9HQNneJmKPaBZAJXO9TD pdCCq/h0IgsO8L4zfmrl/4kfO7m1oRUY6vbm8HTCpGxJom1vKUZ9TsBkkh3Z2RBXhYVL WG11TapUvY0I5I1SWU+HflB1yz0z2BnmwZTyt7c+vweW8hLHdGu+X3rRa2oephmI1+tl oplBZDS0OOi6r8wy5pZ428xGWuw0RFzcTjPhSag11uT47ETtWeVnfanzaxsaUP5xENgs MA== Original-Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3h2cm0q5w3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 Jul 2022 19:06:49 +0000 Original-Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 265J5Pji025922; Tue, 5 Jul 2022 19:06:47 GMT Original-Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2169.outbound.protection.outlook.com [104.47.58.169]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com with ESMTP id 3h2cf8q6e1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 Jul 2022 19:06:47 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jZgg3An/xmjPOa4QFbRFWUfeRTkk8FhJplyfcfKjfn5KB3PW7mp8A/GZQuGn5tvbVktk3odQ/x/VaHuE4t1pGSXwYtWjPo6V30YyNyC/+7OqT7Ux6XFvVyMQeyc2iJUVkDWA7rELqHaVAPyA4CH0wi4GzitZA47x6s2znk8QH92OIYgz+w3M6ToDOdIMLdlHQaezOm8fuT+5yL7WyvF4TNRnR95ioj8XBts3rYBIuJT21k0drVR6r9ZTuCF4tVXlkj83lztv8h36H9GryM5pNhnL7F9YVX3eXp8v42e2VIV5xUYkYdROe5ouCFRAIcz8AYrHPS2kOvIR8SSnbU1SIg== 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=zli17BumwU9y93c8bk0R7EJRcrzV5BUuwmegsMXRPgY=; b=DUymkznPByPlD2rhWDUfDDCCC6Y9O32wI+b/LMPRGu97jnVW1MJNy44qfjpJHrUDGsb3srmqXExYPFVIytxCtVDj1WGI8qd5+waPRPY2ZfrD+w8z9Hmjp/8yKDPUqyyB99xEHZzGM3pv8ZSiusfDbQfHMtmGP+hGGTzT3CmgpUrW7ycyqUluktbtDrbLOoLt3CdLiEZsKIzQuEl25fyk6trUlPih+7Rzv6y/V95fs6kfiCIBnfQdq4rdkFKaY/c6TXnEwcsQgXdWSAgkHtBBuIlpRu6AXAy4l2kDAUL7G+JHx/q5Lp19eLiEaKz6LWp4Q1r4fSy/iu5c1UKj4wYrIw== 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=zli17BumwU9y93c8bk0R7EJRcrzV5BUuwmegsMXRPgY=; b=ATHFTnBkMu46nNwY5CVb52v6a0VAREhLefjfh/EO9YymOx6f327Ecsd6uk0Uc/j4pIPfKalUcG63g1qgijshfkPbngvShlFK9mv2gRrjpprrNyOeGYrnrJc+wAcLiUU8fa31psvi7a6Q9/gZ26ep5WSzqYOMy1rpM5g9ADBvBP8= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by MWHPR10MB1840.namprd10.prod.outlook.com (2603:10b6:300:10b::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5395.18; Tue, 5 Jul 2022 19:06:46 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::581b:ae2f:16b9:80fb]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::581b:ae2f:16b9:80fb%7]) with mapi id 15.20.5395.022; Tue, 5 Jul 2022 19:06:46 +0000 Thread-Topic: [External] : Re: bug#55853: 28.1; Please document f#(...) syntax in Elisp manual Thread-Index: AQHYkKDY692Kjntao0qgXVHNG+cS/q1wIaHQ In-Reply-To: <87o7y3s82o.fsf@web.de> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 40ac1456-8e48-4b43-cfc1-08da5eb98193 x-ms-traffictypediagnostic: MWHPR10MB1840:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: xR2zoVnZ067HkBZTdBxE9fr/YE927e61KmNCAf6AbaINmXEAUZNHC/QPxa+gOHEvA36Cld/zmSLN87WrFncv3kPEgBjX9Mw2hJjI+jOFjAURepohmHo/Yg4Ng+ab7VNpZbZbFOEoL+tlxnhFaziLf13WFH0maDO6W8VYuV3Kaz4cOL1iWwoAWmUpWQSF9zcXMTsEw8oAGchg2u6hMYnT0RIQY1TzaKlrkhI9oBW3X9qAZD3oFpxR5vmqojowSqYFqtZu1V7TcWIfmJvLrfuSrynujDdA4qMPVQMqbtpDh/wkzH8b3STGaVce6WK8VtyXC4y6pp84JVmrGLLX7ie0Kp4wQLxUU/PQ/RlYEqdjzHcaQGIFYwfAXypw9yLXEKl8YzbGYBWcr7j8dYjJ0ToQUaRFlXw6RkukpERsVMJT+tceGJxLf3TmINB1/p7wDz2toBxmyG+mCNrayeyNfycjbEgsCGFiBbwA4F7Jq2MLLsz5xfQqp0/4eumv66I1eg5XfIkilorCvv5BMhIybxAfcdWFRmORgFlEZ2C05ENSvI0j14RTENUym7Koe4bkjQii+T02Bh9o02bobmMdq4cxmMzqGa+crsyaM8aeA7/r8aw7pTG+I66AMGQuQT3hyOWBRVsqRMjAD0bB2U/5zFAnA6NQqYjc/kAAU5BNtdTW84QNIz8acCq4fbc8PuimYpvE1WqwDdFnZ6zUlUHSvbB5xTMf1ZlCprja+Ut2Z2XZtnY5ilkkSnp+PpznurTUA GRQj5YkSjz7whq2s8KVp6QP3qB9vY0om5EJeZdRHlt3Gqa6gfB5eBbJqipxqPh82We9 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:(13230016)(396003)(366004)(39860400002)(346002)(376002)(136003)(76116006)(8676002)(4326008)(64756008)(66446008)(66946007)(66556008)(66476007)(2906002)(86362001)(38100700002)(5660300002)(122000001)(8936002)(52536014)(38070700005)(55016003)(44832011)(41300700001)(26005)(9686003)(186003)(7696005)(6506007)(316002)(54906003)(6916009)(478600001)(71200400001)(33656002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: CrdK3WvWxKRPjfijVVFm3L0ey/W/fbjLket0bgeC8M0VIwvYtNHooVokK8UH8RdZTtkuDRBwb7qRcSXMSskL526+92uB/rrfRbMX6VfrqL2RGyv2xGt6mXtIr+jOqfdsOHESHgY8dvwXgjkyMuAb2SajvPruCgXiXGWUSoyCM79BzMEez0lAvDm2jiOOJTVqB/1l7N4KCmFeK5sapYiKg5lAW+1m7y7KE22ZImR/OwhmmkHOQ2kWJy2eWIhRQxraSOelo2pbcxbQWj8c6XOcBqblPfWKTYV28giVufJ5Qc417BXfPzjsYEk0YRZw0ANiijY+iiH9+VdTKxKKO8f9n7XB+THOEi8sDLivZk+ig/DjNV46WkAJ0gCZHOhaEZuyO6dl5RkM5HoJ3uwwtN9ORjfXia1wPX+eRsRNCtlSY74qUhROpjixZsvdm1Z0TJ5FzG3UCLR6wey0+/VoDvrhirAEB14vVOhfhjbaEN2Wgm0eIVeHMlQLD0MAIGHGRrQ9+Q50ahU3tWYGr26hpuFwePEVtVCtez14NyZ/wo+NBlKCTYAz/dqLA5Hw5jaWOdA7anvjqOWZT4Jf/6HPNeUnyHxx8d/JB/qdQQxU8WRzZi0Qv4ffallNhuU45rLh2iFrVE4larlOpVFMVhEqIUAVPj2JRzAW5TIAQGaNRLUFUV+M5xI6V2kRw19soqOm+wWrtmTLdhxB3ZuAxIg/duOB6TSPc0kcBBUOX36vpWSqZ0sKBSdpjzhEpt/ALu 3NwB6MMBwctVODkKLzNC2WtS3qR1T1aAN28wtPZHh45tfWWprHsxOASj37hS32719cIn0wmpzut1C0jkdg3FrUvaQNaOLwCvwO 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: 40ac1456-8e48-4b43-cfc1-08da5eb98193 X-MS-Exchange-CrossTenant-originalarrivaltime: 05 Jul 2022 19:06:46.2098 (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: jn+dk9Fcx4NV7WVBt9XFRzY2EZva+xLEfTbpvmcQqFXua/mZzSvTPX8o8TURj6/K2TthkbKMQFz1DYRYGoCyfQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR10MB1840 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.517, 18.0.883 definitions=2022-07-05_16:2022-06-28, 2022-07-05 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 adultscore=0 suspectscore=0 malwarescore=0 bulkscore=0 mlxlogscore=930 phishscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2204290000 definitions=main-2207050083 X-Proofpoint-GUID: oevM8qgaZ2L66eSzozWgwg6LHWXA6wRF X-Proofpoint-ORIG-GUID: oevM8qgaZ2L66eSzozWgwg6LHWXA6wRF 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:236168 Archived-At: > > Maybe instead of (or in addition to) a disassembly, a > > user could be pointed - a least in some cases - to the > > original source code (Lisp or C)? >=20 > Are there such cases? The place is not always well defined. >=20 > In the cited original thread, when you see >=20 > org-file-apps-windowsnt is a variable defined in `org.el'. >=20 > in the C-h v popup you just click on the "org.el" button and are > directly guided to the source of the byte-code function. We can't get > much better I guess since we don't save the exact position of every > lambda expression when compiling. >=20 > If the byte-code function is named, you can click on the name that will > likely be around. And if it has not, it's probably not trivial to find > a related place of a definition (if there is one). >=20 > So, hard to answer without a real-life example where this would > actually be a real improvement. Certainly there are cases where there's no reasonable way to locate where the thing was defined. But when there is a reasonable way it's good to point to the definition/source code. For cases where the name is displayed and you can click it to go to some text with a link to the source, there's no great problem (but perhaps getting there could be more direct). My point was that getting to the source code is what a user wants more often than getting a disassembled representation.