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 15:23:06 +0000 Message-ID: References: <87k09q55ue.fsf@gnus.org> <87pmijwq4v.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="10945"; 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 17:24:11 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 1o8kPK-0002ZY-VT for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 Jul 2022 17:24:11 +0200 Original-Received: from localhost ([::1]:56850 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o8kPJ-0008Az-KG for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 Jul 2022 11:24:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46532) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o8kPC-0008Ak-H8 for bug-gnu-emacs@gnu.org; Tue, 05 Jul 2022 11:24:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57393) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o8kPC-0005A8-7v for bug-gnu-emacs@gnu.org; Tue, 05 Jul 2022 11:24:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1o8kPC-0008Ds-0A for bug-gnu-emacs@gnu.org; Tue, 05 Jul 2022 11:24: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 15:24:01 +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.165703459531549 (code B ref 55853); Tue, 05 Jul 2022 15:24:01 +0000 Original-Received: (at 55853) by debbugs.gnu.org; 5 Jul 2022 15:23:15 +0000 Original-Received: from localhost ([127.0.0.1]:51290 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o8kOR-0008Cn-ID for submit@debbugs.gnu.org; Tue, 05 Jul 2022 11:23:15 -0400 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:37076) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o8kON-0008Cc-2a for 55853@debbugs.gnu.org; Tue, 05 Jul 2022 11:23:14 -0400 Original-Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 265EoT9I025122; Tue, 5 Jul 2022 15:23:10 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=HHQrahF1uKdSkqCrgiqSvYws7/ucHT63CvaM6RO9EPw=; b=t0qjUkRrJ2VtE+oysLxZQoI8LbKUYR1D6gG8W1WE6svYBvPCtiNi8eDKDswWZmjkCVyz pbTNzcga8qSrO0SepC4MlcRQCLytmaxoT/xg/mbnVcuuX5wxpMBYfkrEOflTzSYQlFBB nIAmJ4EPd2jkdlzUxh2zyAhwCGFIJp60Cq9weI/SiGL+IoSCbQt6qEXFzcdctig7jxk0 +9WD/E24+7at98mpeEKZo9kiONWf6Z+du/rg28WHX821CbdGJeIid0A5kitA+ZpHvI19 SEwLgYf8pVSN/huzczG/tEzY8wOTMhPiiB1HrLASGELKhh6OEbLlYirIo9WTOeR0gkD+ Ow== Original-Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3h2ct2efer-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 Jul 2022 15:23:09 +0000 Original-Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 265FFovY016385; Tue, 5 Jul 2022 15:23:08 GMT Original-Received: from nam12-mw2-obe.outbound.protection.outlook.com (mail-mw2nam12lp2040.outbound.protection.outlook.com [104.47.66.40]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com with ESMTP id 3h2cf2fayd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 Jul 2022 15:23:08 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dXs5Jkfw2wUZ5qdJntZlglkP3L94GNqXwJz2Ouk/U0J4J2RgQTIs4pKVQpFCdFowBguxcxJDtocFgrUu5h78oFHwOXTKqB+Pw9IQS7z6t7FmKX5MuaXydUTQhSev+VSZPI6wIK+yuGOq0xlL3pscU5wFruafPbRVNuGCxEIt8uZmnA8rRDt9kb/zrkIXHc8qBF3lyin7cMZHG/fHkc5dpWgsxaMzp+xAfFaJl3fpTv3eVQaeDp61HsXL40LVDk1XikY2w85eIJVwhdl096feLNfy4oyzfEY2W3pn8vyrS50JJVRE30WWsHBKVSbkv5adi7xd97SEG6Ivl/0N0a0hjQ== 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=HHQrahF1uKdSkqCrgiqSvYws7/ucHT63CvaM6RO9EPw=; b=LrNZZaHrT93UZ3t/T84PcJuklptgQ7XlwVQBFmYutW7ungtF3bsAyXIo1XX9c47Bz1jtgZwi/FCaVD8uFZjYvDFPhWhyC6B/PICglZWEgokdp3aOQBCG220FznxrrbdugD14m1HMdbyY8YQjqtyRo5E6FTtS6ER4Zk0u4uOCA70/qgTYqTn4ge4OonBFev4Kx8lenrCFIyFAucPClEQzahFyXNBQtlZODjve35SkmnscVRQ66AH0VPtr/jmPFoEN98Vp/sgIgq3lrXe49w6S6yYnLDgZzhXGhshJpB499fPzmw26KK4zPk7PI8p76IvO5LXnQw3p0mQLFb89/acHuQ== 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=HHQrahF1uKdSkqCrgiqSvYws7/ucHT63CvaM6RO9EPw=; b=hWUV1xjXJLi8oyKIKR0qpdR7gWjhp23Y4n+JayF0afBtl9rNSCz9phq4PzCCbdd5saIx4WnZjQHXzogW+KGjCg8Q+pGbPz7Onqc/GQU7HGo9r7ay3WtRFqXgpxb0aIQoN8PimsC0woCbTr8HOefi8PRUFkFx+ozShYpHqCmCMIo= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BN0PR10MB5208.namprd10.prod.outlook.com (2603:10b6:408:125::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5395.15; Tue, 5 Jul 2022 15:23:06 +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 15:23:06 +0000 Thread-Topic: [External] : Re: bug#55853: 28.1; Please document f#(...) syntax in Elisp manual Thread-Index: AQHYkIGOhjT/haYBhEqKH5KUS9I+T61v40mw In-Reply-To: <87pmijwq4v.fsf@web.de> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 00ac7330-b9cb-44ce-c614-08da5e9a4303 x-ms-traffictypediagnostic: BN0PR10MB5208:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: RipQiBtSvZ5qQ4vUUHXaoIOoMT7JApX2rX/GODZ0bRgbQg2/879axXwFrcO2K2Z+xuLSOFIxxGux0gqr1Mk9kbH5DRF9pCCXWovK+629lIzOA0iDi4uO71CXxzsLPETGXCV8aXxC5+R3sJs08UaDq3pRUQmtinySoWu9FHZ5jAj+HDLeAt0HCTQBf1K0L9Tp4srUO1MjSK5oWMYbVCpbDkuowrVHztDlx8gsDRIYiBk0ouMFWmNTwo2HM//fMu5juAma0I/Aj6SCe24NZgJLcHoCMHd0UCiIvmKvvF4mGArAIIB32VUTf/SQk1vppLAhFL+GJZs5FHt/IlEAQvcwTllEYJT8qVQgaFv5s+QrlJnFD/gbwTJ91rQXL5sJV1uqpwNozUK2OYrBeq48+dTD/PjtG0ZLIH4qUUsAalErrDFL0U/RhnftOhAKmkUvrgfR9iz3MPTI5YlH8lei6aSlNhZPXDJwO1PEoYdAnpZuIRcXrrxQjWl1TPBaFs0heYj1QzBvk5AXAquhLthCKuSUVOhW4hx9e19QuKGIXJ7AkYMEXFntXFW74JdvqoHIZqWYVWIDsFHMe9rBfzvhMhmGVF9JBrl+djAIxq5yPgypN46angbS3W0mYn6eU61C5dVKByRvD9PLaEikdWReJDzBnjuu09Twx+ExrngEUn6Xg8tlIPgIF0AVl+BwfcMz9L//r7flRdTKNsqFKhT9SJR72D6h2xJGjOoFfU8iOMj8EEoc532gVj/mLFOqyLphn eTbQsqKiw3WOA0/GfuE8NO/o0WCN2R7wt/7bogLOnDJfaSG6zxufILI35ptPeACfC5Z 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)(376002)(39860400002)(346002)(366004)(396003)(136003)(478600001)(54906003)(41300700001)(26005)(44832011)(9686003)(55016003)(316002)(52536014)(8936002)(6916009)(122000001)(5660300002)(38070700005)(86362001)(71200400001)(186003)(4326008)(8676002)(66556008)(66476007)(66446008)(64756008)(66946007)(76116006)(38100700002)(7696005)(6506007)(2906002)(33656002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: bR8HfPekCaWIQJAQv1wWS6gGHkj7a6e0bYt6V7diiMcVXdcwEM4oIzWHfSvXtl8H9I+ta7oCSikehVy9jCrOmDYBI2ISU3JmorDxbv0h7nRks2XAfsWBoH8orpK0wYmgJynrrBAoaWmYPWVA3JPQ1rVGyNAd3SuaG65oIGE3LnrePd7XAdc22xvyjzx+ZwaB+NEwnoVwvd9HosNL7QFSAdfmGS52wmW/t1ugDB1L25UH1yo1LFR7q5d/LA+cQdKaGd5LkhPeTF+1r69j7Sk9DJ8L15i4MAyJdz4HZjgzILZzso/ctu2UwRxUJ4Ea8V4gCcJXTooImT8nYK9ZkcATwFw0U9O8g7zytCPnXP/a4a15NYjyc3T1V+xwE+hoADI02oTB9Bt//Bm+7Xw0oFWcxOIQZSQcQRzqEElPvsbhW+Rd6P/IiPVE1UspCZAFBeJsDnrZQ5ASu5bmIb6/nNJ4wxBmxCsiAu3a99M6qhH6s8t/+GhLJ6RxowMDnrEc0OuYwtAy5RkxbbX139If5URFgvEhVi6/HY52KXRwPdAwoYKYrcmfXHcE2MNE+QgO7Bw8Jd1mVlByX5/5ACbpvB9zkQKIvAdiF9shs1fdXXt1H44yghvRrUu8h15FT9EY+f+J2kbWWtgtsfUKdOsJ28yGrv4ypvMEchN+g5T4RnFyv0rtkZpTKcC/5H9IDPSbfErVjGvrM5wC41k/wsNGn9FG+9WHuvm+FZXF2fvNrDRZb75NOrWEAn1AjEMMJT paI/7K+JhVVj5HDZETMVg5AqDIYfYJ2png1figqloJy5ZmEPcOePNmkVgrHFytTStnDYOxZ5dUaJ7XgpGTGInjW+Oj2HmmeBnL 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: 00ac7330-b9cb-44ce-c614-08da5e9a4303 X-MS-Exchange-CrossTenant-originalarrivaltime: 05 Jul 2022 15:23:06.8329 (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: WzQTVHf6IsniUf+7FwVpO4m5a2LlV2APuxL78S3u5FW/3tqV7BZeqGMk304PapG/egkNUIVOJAS44+Xavtv/ZQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN0PR10MB5208 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.517, 18.0.883 definitions=2022-07-05_12:2022-06-28, 2022-07-05 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 suspectscore=0 mlxscore=0 mlxlogscore=730 adultscore=0 spamscore=0 phishscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2204290000 definitions=main-2207050066 X-Proofpoint-GUID: ThnTgtO-ZiKvxiBS3KK-B-_C8yysBV6p X-Proofpoint-ORIG-GUID: ThnTgtO-ZiKvxiBS3KK-B-_C8yysBV6p 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:236128 Archived-At: > > But is there any chance this "pretty"-printing itself > > can be made more human-friendly / communicative? > > > > Aside from (I guess) naming the formal parameters, it > > looks like it just says "BLAT$%@#(*&{}:"|?><(/.,!!". >=20 > Well, that's what byte code looks like. Apart from that, "it" is a > clickable button that will disassemble that code for you if you click > it. Not good enough? Dunno whether it's good enough. Depends on why someone might want to understand what's printed. >From the original thread: this is apparently "special read syntax", i.e., Lisp reader syntax that's not readable by the Lisp reader but is meant to communicate something to humans. ... What the source code for the function is; what the function does (e.g., it's doc); or where it's defined -- nothing like that is conveyed in the "pretty"-print. And whether "compiled" there means byte-compiled or "native"-compiled also isn't made clear. (Dunno whether any of those missing things has now been added as part of the bug fix.) 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)?