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: Thu, 9 Jun 2022 14:04:52 +0000 Message-ID: References: <87k09q55ue.fsf@gnus.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="20888"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "55853@debbugs.gnu.org" <55853@debbugs.gnu.org> To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jun 09 17:23:42 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 1nzK0Z-0005AH-8e for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 09 Jun 2022 17:23:39 +0200 Original-Received: from localhost ([::1]:54174 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nzK0Y-0000iI-5S for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 09 Jun 2022 11:23:38 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53460) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzInS-0006hh-2R for bug-gnu-emacs@gnu.org; Thu, 09 Jun 2022 10:06:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53230) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nzInR-0000TB-Qd for bug-gnu-emacs@gnu.org; Thu, 09 Jun 2022 10:06:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nzInR-0006k0-Ks for bug-gnu-emacs@gnu.org; Thu, 09 Jun 2022 10:06:01 -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, 09 Jun 2022 14:06: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.165478350425836 (code B ref 55853); Thu, 09 Jun 2022 14:06:01 +0000 Original-Received: (at 55853) by debbugs.gnu.org; 9 Jun 2022 14:05:04 +0000 Original-Received: from localhost ([127.0.0.1]:47127 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nzImT-0006iM-6Z for submit@debbugs.gnu.org; Thu, 09 Jun 2022 10:05:04 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:37608) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nzImP-0006i3-Sq for 55853@debbugs.gnu.org; Thu, 09 Jun 2022 10:05:00 -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 259CeDmr019619; Thu, 9 Jun 2022 14:04:55 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=rWDUH7oWXidqz3twQWWd0QF7bgP9eUwn2XX6aEvJuRI=; b=E36PIE2dnW5xdDZ8XjvyRckv82D5noBTSER6ZNB+5V82n9J9RJED3t9RmR5WeaePcCjk niUsUvk0P/4/eLBHwx/XdQxNck7LlsRirq3EyYOLQl/bz8xJzWDZ6l5u7iXb5IpG/yvH wgaTs7F77XqRZJ4Imuz+zyEiJLFoBBqgrCwiTG9p9Jq1xgJu65vsJvvnR/vQLm9GVCMN hiinE8mMBG0UvysPbHu12tKkSZ6fuBr3WintCfz1/OJjB9vuahho3UBMWl2FAsXrMZaq l7909lFUwK8EVcKA9mwGm4mBr5BPdaUjNYBigRb5QDyXZ8be9Kg0+ynt8QH/D+llmZcy tQ== 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 3gfydqu7t0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 09 Jun 2022 14:04:55 +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 259Du92a023883; Thu, 9 Jun 2022 14:04:54 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2108.outbound.protection.outlook.com [104.47.58.108]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com with ESMTP id 3gfwu4rupu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 09 Jun 2022 14:04:54 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ga8tNFYVaNDNJKnVSHn33sJBfxBm97Xu3ZEN/Ok2jauWAeS20G95kBfuJjrPxSgd8RFNQUzOMTLPWqhlJgg12uwK4y/Hame6AipuoldIycymlVCJLhiBU+bs6LLlGmZzWqH6JbwZ4USGVtRQCT09ahbAjCnKzUY947LkI/ns/8oLqqgwqFUUxfyVEg/WeQsody+0j610qx65IR+2lrNwFu/74/pSIKs74GfpSMLmW0DfzrrbRFWozod4nsaU21dsfxSw1k6HXObPN0do4iNjU9jsCWe9hGW0FueONC9OaLJLD+jLsjftOVw0/zkVtrcvU9Lt4jUrWgUNu3de6rsZVQ== 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=rWDUH7oWXidqz3twQWWd0QF7bgP9eUwn2XX6aEvJuRI=; b=Z90LEtkMI1Ri9Wz+yRg8jhpv6/NcEaaX1lstYvfIQv5OY3N6hK1BjReB+zvHFkLZcLlnKD5GZtRsv5FDpU3RDI404GtOXkhlPYG4gtughKQfcescc4X89YuJwjKI6bX+IQaeWIS94d+gsXy9QG1vTa5IaSI+P2itxunku/P6q4uwA392mNDaO0NLOyhtmatAzMR/Zf9ISNDyITXLtk/ln/eeUcVOMXclHri7yb+LYpyhptsal8mVXjgBqiUeF6+IFXB8FvL6QWh4GjcCGD+1JJ0fpHlvrXqbItqty9627QNGX1FhSqgdi2QOnp8k4UsgAInilvZYTt/R/RDcWjCRtw== 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=rWDUH7oWXidqz3twQWWd0QF7bgP9eUwn2XX6aEvJuRI=; b=BJ03OoKt/PABdefJFc+UjaRSuReY3YQNQ1xUyT1GS+YBS+h/9PQVtx4JuyC0pQM0b3Mmc5/OBT+Mo3Gd043iJ0NcOjm3C2FLJb7ymSHTh5tNA39yCUw/ILNCkK4G4WAu/eketrKknuYBDMNQKL239hFWSorsPnha2XLOnsH+S5c= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by CH2PR10MB3798.namprd10.prod.outlook.com (2603:10b6:610:c::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.13; Thu, 9 Jun 2022 14:04:52 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::818c:10bf:c1b5:e224]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::818c:10bf:c1b5:e224%4]) with mapi id 15.20.5332.013; Thu, 9 Jun 2022 14:04:52 +0000 Thread-Topic: [External] : Re: bug#55853: 28.1; Please document f#(...) syntax in Elisp manual Thread-Index: Adh7WJjsR/Gcl9UdTvCqdnQ43fXlmQAq3aSbAAE+RgA= In-Reply-To: <87k09q55ue.fsf@gnus.org> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 2b4b8ac7-dfcc-4fc9-26fd-08da4a210623 x-ms-traffictypediagnostic: CH2PR10MB3798:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 9pJqYnqG/pG531uenPUveOFvhEQcQmLZCNlyBYHrR62npIMfhL6HTVNko3k8iS7wMT8uJPyXqCUjzEgfJLPX+n3TvUsiR52CH531+5SqoG0dCiRwJiQnLpraC0odHZCyWko+sXwPtR41ot4X84tAz9HWZRBNuDedGMRANt6uXWLc7baVZNxzOiK3tHj6U++QNbUjZ7pLZtt2MPVGuQ8GqYDVi/wS+qLzeVvBl4kRivbYC3v30rWJUNpIXlaPnAyRh0nDGRJ6xGq14wSDxs7IWlw2WisPFrCem4uGntR3RttPHjlPTdHGUXuJupnRG1c8LoLklbnlTEadqYt+0v2WjL/gMlRvU6bngGytBbPwkxuXf1BLCMJMgg3YLhcWSg8VjHH75Og6cgwr4vo0xJj+8iK2a+C1RIMt+31aK+e9XOT7vBGLMorl2ZwdW+lmTLp9gs/Ug5nYktX02rS/vNm5jd6gpBBSD87xTM8f8UpckM1+EnZa3l9v+huOpgu5exnS2tp2xAtnKwwq66CdUMAf6CpYp44ikPtuE/s+IB1zPvKeZIUGvXHiGREYqPe63LgJy22WgUH7PPBnV4RjbbNt9N0t45OnfrzsTDjCLzM44OvCa+1g57R1OWHfsHqb4zHQhFXQd6W6tY29rTwRJ8Aexu4dsnoY28tK8zjx0jqLI20EGhOlelX3ZoBn93FTlF7v6FI/wc2clL8QyJpDkQNLKgAx4U3iSPI1wQjCiEQnY/Dhi96q8J9/s4+CXR0y1 xEYyFsb9VgWkgLDJIA4qQa26oFfstCLOIOBcSB+Qvt99pIjDN0eiANras06nWm5SStiASRmJSg06eKXtuMymXIfqQ== 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:(13230001)(366004)(38100700002)(6916009)(33656002)(55016003)(26005)(2906002)(9686003)(44832011)(122000001)(6506007)(316002)(86362001)(83380400001)(38070700005)(7696005)(71200400001)(66446008)(8676002)(4326008)(64756008)(66476007)(186003)(966005)(66946007)(76116006)(52536014)(5660300002)(66556008)(508600001)(8936002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: RxzsRCzt7m4SbIeNzQwtvmcqyt3g3ZGd6VISUgDknla6eVU5fzHg2P98MDMeps09vhDfDaR0ccsL604ipqBbD4bWA2q+2eDpgYCO8M7gs6y5VFkopbJApUAnbbP9XKJh+PPvLankcClO8D0GryBnOuGrA32k1Gk/hudS142Hwmg9gEZ6Yu5pxY42TM/R1Y2/W/Qav7YcP2DRbtvVH0DFZu5SJJOZk06hb0y38i6IHStqnMUEsrTC0K7aY3RiXcAQ1kZ0B2rg7eAhCPVe+tKuSREjiqKsGx23wnLVGWl2HoAgwOAPL+cWRjTkuzdl94Lyxx2DVgYHJSG7tcc+zqP4ejRT9cIth2Y2K8wISHWXdM4JGz16zwio12Pbt/rWasOA3xQVUEU8sv9jaFPRBJ+zCI2PZovsnpjjW0njpNaPhz593hhhfOegFscWNQjgGuLwwzoWpNtPW7oC0ZlDCyWqjnAozlmp79P1MacSs2UQHxB6zjfU8G8nrkS7j8Nw1/HSqXNZvQ3Pj9IDdDFfvpZlpq0Ql71VTPjJJUPO3baqjrH6s4Uxr5WOpFcQd++9VT9PyhZRyBaQ7tDTyfSOLEN8rJOaSNgwB60V9Ubg/4CDnMUVLZ5zuszqXD6T0zzHV1pQ6ZW1pZkGnM2iObRmw709CDnPMN/IaBQMXHbOecwoJORpXZIFJ3E0R3UcuC7g5EVPDz/2EPQ6S+AnB8CSyCnGxIax0jrZxjkROlQFsDrazfv1u+/aE2W4/OHZhU +KSzc1ZUqNxBbrRr0fUkIUUA/N9geQkRU3IAZrXFfwa23Ugs+iVwifmYjdq4l0jVtsQm+TJQDM7VpmlM2AVQTM1S3wDKrafo/l 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: 2b4b8ac7-dfcc-4fc9-26fd-08da4a210623 X-MS-Exchange-CrossTenant-originalarrivaltime: 09 Jun 2022 14:04:52.3064 (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: oXxJjDrIow86hrjzm0Ov+lf9rWNCPIqtYWmVALhtZULAnvtAO7DCIKYYIGbYUzG5T1qsRF0Qor7xvTzPOO0jIw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR10MB3798 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.517, 18.0.874 definitions=2022-06-09_11:2022-06-09, 2022-06-09 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxscore=0 adultscore=0 spamscore=0 suspectscore=0 bulkscore=0 malwarescore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2204290000 definitions=main-2206090057 X-Proofpoint-GUID: 0MKMbP2C3c63YXtPS8BJwSsPIKLtxF9Q X-Proofpoint-ORIG-GUID: 0MKMbP2C3c63YXtPS8BJwSsPIKLtxF9Q 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:234100 Archived-At: > > See https://urldefense.com/v3/__https://stackoverflow.com/q/72547221/72= 9907 > __;!!ACWV5N9M2RV99hQ!Js5VF7KbuZreJUFSLAH2FrOVle2g3oyTYcFXS7qlnAwG8QAl9v > GcS1skzoz2U2AgbNowlTxv7NJQ$ . > > > > Users see this #f(...) syntax. They should be able to consult the > > doc in some way to find out what it is/means. Please consider > > documenting it in the Elisp manual. Thx. >=20 > From the URL: >=20 > The syntax in question is in the following expression >=20 > ((remote . emacs) > (system . #f(compiled-function > (file path) > #)) > (t . #f(compiled-function > (file path) > #))) >=20 > It's from: >=20 > (cl-defmethod cl-print-object ((object compiled-function) stream) > (unless stream (setq stream standard-output)) > ;; We use "#f(...)" rather than "#<...>" so that pp.el gives better > results. > (princ "#f(compiled-function " stream) >=20 > I.e., it's from the "pretty" version of prin1, and is not meant to be > readable by the Lisp reader. >=20 > I've now mentioned this in the Special Read Syntax node in the lispref > manual in Emacs 28.2. Thanks, that's a start (and all that the bug report requested: document in the manual). 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$%@#(*&{}:"|?><(/.,!!". https://stackoverflow.com/a/72561466/729907