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#54191: 26.3; (elisp) `Magic File Names' FILENAME parameters: absolute names? Date: Sun, 27 Feb 2022 21:30:22 +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="21534"; mail-complaints-to="usenet@ciao.gmane.io" To: 54191@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Feb 27 23:22:15 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 1nORvh-0005OI-Pe for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 27 Feb 2022 23:22:13 +0100 Original-Received: from localhost ([::1]:35118 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nORvg-0000l7-Cs for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 27 Feb 2022 17:22:12 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:50020) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nORvW-0000kz-Qi for bug-gnu-emacs@gnu.org; Sun, 27 Feb 2022 17:22:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:37381) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nORvW-0007UA-HM for bug-gnu-emacs@gnu.org; Sun, 27 Feb 2022 17:22:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nORvW-0003PC-2C for bug-gnu-emacs@gnu.org; Sun, 27 Feb 2022 17:22:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Feb 2022 22:22:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 54191 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.164600046613025 (code B ref -1); Sun, 27 Feb 2022 22:22:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 27 Feb 2022 22:21:06 +0000 Original-Received: from localhost ([127.0.0.1]:59511 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nORub-0003O1-Fr for submit@debbugs.gnu.org; Sun, 27 Feb 2022 17:21:05 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:53804) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nORuZ-0003Ns-Jt for submit@debbugs.gnu.org; Sun, 27 Feb 2022 17:21:03 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:49908) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nORuY-0000gQ-Qj for bug-gnu-emacs@gnu.org; Sun, 27 Feb 2022 17:21:03 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:44512) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nORuV-0004Ac-3W for bug-gnu-emacs@gnu.org; Sun, 27 Feb 2022 17:21:01 -0500 Original-Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 21R9Slkj008194 for ; Sun, 27 Feb 2022 21:30:26 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-2021-07-09; bh=bqPwNK+5Ar+1sIDaumuM/Qm8yrGVntPu7fcZuakqzmc=; b=PBghxqvJ7e/Mcio+JUXdTdZT8RBGOpkUoVizJ5MVo6kZAD4JZwqdkHh/Zc49ncMK3YKx r+HsNwqXKEmXYg9nZOLF++aBJmgF0wJH8gXirCLTg81niMYz6WPo3Hs2UBpaUPUkhf2U HH4XqNS4Zp/2rOBrX0QAmHH2BpE+np7KvfzHGf57J9Gb1uzpj1O5ylC09s8EfudeKaau Zel3NQOl7iqkVIQlScrfZv61Nhk9gvuqftXKNEerUZBxnOiiAs4DGfccmPFl4Dv6bxdf p9h3uJF6zO2mH/2E1uKKgielTJ8vgR9da48B+ZZryhx+6rRlmFCxFl7pyvS/e5CYkVD+ cg== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 3efb02jq72-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 27 Feb 2022 21:30:26 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 21RLFvDJ050050 for ; Sun, 27 Feb 2022 21:30:25 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2102.outbound.protection.outlook.com [104.47.58.102]) by userp3030.oracle.com with ESMTP id 3ef9aue7eh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 27 Feb 2022 21:30:24 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=b7YGeU2C7BvxR1zI+AqoUqhR+vJz+8yeQEU9j9kldmcawEMIGAT+XJf/gKOJxiP8LmxNATjG/OFnqCiDP6j0OXZSMTQusa/6NhsoP1sJyQDQfasWG5JlfYomgtnFC2V9v3VJAPvNjcAe4TYRPqvdZbok7lTott4HQ1LOBvEl/av/qpU6R7TmHKnddW2wC5EmkI8grE/cFMVCty3p1fQ+dTwqTEPYynSFGjw16LOnqTnQwEfZ2g6v4t7YNZ9Cr/bk1syCeAomL4zOZFf0FtqLRQta5HxoKrzgfhE0Ma7Zc3XYFIAmxJWAnAEXo/xQrypQG8uWYfQpzaDKlFPh6DODng== 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=bqPwNK+5Ar+1sIDaumuM/Qm8yrGVntPu7fcZuakqzmc=; b=dahET5XuP28HbNbJcswIHYhBg83oV5HATwrYZswMwOTGAUhGw/tLqLBiZdFleHzbl37e0xEcEgw+6udRYqKo7TxOSnITdJkfSMSa9kpIX0TZe2Y46BIiQ2XEV2ET04qVYCIr/wVoXskIOFFO8GuBvHvE6mY+7ir7tnF4bqw9eFkDHRPt62A3bkqfZUVQhWBkd03ejH/PFpZax015pxsglRuUwX1IV65eObFYcFqA6sbG2WoQTMmboti01OapYsjyl7dDpwmWiQjkW1KAnpOJEgm9cpqRbdpKDymwZOQXM0ZhpCqndpo3XD2AOKdkj8PzJhF2KSk0XnhpGe5NCw/2XA== 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=bqPwNK+5Ar+1sIDaumuM/Qm8yrGVntPu7fcZuakqzmc=; b=F6cylacweJXV8xK99MIwDOrNiIpAqJZXLBXOZyRghd/RGrqyAD1Tqww9oafTRvh8vrr6H/s9aMRcdzKNAA3ouxCxsgJYBJwtJ0ZZRLYmhjhzDTYYlQlxugzBvlae8PjZXagRvvEP+OJuRwGo8g9UTXY/KhWI9pGGv/DJFtL8igU= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DM6PR10MB2425.namprd10.prod.outlook.com (2603:10b6:5:ae::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5017.23; Sun, 27 Feb 2022 21:30:23 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::f811:66c9:41ab:df79]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::f811:66c9:41ab:df79%7]) with mapi id 15.20.5017.026; Sun, 27 Feb 2022 21:30:22 +0000 Thread-Topic: 26.3; (elisp) `Magic File Names' FILENAME parameters: absolute names? Thread-Index: AdgsHz6P6idnU1/7S0us9A5/FzzySQ== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 307ef5fc-49ac-4f67-ea75-08d9fa385c98 x-ms-traffictypediagnostic: DM6PR10MB2425: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: LSYmZqqJs9eEgG8nrkYgePCT5hW3RmJxN73nXwVSjJGDgJojEdbC9TkfnPscsu406lfNEXGuTkWAMGjQ02cZMtv20xifJ1UeOExQPqMTjo7CyFCajXp+GFqZ7gL2ukeDnLHCpAwMvpEMtL31ByEApU1lfCS+7CoMKl0wZSVUiMpCRBRBtQMnrSHO7dTlI33idFYloyAgNgjVusN2es5ADUgE5w09hcZ4R0AN5oj/a5V/SsnUwtAET1co9DzNDmQmJJYV/aQN5payUil7zA/4P44XgOYjT7t+PWDr8OxxgQaMTIr0/ZrTPadCShCMRRhTeAnrDvGxTfvsMlSA+CMy+9nn4NKU2KhwmhbOACKYhChiVq4dRv5GmWY0R6iiydpgFT3/GIBU7TaOCIQuJY4d6aDb+iRs7LVSdkclVxSABfYL55Cr6zQbuAUrXCdqHswesWMO4N95h/aHpo3c6zN6PgmhZQv5UCRm2vLdP2nrsiQy3Aeibi30Ug2Uph+lBuzkztwVSnz456zI+MV83COqNux4xXHVqJImUodW7VPXYu2/orX7gvR5+Duyx4Ba4+62zxUK72wdXlZnJcbRQlycL1W21AHve3Bnnyhy7MXL2xiPr7veTGjd0CpzYg3Ke4kNnik/4AkhMBi0S0wufoC+OM7+J2VHxN6qogJ8deo8TfAUwbmpOUMU499NPRYM2OvKm6WMIJm1pV1NImaiSA22VGHbsMHKjm5DKHQq29cnaEU= 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)(7696005)(38070700005)(33656002)(83380400001)(55016003)(71200400001)(8676002)(76116006)(86362001)(6506007)(508600001)(45080400002)(66946007)(64756008)(186003)(66556008)(66476007)(66446008)(26005)(316002)(6916009)(9686003)(122000001)(44832011)(2906002)(38100700002)(8936002)(52536014)(5660300002)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: 41/1cToZ61bVSMBFO14qvxvDu7wCMc3EakdUZAXWm8/gGcQbg8KU6W5l7jQqTSMSQo2lkdmKz/mdymSkL9NfZy4ELclAesEfogG5nWft37HI/ATeptKgbZG53gAHaQl6IjmZR7ej221hnUyN0NoiPm0FS6ayQJHOdfaYtzIs60zX3py8ZyLFzAZusbOegi2wBHVXbiWgRMqqhzw8PweDqaHLLFpmcvDLM7kzvazoZu5ywoKolj4rL3a55ibUJ8OPTG4zFdfZLPseS8Ninq4RhwUp0ddchHkHf9QUm3WTiR2ntQ271aUBdx+ohYB3A68gcHRaDxTdi+TPpe/CAeJBWzltHRP+2cLi56dNxBHbiafB1U8f0r82W3UMi2hkxbX16TkbCMEe5+GkVYaxmQqI2vzdzckLoeYHhP1ETp3aiF2QDcVlgwK6MDqzVwXlx1Zn8ke+ZpUxE8iaOv/Ort5zzr9z7SryTgIuB3YFY6KmNWFianD/MuRzm7MYL61q6hIshaPRg9TbuYWo7PJTahza/wri/eEvt2CUM2JGKCTS99RQakZjEqdaLwojGjr36yHhCJNjKiuehauI7HQnQ5uicXsKNtUQBLxPf47EVz7oCXGeLoKf8mXBfofsTBU+ofUzcjyr98WjSfSmw7I2xDiz2xKYcJUxIblHOc5EgGk0zU5aohLMnupH4ZOYT0YI7vtofdKgObn1Fw6GXON0MysQ/QEgUkkDr0ZtWGP4MsHyRlIxp6APrK+xNgWhQb zBjh1/9lGaslUczhhL1jPYOEFp9QDXPul67dharFNXh9iD9wHDEyNM9AjopNhHeMdJC75JsLTkaetNMWfEGh9e5FTgyxkeDWCQ 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: 307ef5fc-49ac-4f67-ea75-08d9fa385c98 X-MS-Exchange-CrossTenant-originalarrivaltime: 27 Feb 2022 21:30:22.7168 (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: eH5YKdK6M+ulX6jRvlnRm50vNzy5BpyACySB7Iae8Ih8ww/0+HoZNNtMT6uig/4dk5pEcXbLXAQgQz2W8cPSSQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR10MB2425 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10271 signatures=684655 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 malwarescore=0 mlxscore=0 phishscore=0 suspectscore=0 adultscore=0 mlxlogscore=882 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2201110000 definitions=main-2202270146 X-Proofpoint-GUID: pxgKGMTbCMXFtEYcDE4jnP_A_vUF2-f8 X-Proofpoint-ORIG-GUID: pxgKGMTbCMXFtEYcDE4jnP_A_vUF2-f8 Received-SPF: pass client-ip=205.220.177.32; envelope-from=drew.adams@oracle.com; helo=mx0b-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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:227747 Archived-At: I check this Elisp manual node for `file-remote-p'. I try to figure out just what kind of file name is expected by the function. No clue. Same thing when I check the `C-h f' help (where the arg is called FILE). How am I to know what kind of file name needs to be passed to this function, e.g., whether I might need to first use `expand-file-name'? There might be more nodes with this problem under node `Files'; dunno. But at least please check this node and make its occurrences of FILENAME parameters clear in this regard. ___ >From the `C-h f' help I follow the files.el link to the `file-remote-p' definition. There I see that `find-file-name-handler' accepts the arg FILE. So the question then becomes what kind of file name (absolute or not) is expected/accepted by `find-file-name-handler'. `C-h f find-file-name-handler', likewise, says nothing about whether the name needs to be absolute. I look in the manual again, at a higher level, node `Files', hoping to maybe see some intro text saying that, by default, when the doc here talks about a file name it means an absolute file name (or a relative file name) - something, to let me know how to interpret all of the many references to file names in the 13 child nodes of node `Files'. I find no such general statement. If there is no general statement about how to understand a FILENAME arg then the description of each function that accepts a FILENAME arg should make clear what kind of name is expected. (And that's anyway preferable to expecting a reader to have come across a general default statement of how such parameters are to be understood. ___ Grepping the Elisp sources, and looking for `expand-file-name', I came across this in the definition of command `cd': (and (file-remote-p (expand-file-name dir)) (file-accessible-directory-p (expand-file-name dir)) (expand-file-name dir)) And that leads me to believe that `file-remote-p' doesn't, itself, expand the FILENAME argument. This info shouldn't be so hard to find. The descriptions of functions that accept a file-name arg should say whether they expect an absolute file name. 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.19043 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''