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#56673: 26.3; Doc of `file-equal-p' Date: Wed, 20 Jul 2022 20:41:45 +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="25305"; mail-complaints-to="usenet@ciao.gmane.io" To: 56673@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Jul 20 22:43:16 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 1oEGXL-0006NA-Gn for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 20 Jul 2022 22:43:15 +0200 Original-Received: from localhost ([::1]:49458 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oEGXJ-00089B-Vv for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 20 Jul 2022 16:43:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48494) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oEGX8-00088p-6g for bug-gnu-emacs@gnu.org; Wed, 20 Jul 2022 16:43:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46392) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oEGX7-0007s4-TV for bug-gnu-emacs@gnu.org; Wed, 20 Jul 2022 16:43:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oEGX7-0001c0-Ny for bug-gnu-emacs@gnu.org; Wed, 20 Jul 2022 16:43: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, 20 Jul 2022 20:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 56673 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.16583497216103 (code B ref -1); Wed, 20 Jul 2022 20:43:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 20 Jul 2022 20:42:01 +0000 Original-Received: from localhost ([127.0.0.1]:36141 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oEGW9-0001aG-2D for submit@debbugs.gnu.org; Wed, 20 Jul 2022 16:42:01 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:36748) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oEGW3-0001a4-HV for submit@debbugs.gnu.org; Wed, 20 Jul 2022 16:41:59 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48286) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oEGW2-00086V-TM for bug-gnu-emacs@gnu.org; Wed, 20 Jul 2022 16:41:55 -0400 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:22208) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oEGVz-0007hV-5q for bug-gnu-emacs@gnu.org; Wed, 20 Jul 2022 16:41:54 -0400 Original-Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 26KJViJN002272 for ; Wed, 20 Jul 2022 20:41:49 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-2022-7-12; bh=YsJ8cu+RE3IIet4bIys8r7Oe60wU6xmnfAfxdvoGFnU=; b=b41z57mLYeIvEjQJCJEsKmfE9SMJZOxV36B8R3W8KDSWmSoq8wSbSM1x9vi5hIR/DfRb LB6ma23hqUUF5nQQOk6+B5sD5oSqmsXZWUFCRr5i2AT+7q1VQk2yw+BN1X8Z5DpSs8Zq kOOf+s/uqmixHYrAhUMvHWnnMZ5mXuWrFqIsmKL7E3sGmPedv9GIlgjSvwPcT/3QhzbG Q+vrWU6AwzVmo5fYNnDnGgNgEcmyHTGlrZe7aWkhF6yLSRmXOpVjILVICjOjXZ5Hj8Yh yopBtj6Y8Cnf0uDJRRvsPO/XziS1ZOyjp1r25rO65C2ojcR0F8KvLgebb8l+kT868pnG ig== 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 3hbmxsar75-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 20 Jul 2022 20:41:48 +0000 Original-Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 26KJW0U6022295 for ; Wed, 20 Jul 2022 20:41:48 GMT Original-Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2175.outbound.protection.outlook.com [104.47.59.175]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3hc1ht50xv-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 20 Jul 2022 20:41:48 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=eGn8vwyj8rCQFkvx19LijBwD7qKmi8ppkMjpJI8BbOyDyub3PGZMD/T4AB1guxkfd4zVf1Gr0D0IGmZ4zDJCZskl+uCb25q/lHKdVPGIIAm5eDuWDqkFhNzHayuxlTqKfCYMvR6u52LmBfa/98Q1JBK7fhSAzNUSxdRf6x+wQH2KuDmmYU/NVtEAGm5OP7d8c2d4ACVoJjoXubEjWOV612x1KvppE36lAYBb+I6WVBEZE5RbcvZn9DyHpryGdkaH/O2NfN6qQLp69aKZuz03plZin12StLiL2mIFGCzenMvQ5XiKMWTRlhO+/vE7vAG1f+bCFVuyvNxo7h4ywN1IBQ== 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=YsJ8cu+RE3IIet4bIys8r7Oe60wU6xmnfAfxdvoGFnU=; b=iUOLQkNcFtzNg4y5Ui4tZlCxhFMorAjVIq/fHqTSVREMG5WpIfw52xlTOyGDEAe83FLdB1Whc7Ro4qH1EV0im+ViSx+Em7h6rA7B2wSA9qlsKFIwiwi6529Ezbafc0TUdqCM9qQuraz17p7TKdybQap4M/uDF6hdFUFjKxOA9gJFnogCyTcJAaGmbM4XeLpdsa7FFSMuc5hqHZzG45aJrhbfiwcugX2N8of4Xph+giZk2ZyrdBrT3MZUKJITyEnlewuWn+d4xvQPyrImvl0ZIdp1xfsyG87JpZ7klQwKnlC1XmQhlXWUqr7aYwH9HIBxLIz8Ruq/ivhlp1tFl+oWww== 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=YsJ8cu+RE3IIet4bIys8r7Oe60wU6xmnfAfxdvoGFnU=; b=Gip4JF7u1dQzQw8w1mWk8RFDrknvzpAl568V/7B+XyuvRysETn3s+oB4crIzkGCoX0hS3z1kdJbRyqtrXpohKiif0GLVedWbeNsVf08rsye0k5WkqNudsk8/BFzj5HFjIZFcoJhQmOsL16VCYKLDdO90hbmLaqpKBHB7PMfo6To= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by MN2PR10MB3311.namprd10.prod.outlook.com (2603:10b6:208:121::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5458.18; Wed, 20 Jul 2022 20:41:46 +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.5458.018; Wed, 20 Jul 2022 20:41:46 +0000 Thread-Topic: 26.3; Doc of `file-equal-p' Thread-Index: AdiceRSs/yPvbZSkQsOdM8R1vk8/wA== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: e2c247ce-bae3-4a5b-4b32-08da6a90432e x-ms-traffictypediagnostic: MN2PR10MB3311:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: U5Sz6bkXFnar0/HQrFXSJ8EwzjFHB4Sb+KEUpZhMNjJcEH66HLAmYqwBDbY/5WzPvQoYa1vPHjjp4hv0SJTPvOPHxFYC8pC/4CchrMbFIxZsuNJJnplN2gk2/0F59l8kKSoHnIGbie0eDxtLmgkb/yePqxBMouk5UdUtgBEsA1CRLf+RuVGZ97KD7W2SmUGbqQ0qtfAavPfpeb3i9jb5dbLlUdwPfA/RwAK5osT1egYbDGFnKo1SvAYRmr/wZE+5zj4rdg1eX4GY22el9VUME+esch3x+HCyHnDXQYpsIiV9pPecz2dAk62zMnfrnbK2+3gEro2eAFl8Z5fqWYkQIDa+O4+yhfAnsTXAgBUxDY/PETgoPe1OMjQWHwqv+8AfgrCEFlgHd39VIMTHImk43cOMcRETMKu1YBKIH7o51iDJAGtNbc5BJpJoHxXi6Kr5VCBPkqeqXlObPBTwQ3zKnL1r4ulfIsksrTexcuzEzcweQabx83BNzBlKZ+cuhHFNVdPCUslHWMqfFXTV0sYm7yPVGClWUCEK+fagecFgyasig4PJyHRK6RdDb88dy99Fhj/kiKRXEcitlEuxqi0nBg6sMIHxe6Ot5n/H989uzKkvJxLfk+wqXH59avudviA8ZewKVs7rxiDkAEnVI2/KZ7SakpebBhp6uOtt5rXRXi3qbuI/IJ3yKbDsM+vFBjyXD0b5b+qGmyxlxgs02xwsCqQwuHCC4EE8eJLw280KpO/Wqy41D3z8SJqKQ0t38 6DDIUoA/BtEfmux01y7D7j+WCNJkpCKBiHU7jwP5TMWkKxvRe9EjTzBGcq7xZwHocuXIrULbD8L4R1ypj7bDX1OUA== 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)(366004)(136003)(396003)(39860400002)(376002)(346002)(64756008)(9686003)(26005)(6916009)(76116006)(66446008)(316002)(71200400001)(66556008)(8676002)(66946007)(86362001)(186003)(66476007)(44832011)(2906002)(33656002)(41300700001)(55016003)(122000001)(8936002)(52536014)(38070700005)(45080400002)(38100700002)(6506007)(7696005)(478600001)(5660300002)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: qfAjao0LYMWZn0tIjYhEez6RQJs5BOyoVPh1+gGQs7faOp7pLQ1aRQSDvaTf8Nd/VW36DeQzzEo8lBXmyFvM96swWorBrboQqcnXor1Lg4KgzEWAEzJPJZc3+oGbhLmbtEYYknmsTzAGnEsoahhCvx54Z2Mj6VfUmBbMdQGosQsM851OeG/QqDPUtSpj8fyCZLOzMD3BDTW6mhBWQ5Q2tTxXJ7XTh4gbRg6L+SBOl2a22TadfKO3VhDFkHY3aJPFpNpEj/x6vVhTSuFVY0C7cG0WlXbroQSfooSB1NEvCqvMPuJ1JNaQeujMGB0BL9q4N1gDyNXlBqcLlUnNR2qPXhfYHBse/+/H186Tb61UQm/KSk9+0R54gf3XRcGfJOmhn7aR4zmyHiBftuwfrmRtErxQ3IuOVi3bVRTTmMpWDezN1kOIV2cc/dIv/UfG+lwZpU049ed5Qbin2BsxoJ8O6Zh8t5JsGU5rSyIjxegXCqpglBWZi5lDhqPRuXrw2xc5T9XbLV5FIqtMeoCT38Qp6ZPve10qPT3dcu3Mf7cyB9Jpfz4M2aLH+3ZdtIqbP4BrMf23hys9PdfuoFvk1hLHJFlHalAaMtPPtFW3d8iGo8f8YyGrkXPNbD9GEkrhUew6MUtQGuJpVADZq6hghx8Q5rlOQ9ltSyh9wAnY3GFBUSxGDFDl74fC2V2fbh9KsQLVKHnZNmKOIQp5Ks6heFEJ7n+m/4duDW+7bm0zXPUQ/VVXiTjIqS0pu0izUM ceXuImC43fzc7QOEwWGbXKkfAEubz58XVrFsSHPd1JZtzC8gHKn5lJpmdWSHwbWPnzA31vPozJg/bkbAMzwJJbuBqiNUwXymcF 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: e2c247ce-bae3-4a5b-4b32-08da6a90432e X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Jul 2022 20:41:46.0820 (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: TFcNO6kaChWPZBFDx7BCovaTixcj6W8Q+D5sjjnkbnqa/D+dK6UZCoSfso10hvJIiYcoGe456x2v5ybLBbPqvA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR10MB3311 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.883,Hydra:6.0.517,FMLib:17.11.122.1 definitions=2022-07-20_12,2022-07-20_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 malwarescore=0 mlxscore=0 phishscore=0 mlxlogscore=565 suspectscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2206140000 definitions=main-2207200083 X-Proofpoint-GUID: 1rJobpxYhZ4rYt-ZWSINhhk9nGrL9a3w X-Proofpoint-ORIG-GUID: 1rJobpxYhZ4rYt-ZWSINhhk9nGrL9a3w 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_H2=-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:237522 Archived-At: 1. I don't understand this part of the doc (in both doc string and manual): If FILE1 or FILE2 does not exist, the return value is unspecified. What's that about? Looking at the code, it looks like if either doesn't exist then its own part in the test is just nil. OK, if there's a file handler then that case could be unspecified. But if there's a file handler then the result could always be unspecified, no? (The handler doc, if there is one, presumably would "specify" what its handling of `file-equal-p' does/means, however.) Is that caveat only about the case where there's a file handler involved? If so, it would be more helpful to just say so. But if there's no file handler, how can evaluating this give something unspecified? (let (f1-attr f2-attr) (and (setq f1-attr (file-attributes (file-truename file1))) (setq f2-attr (file-attributes (file-truename file2))) (equal f1-attr f2-attr))) `file-attributes' just returns nil if the file can't be opened. In what case(s) is the result unspecified because one or both file doesn't exist? 2. How about adding this sentence from the manual to the doc string (also)? This is similar to comparing their truenames, except that remote file names are also handled in an appropriate manner. 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.19044 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''