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: [External] : Re: bug#47762: Doc of `macroexp-file-name' (Emacs 28) Date: Wed, 14 Apr 2021 14:30:23 +0000 Message-ID: References: <83a6q11j36.fsf@gnu.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="23619"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "47762-done@debbugs.gnu.org" <47762-done@debbugs.gnu.org> To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Apr 14 16:31:50 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 1lWgYY-00064K-Jx for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 14 Apr 2021 16:31:50 +0200 Original-Received: from localhost ([::1]:41118 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lWgYX-0001LO-J6 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 14 Apr 2021 10:31:49 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42120) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lWgXm-0001LF-Bw for bug-gnu-emacs@gnu.org; Wed, 14 Apr 2021 10:31:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52129) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lWgXl-0005yo-WE for bug-gnu-emacs@gnu.org; Wed, 14 Apr 2021 10:31:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lWgXl-0001fx-JZ for bug-gnu-emacs@gnu.org; Wed, 14 Apr 2021 10:31: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: Wed, 14 Apr 2021 14:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 47762 X-GNU-PR-Package: emacs Original-Received: via spool by 47762-done@debbugs.gnu.org id=D47762.16184106406414 (code D ref 47762); Wed, 14 Apr 2021 14:31:01 +0000 Original-Received: (at 47762-done) by debbugs.gnu.org; 14 Apr 2021 14:30:40 +0000 Original-Received: from localhost ([127.0.0.1]:35442 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lWgXQ-0001fO-38 for submit@debbugs.gnu.org; Wed, 14 Apr 2021 10:30:40 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:60444) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lWgXO-0001f9-5M for 47762-done@debbugs.gnu.org; Wed, 14 Apr 2021 10:30:38 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 13EEUWQ3112494; Wed, 14 Apr 2021 14:30:32 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-2020-01-29; bh=j8S9hzjq7C4GV8CaU5VUeqnASw7leOIcWoEaFh6f1/c=; b=huGiFk/0CsgZ92fGvuwwWKgHHqdH+26FwjHwN9Ga4XF3suDkKNx9hp3Dyv1aZnOS3q5e 9t1x/OJh3ikTyefH5LUp0icyZY6rqAA1ihCPORd2kCTfm2oBk8Y08UafqcnsXtW0mxyd y9dI2UJx/KwKgtPwDuCxnGDHirWc2PZKtY2TOfPg5+wcX4daUOvLP0bIYfP0DeRkqm41 lh/txsTBOcfFmJvKQJ1wrkXdDRwbMyt/pZNQDRavM0Wn8NVNrcbKvqYNWTBMTZOhjAQ+ iZEDPZksMIeG7FMvXLGEncobK5z+Uli/zmGWRS2RbOgmvsQNygMhh8ajG4hd8sP0hnem 6g== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 37u3ymjmbd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 14 Apr 2021 14:30:31 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 13EEPXN5149582; Wed, 14 Apr 2021 14:30:25 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2168.outbound.protection.outlook.com [104.47.55.168]) by userp3020.oracle.com with ESMTP id 37unsu27ru-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 14 Apr 2021 14:30:25 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OF2P+oEElJ3QQInHHLNwWCR8Cc+fBgAgYDi6vuG//R605lFaEaxMw+rMIet55nC4gzynpgH+zntDRxzBMPAzVFVfqsd43VdrB6fMheHv/eNWWFiqnXHWYhr5A8oLqM21Y7YfQ+Vf4lwA4vuT9ruJzm3nH60AqFmY2DcY1Z4qFbHsYz+lVsAXWfhYi7edrfhRI/QFMXIjqSAaLdRLL3i8wQiSmF82BSid2l651N9V/E94pzz0TdUtlK15qlVWFV/88yaC/p3beY9OIF1f56hC0+Cb9aQ7WLbzIGKqtrbqwWXdbKhNKtKuZIOoNLzR+0b/z5qlkRzBrCdDrVwE3PVrnA== 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=j8S9hzjq7C4GV8CaU5VUeqnASw7leOIcWoEaFh6f1/c=; b=I1EjptjWLFvMvY5WvVQiip0JJt17YJvcC7zfOaX+1eWgLZFgVnVJwKpaxYO+9YU6GiccYtvlh+P6tDFm9Vfe10uf/+np0m2JlH42LsjnGVnCceRD82jyMll+BFmvzSv6GjmwtsjqC8V5f8dRl//bUyvvIvH3NsE1+UO2SmY3Dl2WwbmAYq3oZzOKMCvVa6aVupWrMWGvbOOrQV3s9/+2TLLoX5JUbFuR3j1ip6dazuRFa02R2RMuCyxDJ06VcYnaYknccPNQEYXlf2vUzd9PZwqQHWGY+r/FXlqvyWjqdIx9eu8di9d7HwtdtDmAZnnoV9KSNCRK/j0Kezc6tIsLlQ== 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=j8S9hzjq7C4GV8CaU5VUeqnASw7leOIcWoEaFh6f1/c=; b=E8QT7ZObpxoV+qM+jY27DrWXOkoJtqSDPOJUEdRNz35PPNd5CanCSDmKaeqz2BA3GhBLpOR9Znhk7Ay26+FEKZj9ts+9dl9mggdrYK6ubLeAoDoyMD0cCGah61U3T5nsSGWTyRbm2b9pdWhgprec2n04pf2/7w+TF8XS5onFbyk= Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com (2603:10b6:806:11b::15) by SA2PR10MB4761.namprd10.prod.outlook.com (2603:10b6:806:112::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4020.16; Wed, 14 Apr 2021 14:30:23 +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.023; Wed, 14 Apr 2021 14:30:23 +0000 Thread-Topic: [External] : Re: bug#47762: Doc of `macroexp-file-name' (Emacs 28) Thread-Index: AdcwtSyoWLJoZL+pTFWwKUZplt1ivAAQWV0aABD+UUA= In-Reply-To: <83a6q11j36.fsf@gnu.org> 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: d00df72d-5796-492c-caaf-08d8ff51d6e6 x-ms-traffictypediagnostic: SA2PR10MB4761: 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: 2FpFf2TL9cboWs0YRsq03AN3eC+Mu8D0KDckz1RA498zJQ5gv0fW/KigSWLfhFxghPddRDXbIkxqz6OoFNsicUoE911EYmKyRnT//KGht//XaTkKHPtVrwC5IoSoZ6MgOIikgt5T4Zf2Q9pfB4fkqUpUTWSFM5vaZUAe15YG31hdV1HDMYFeNwc4Tcb9HyvXixprCChNAhuFdRl5IByXkW5k0+aSIeqxTK4mtOvMQxTtIlniH4RvSPVoXlnPUfGSW7YFl92OScUE8QELFbM8gkyE+M8j4buzdIlJTELMT+9G0MUke7lirMSrZlCPWMAoAOgT7RARfTFB3u1DUTfgYJ5GK69F1bGLuvGh4RN82SI57ZFEG57Mte8G0O9zWNzsbI04pjYu9zyL/vKASVmIPuEjSEC1m/xWjZAkaWZohU+UeAuwVyOKQWJEO2MlYFDaNy4rjIbQgOqFfjgafeMusQFk3qXqgxNweBgvlhe4qNXpFzrCDc3SfGUMd+PCyJls6fO9k/Pb9qWKmAeDizw++k7zAaaB9KlnE80LCzmZ4OOp7iktTtNxSIvO9Tumz17gmZydJu6tIMqrlwTODAHKjDlufrMCd6DEqQuuW5fXArQUn3qjBQbqioQ7DnFHDqBKP3QroBal/8B9flcnlMNJYg== 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:(346002)(136003)(396003)(376002)(366004)(39860400002)(38100700002)(316002)(55016002)(7696005)(186003)(33656002)(9686003)(4744005)(4326008)(5660300002)(478600001)(26005)(6916009)(44832011)(52536014)(122000001)(66476007)(66446008)(8936002)(64756008)(8676002)(76116006)(66946007)(66556008)(86362001)(83380400001)(71200400001)(2906002)(6506007)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: kqlG+Ae076zCmfZIZ74QhrnGg+3AvO1l3rDZUi9+i2lNnx81wMwxFEd4GXhVyI1PcWJoPZoZTLCyeaZL7nNaI97XWRFYvlXPQSAx0EqZjaT4lyFhAcS/Ux6ooa7GidSthWki3l4tWKC7zU3R8dE8K+pRFJI4DG1yAGMlF4P1fDsIE1HLBJg4Oj28/jLztiPzZrhEHm0CxTK93pq95YHz6r0rSZpk6udPfbsIGlaXmZGaFNRnf9ENpOQOoO25oRU4fRo2qThULhhyg1g1Et2udU/EIIrDKM6owW09YC2nyjtaRrE9YdA7A4QTOIv/xN+LZZtCmYyq7Y9OS/pe9FxYq+D4+gQ9x5zFamcd3U+PpNfCi0Ah+mPnmL71fo6kHbfIlh3Q6n32RyZNYN+vUYjiqPwFvMiCDH0u0+EWrJ+X+Qm4oNfx1hyDVDjg/YpxTDK78UKvYXarh/eUrfnfGoxiasA6819Lv4fvRS2j4RnRRzcaP37i00N9Yr0gDaEA/4gEtF21wcxd659m9/l3SRYjiXFNXUtHUbFbFgTaKTurzdulJeqepB8que/szMZb8ZDXjkCVOFmsf6FzHBmVZV6280fC19btVHYLlpkdU1BuiJqtQnvF1vZqImKSC+wGBcuQ3NbDhPvo4TEmw3fbMMnlyU9i4fHuw13uQuVJ/vonkkf3aAaPdYpLQT4gkynrP+hVLCP/8GX9zteew8wxypP7f8cIbdBjCiB8lnHJgsguAWkZeNr0G8gVV0y3dI9M 72tccLl+viAekffLyEzGNg1g6+tBJqrdTYZ3aSUWLMyL7s1HQg5ceUpcIWhtPaictoLiiYtFuT6MAtqFq8OTQueqm0oKOkkEDq 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: d00df72d-5796-492c-caaf-08d8ff51d6e6 X-MS-Exchange-CrossTenant-originalarrivaltime: 14 Apr 2021 14:30:23.5459 (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: Rf3BjjE/8zsTu+7Y5dqJvU/5am/sI4YHxXy1FZIMhcj9s9EyzcYi1HziuRmSx1m6w092H/xQIzJyj6u+jGxw8w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA2PR10MB4761 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9954 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=744 adultscore=0 malwarescore=0 suspectscore=0 bulkscore=0 mlxscore=0 spamscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104140101 X-Proofpoint-GUID: NpJkMbhkbwj4yYzZhrMBU0J33mYp4QWG X-Proofpoint-ORIG-GUID: NpJkMbhkbwj4yYzZhrMBU0J33mYp4QWG X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9954 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 mlxlogscore=999 spamscore=0 impostorscore=0 priorityscore=1501 lowpriorityscore=0 adultscore=0 bulkscore=0 phishscore=0 suspectscore=0 malwarescore=0 clxscore=1011 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104140101 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:204012 Archived-At: > > 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 i= n > order > > 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, jus= t > > what code is meant here: "the file from which the code comes"? > > ^^^^^^^^ >=20 > This is explained by the text that you cited. > Closing. FWIW, I disagree completely. A reader really has no idea how or where to use this function.