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#47762: Doc of `macroexp-file-name' (Emacs 28) Date: Tue, 13 Apr 2021 22:34:57 +0000 Message-ID: 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="39709"; mail-complaints-to="usenet@ciao.gmane.io" To: 47762@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Apr 14 00:36:12 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 1lWRdk-000AAR-LA for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 14 Apr 2021 00:36:12 +0200 Original-Received: from localhost ([::1]:51172 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lWRdj-0002CI-92 for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 13 Apr 2021 18:36:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40030) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lWRda-0002C4-RI for bug-gnu-emacs@gnu.org; Tue, 13 Apr 2021 18:36:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49564) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lWRda-0003HG-J3 for bug-gnu-emacs@gnu.org; Tue, 13 Apr 2021 18:36:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lWRda-0007uo-Gt for bug-gnu-emacs@gnu.org; Tue, 13 Apr 2021 18:36: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, 13 Apr 2021 22:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 47762 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.161835330830353 (code B ref -1); Tue, 13 Apr 2021 22:36:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 13 Apr 2021 22:35:08 +0000 Original-Received: from localhost ([127.0.0.1]:32877 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lWRch-0007tV-Kd for submit@debbugs.gnu.org; Tue, 13 Apr 2021 18:35:07 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:52148) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lWRcg-0007tL-IL for submit@debbugs.gnu.org; Tue, 13 Apr 2021 18:35:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39732) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lWRcg-0001ms-9n for bug-gnu-emacs@gnu.org; Tue, 13 Apr 2021 18:35:06 -0400 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:50188) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lWRcd-0002jP-KK for bug-gnu-emacs@gnu.org; Tue, 13 Apr 2021 18:35:05 -0400 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 13DMU5Xk147447 for ; Tue, 13 Apr 2021 22:34:59 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=Qp69aN9Wu1zSXq1qZ1XUS4mxHjo9UsdNKuEtlAv1p0U=; b=zUo53w8SM8wFUrp65DCdz32V4nkT3P8vqW6M7FuD79Y7brDrz3oWojVozhKKNCanHkau Nplfd/17t11ST8zZCSuoHwxGB5oC+D5pD6gNX2XVYd6tjvpDxFKnoI92+sWiUGXI6wxv 630jrd85BoZibUWnPEm93YmaBnACmOye4ri/Eu37/g1ZS5QZ1zuCBfqaBfFFQdEppUoK Y70xc1gXrOvUG3M0bmsWnEyxLvPUV2VXd/6o175u32zqcJVT0JRNUT2B3FEwdBuUv2eK bedAa+Lm6DmSvhTwxd4OBb7w5EycdM5q40YT62Uf4hpWl0F1GPi3BDJGhvSPl7oZ6PN0 wg== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2130.oracle.com with ESMTP id 37u1hbgr47-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 13 Apr 2021 22:34:59 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 13DMTfak092640 for ; Tue, 13 Apr 2021 22:34:59 GMT Original-Received: from nam02-bl2-obe.outbound.protection.outlook.com (mail-bl2nam02lp2058.outbound.protection.outlook.com [104.47.38.58]) by aserp3020.oracle.com with ESMTP id 37unx0cyyy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 13 Apr 2021 22:34:58 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=FH9ygIatnnpp7HQQuICpIkn9dca1PMGzBmVR+KfoCy6MLOvuqfXPXri+GEx/T4Gnyq3smZl7jtNtUyuwHaGbnkuVcivoqUL4f6zMfg/tT15TvSaKgIzz36XUcpqElsUWs+QtDhYNWmwghLxvMobSSwe9/oqZAPuq0RaAViOwVn6rpsZnUs5UU+vL2CxMjEHUYA64nTQtEIk0PMTjSE1oNqDkRAmHPIabUzpCrv64iGcUkVX3IUd4bD/eXFY836muLGCVxqOauEWTD3PBV5u6KDZn7cEiXMwMYGTA42L0XBmuBwJ6LolSlU10tiyZvscOHIgK6Vi1d2pn3N9DAwj8bw== 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=Qp69aN9Wu1zSXq1qZ1XUS4mxHjo9UsdNKuEtlAv1p0U=; b=nt0GqlWqy/+5aI0IOeNXXQY9GZaEKnsxm9XwIUkrNomfgDIU9tSBbyzVRfber0P6Y5Tz+lEgaNAUgw3PlalpIOv3SZRMjGrLtoyQE59cDrk74ZgB4C25Qu5Vee8bJVK8/+K4DJUBNlMy6ztkSsFvSnv4Qxwlhm8ZDO/jRCfm5zoGQn/dZ6QUS3Rdu51sT2wLW1SfE/mLJ2RsgGuHPWLctmJ4Y1840LT2mJUpxsX2LCTv3udTflR0Id5wfVIpe9mmnhusFfdSIrWds82STAlg2wyPFa+8U48y1EVgWJdw29pfsW/dSTxt5rZMrdJ0Ayx5UIa2ujmVXSTb0XjhIyeW2w== 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=Qp69aN9Wu1zSXq1qZ1XUS4mxHjo9UsdNKuEtlAv1p0U=; b=wpHMdaoM2yCuQsrGC9mNlerfiJVNmnhQJc6095cU7Izt3/NiM7fcAOrsS3DpSwHGB5A4zMAAW2PoKpHNNQUKC/WXzy2Iys0WYWqYRtAbWLPfBd7KDlElziJ+w8vmKw0yYvSMYbbUAPDUO+Ejz3akRYKaNPOHzMRJdZO/oyV/jDs= Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com (2603:10b6:806:11b::15) by SA2PR10MB4492.namprd10.prod.outlook.com (2603:10b6:806:11f::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4042.16; Tue, 13 Apr 2021 22:34:57 +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.4020.022; Tue, 13 Apr 2021 22:34:57 +0000 Thread-Topic: Doc of `macroexp-file-name' (Emacs 28) Thread-Index: AdcwtSyoWLJoZL+pTFWwKUZplt1ivA== 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: 7011ed21-7ad7-4d53-a1b3-08d8fecc5dd7 x-ms-traffictypediagnostic: SA2PR10MB4492: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: LrFSdBuKcc+eXG9enxeYLC5sqbVViiBbyW9MlEpXTYqaS7I/wYcw+sTUvi5Tw+RAsRI/SBhe6C2xnt1OoQ2kqkCZJRSyHkrknSDTxIptS4Y02eCZqxQq3vLYc+UVRracfdafQ2gEZ12x2KrTporVwxZiTC85wzrB3XtLD4egCzKPAK/k4oJulcJUSdkkMrmmgWYVom9KzZU3Hv0lLP32Wf1tshjQnMd5ZQ3vd94wcn/gIXUsnTJ8oUItv/aH/g5aLg6k0bSKkV2yeqJal8LeiOlXO1oEQ29xzvjEC/UmNklAhdK4dvF8kE+cTKGkLNMvjE2+pP7ZazAX3fqSpHkisNuoYuXRuU+6VVzqvlkJjSxsgjy9OMVE7kx8neVlKSv+MvT8CYKZ5Fdr5qsWn0GyMC1NGMOSwxGUL9MdLe6mbDVdUNhrBR2XN/XmJR+2S8DTj0NPbUEOBzPeYq5og0j31MVC3fqSUaiv3ENzaD0XvngUwMYYzX8D6xmSOmsjIjL77MOnpa4Sgnvk1NjKw4XCDgWkeyIlXaImQYTcaU7clwdyLfYtkWxzo1QwpQfo6pPjpWfh2sJHPhZUvc6ms3oJKE1glLlThV8rYX0Mv3vddzrkIChA9ph3sdLpEZJ/fgHDgTawpZK0F68rqlX4zecnvQcnBjC2d2WsRI4nkItFKtKACyiJ73O6amPSv++/+S/zj7wNNvETf/MEMiIqnfL8Y7AU9P70QdIyXdC5shnWV8c= 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:(396003)(136003)(346002)(366004)(376002)(39860400002)(7696005)(316002)(71200400001)(478600001)(6506007)(966005)(26005)(44832011)(5660300002)(6916009)(186003)(83380400001)(52536014)(122000001)(38100700002)(9686003)(8936002)(33656002)(55016002)(66946007)(76116006)(2906002)(45080400002)(66446008)(64756008)(66556008)(66476007)(86362001)(8676002)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: fjskepWSaCQ5iRjT8p0uh2+y+OXZerN5x0iW93JzHNKSreQiXjxVBzHozYc3AGwLmrl+Hgvtv5Wxkmafkii8FjUxLFuQPMY8X/2+MaOC7URzGjQOgPwgZ2ra87A/lrklvxomyMNwmL6NXsn9j0BBQvvg254vOwyVt3s+/ScaSQLbfI84SpU34ACGNm1Q9aezxxqptIngEpj2LDoCm4l0+3jyF56WcxsIYm/ag4rm5q9jBupOoFiLuP/zUcp3MInYowtJNaN3A/bwXl4gvl34bo2HzDEp7aBEPQCw7mTkHSyDfhxtOeTk3fuRXuAs5IQ05iQALA6bnm7GE5pa9l4vvahL9TEAGfZGG/XoZGZXGlrYkite+O/SaQJ/m5flZkisEB2Tmt+CXg4jV0lnRZZkiYCcDzxLJfWjyxIg7vvPl9UWZdZ0K3V0w4eH8Nw4C2x7DZIv+crSyffXHpawAGzrz/lB7kqIKKsjuNZYs6dW7pzg7ryruFD8fc8otPOmKirofa1QCB9YbIL393AKJgVW+cHXkyXYQWl3FUrQ0L9J1gXuZNbH4tHrXyv7++c3JF4VQxNfEgPY66z8cSWURlOZRXpYWfomqNZ/YeOsoEeL16UmtTts5oWO9kTIuAWUB1J7XpD59py3OcydZJNCdt3NM0P2ROTO4Z5y8Dq79ncNbf+cqVTZp0le7NGSrJsXnXcYL3MGM7+HrWsVQS3Cg5D/kfDTTQ1EYGcUA61ufdZazE07B38Ou5GnOfYTu255 iBzQSbGnxpZv8cGmQlWrIURUhor3H3U8SX/W1IOAsDQgfoDzP/AA4x7nV9vALjbeYJm1T64aMwXhjRANx00WMjsUiLYho9euTr 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: 7011ed21-7ad7-4d53-a1b3-08d8fecc5dd7 X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Apr 2021 22:34:57.3145 (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: 4w9At3/Rwm4rBOOpzrhHV0uLeqTKKgIvUVnGcGU6SDgw8MNw3rpNNabcUPpV2liYWXVSvzd9ThDDc2PzQ7E9Lw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA2PR10MB4492 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9953 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 suspectscore=0 mlxscore=0 malwarescore=0 adultscore=0 bulkscore=0 spamscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104130146 X-Proofpoint-GUID: tq3dRHB9-AAmmIdEDFXOtJgZkpo1Sm1O X-Proofpoint-ORIG-GUID: tq3dRHB9-AAmmIdEDFXOtJgZkpo1Sm1O X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9953 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 priorityscore=1501 clxscore=1015 adultscore=0 mlxlogscore=999 impostorscore=0 malwarescore=0 lowpriorityscore=0 spamscore=0 phishscore=0 bulkscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104130146 Received-SPF: pass client-ip=141.146.126.79; envelope-from=drew.adams@oracle.com; helo=aserp2130.oracle.com X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:203991 Archived-At: I don't have Emacs 28 code, where this function is apparently defined. I'm going by what is shown here: https://emacs.stackexchange.com/a/64404/105 The doc string shown there is this: Return the name of the file from which the code comes. Returns nil when we do not know. A non-nil result is expected to be reliable when called from a macro in or= der to find the file in which the macro's call was found, and it should be reliable as well when used at the top-level of a file. Other uses risk returning non-nil value that point to the wrong file. Please consider clarifying the doc for this function. For example, just what code is meant here: "the file from which the code comes"? ^^^^^^^^ Looking at the source code doesn't help understanding of the function either (at least in releases prior to Emacs 28). The doc string for variable `current-load-file' just says "Used for internal purposes by `load'.", and there's no doc string at all for variable `byte-compile-current-file'. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19041 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''