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#52339: 26.3; Doc of functions that accept file-name args: say whether absolute Date: Mon, 6 Dec 2021 22:26:46 +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="28516"; mail-complaints-to="usenet@ciao.gmane.io" To: 52339@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Dec 06 23:27:11 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 1muMRy-0007IA-4i for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Dec 2021 23:27:10 +0100 Original-Received: from localhost ([::1]:55434 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1muMRx-0002v7-2T for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Dec 2021 17:27:09 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:35296) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muMRq-0002ts-9a for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 17:27:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52303) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1muMRq-00057b-1B for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 17:27:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1muMRp-0002gA-SS for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 17:27:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 06 Dec 2021 22:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52339 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.163882961810285 (code B ref -1); Mon, 06 Dec 2021 22:27:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 6 Dec 2021 22:26:58 +0000 Original-Received: from localhost ([127.0.0.1]:35616 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muMRm-0002fp-7f for submit@debbugs.gnu.org; Mon, 06 Dec 2021 17:26:58 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:56856) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muMRk-0002fg-U5 for submit@debbugs.gnu.org; Mon, 06 Dec 2021 17:26:57 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:35294) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muMRk-0002kQ-Nc for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 17:26:56 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:20730) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muMRh-00057E-Un for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 17:26:56 -0500 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1B6M5SXn016355 for ; Mon, 6 Dec 2021 22:26:50 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=fLY0Km14bYM8kMYjMZwAyWkb9OV3p1LxD8BdmcTE07E=; b=vfxbN2c0DGcTG0UmmsddZn1mIseDcVrt6Z7ud4xfEJKw8tBkDKKeTUy1wug/2RrGxdTt tetR3lc3XReWwJuofoppav9e/mfJWO0ZqfLKup2x3xSm1tnthnjICQn7V6SyNgCapTJ0 JkwsTFKoUIA+C2X7V0WOsN8wteQZiO8A6DhKNWjhz/MsHV3M7PxT8okRNdFalsW9hbGi rrcZDm2fov8cKaPYPCqZfQeAcHcgmZPFpMQvp8WqvLPs3ZdhUJENzPxmC9g600pjcH+i BDsa3qgPC+A7s6DKhP3ymPACkRQpd3NyFc7uyRX3G7owFCTkFesl8t9CgAD2Z6aB0DLh tA== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by mx0b-00069f02.pphosted.com with ESMTP id 3csctwkqcg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 06 Dec 2021 22:26:50 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1B6MAcLM168889 for ; Mon, 6 Dec 2021 22:26:48 GMT Original-Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2176.outbound.protection.outlook.com [104.47.57.176]) by userp3020.oracle.com with ESMTP id 3cr1smtsuu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 06 Dec 2021 22:26:48 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OZpWaM+aUgVbTAnvGuK3gU+H+old/tIPJtt6fojxr7+yTo2gl26aUtHTInisho9y16CbTnGNdqdcLfeFzXANmpUf2woxiSgtC97RxRJhBY1+x7lF71pgDp46ZIyOMw+XldIcd//NK34/pc+kRYFii4Rmk73mYe+R3ksiV/uV3FZ+QWlvGvP59oHF1A4lTI0LSj4GM+yYw8STpJ0uZAu8A5y3nIdCTi26YHumRLkwtNBstQydMb8m6C5AjyrYv4DmFN9Hq0csEB4Y7NjITgIKOvByY0eWy2TvmVd3z+YUPsjfbOLUHfCcnNWbuEVYro9LTnHWz8yOfOI/VriesD9H1g== 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=fLY0Km14bYM8kMYjMZwAyWkb9OV3p1LxD8BdmcTE07E=; b=WCkDY+RpnmtXVm12x4V1pUqnD8yeMJgKp0+Mwc2d8LR5CxXQEXErK3z+EBfF166IWcyq9bp7myTg/NqTE+7RZhncz28RsMvU2puSnabDT7jYZEPg+blCioycspYUz2MNQcce71/g4+G0SUY68W3eX1L8Ci6DQ2lGv4crmXSVyhAbppU1QWfZJ2uBuu6jxPnhoOxhLCTupullLIo+WPVkARcnVlpav9cjPsrwGWL2NK99kipXhVW0Q7MmkGp2FOyyQDdwiFv5vXPht6ZQ5u0S7izIo91o+dyqEZ5pNEni0wkdQeJz0VS9AL671QceD+szDf17uZKQcq7cE/9aCSCccA== 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=fLY0Km14bYM8kMYjMZwAyWkb9OV3p1LxD8BdmcTE07E=; b=Y9s9/lKRWCZxNhxOxQppv72RNLmatmWZ/qbLc7YzwuHGYGtcACEnRAqlQOBKNp4mMuah+bgXTTXOVI9u0qNsAhk1W+W8xPGl1qwdXtKJDDxWlvDS52DW1VcG3UH1zMhpFkl5/V0e1lcQW15Pn+cR0gZYgsScBbgU2/nCoMC76mg= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BYAPR10MB3558.namprd10.prod.outlook.com (2603:10b6:a03:122::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4755.21; Mon, 6 Dec 2021 22:26:46 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0%9]) with mapi id 15.20.4755.021; Mon, 6 Dec 2021 22:26:46 +0000 Thread-Topic: 26.3; Doc of functions that accept file-name args: say whether absolute Thread-Index: Adfq8EWRkjFnRVdiRSaER8yrc8klQA== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: b4b6d4af-9009-4e1f-493e-08d9b9077d4a x-ms-traffictypediagnostic: BYAPR10MB3558:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8273; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: X9M/rApGO4CepFnK8xAgzAS9+OenPkz+jbqH4DNOq/6dJdHeuPQftp+D+4rWVI2MrCTQSR4+i2PoXsrAaqdKsVDAE15TMXIbNcJarZc0q3neEdSxtFfIHajOKJ3Rcped03gHduplKuHIdg3WYCLaKUNEAYzc5RsflnbMniJlCrHc1aVJQIPyRmBIqjbAhmmLEQ94FTsLihxIWqpTI8HD+XFOXq5zyGHuv4Kb960wMMU6cV+Se/JatSgpIueFHhHFPiEiBjXAydSw2k68t/ZWrJIN03d6JnCBHPqaAtYzIolGOTR0u78oOOurfvfAC/CGcmuShvEfD+mewRzS2ApgBUZy8xDDXJCqE3P7IPc/TmW+7+X0G+WZ4/ABaudu3iW3KgAJCtLQgBodwE/0tRilMfjbCvy0XOFYqN0pIPWSUDyeClmn9jOMSxUfGGiZhzgJfqnYyrlOxr/Xn2orNOy49WpomtZI6g6iPZihdn5B1V/mkBdJ6F5NYi5ValsIgYMHwKRyPKaWsxdivRK68Fh/a3pD+QFpwNWo1FluMJZQuvZ+uitSigUIVyFXhlULYpZNBuJW1WM/zQXnkzlkRRvFd/eT4V6cQxVtKKmiJfFYPKJ/jxrHvRDF/kJFnPl8vVq8DCPPfBRjjc2J9eZUmTLkcb+y+RhqWPdflv+h+573ysmVGakVVcH3Z4usnkNbEmIxmLXkNOoD1BBJicNt9E95Xg== 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:(366004)(7696005)(2906002)(71200400001)(38070700005)(55016003)(9686003)(316002)(8936002)(52536014)(66446008)(64756008)(38100700002)(122000001)(508600001)(86362001)(44832011)(33656002)(4744005)(66946007)(66556008)(45080400002)(66476007)(76116006)(26005)(6916009)(8676002)(6506007)(5660300002)(186003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: tF3L/v0anrl52pHdSiORDNHq914gvGLC28GL3o3OEW4QxvrANCbhFbgUPXwJkGvdrnOrElqL2Rndjsr1Q9346O+S4lhaNQ1A+sg2qxx3z9RCr9YHNQ/YA8/okdydpKgkt+JiQsvgjiWn7EhemefK+JaE9+l9Q391Mzcg2p2QMMR0toLK3Q8c1BC2NJSwd7tR8wwJ4bgkTZ3tSs1us/fSB4/XbkEhsjGwSVHNo6egdrWljBbCX3TjJCn0ti81YmhsLyLHhqUjLAkf9nAQ0UZztprGu/2EcKiZdB9gxqI/oQDjpt1u5n6Itex6lxBe+TYzWZrJvS5YbRXXROL70QulCdQ+rEQ8c+CVjxnOW3vqfO3/MC+GeaFxNg8ysh2nxFRSZJ5uXYoW9i2jGDUYsJt7E8P1os1dTHqUZQVfY9UCv/mLTPQnBuHjSJKujvwpw70mhy+a3QY7s0ZCzeygd/T7YzgKZdnLoc14zCcBTBJrvMKXKu3xzBAEuqHtuda4ROlTN8u4Q5R5e1mvVpyCcHQk8v/xd0KagPmefu4orTJXTmeELWR9rgGqYONh4aTwzayvEiAhAQWaJN9KeySLu8w9f/Ai4REdiJnpf7c/+F65Esc5Eu6F+EnRmkbWJeLfKzaLFHhmRZSrCAvMDkWvHckJ9Vdk/i+17Gzjmy8FUL96aSAQqzqTEPKQZRCFn+dg0fGqiQNbK5jw6UT2LoVL5EOQszapVMPrmL4qycdjWfmTfKFKTpEtR0kXeaSQqC 5CEjPKIfvo74pXY5lfde1wmRIUoNqId10izdiqTbbWtchZZyd4VxMEn6aiKm+/0RgG3tHFFdPlovfCZKfNVaPb0X5sypri5U1E 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: b4b6d4af-9009-4e1f-493e-08d9b9077d4a X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Dec 2021 22:26:46.6590 (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: GnzLRUJQA2+UrhlrRRFBuH850R7ESw9yT/q7P5qu4IAAZPFhuina5cJsRjJiOaprQ66LC0QyKHUCyY317rx/eg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR10MB3558 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10190 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=704 mlxscore=0 spamscore=0 phishscore=0 bulkscore=0 suspectscore=0 malwarescore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2112060137 X-Proofpoint-ORIG-GUID: EkXDlMMmYYgSacQ5HaeBY9mzBE-zrhHe X-Proofpoint-GUID: EkXDlMMmYYgSacQ5HaeBY9mzBE-zrhHe Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-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_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=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:221792 Archived-At: This report is about the doc strings and the doc in the Elisp manual for functions that accept file-name args. Please say, somewhere (preferably in each relevant node, since someone might not start reading in node `Information about Files'), about the file-name arg for a function documented in the node, whether the name must be absolute or relative (e.g. to `default-directory') or can be either. Similarly, for the doc strings of such functions. E.g. function `file-exists-p' itself expands its arg relative to `default-directory', if the arg isn't an absolute name. This isn't obvious. 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.19042 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''