Subject: bug#52339: closed (Re: bug#52339: 26.3; Doc of functions that accept file-name args: say whether absolute)

From: [email-masked] (GNU bug Tracking System)
Date: Tue, 07 Dec 2021 13:02:02 +0000

Your bug report

#52339: 26.3; Doc of functions that accept file-name args: say whether absolute

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
52339: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=52339
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#52339: 26.3; Doc of functions that accept file-name args: say whether absolute
From: Eli Zaretskii <[email-masked]>
To: Drew Adams <[email-masked]>
Cc: [email-masked]
Date: Tue, 07 Dec 2021 15:01:26 +0200
List-Id: <debbugs-submit.debbugs.gnu.org>

> From: Drew Adams <[email-masked]>
> Date: Mon, 6 Dec 2021 22:26:46 +0000
> 
> 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.

It should be obvious, because anything else would be a terrible bug,
as should be clear if you consider the alternatives.  Which is why
Emacs does that in _all_ APIs that accept file names.

Closing.

Subject: 26.3; Doc of functions that accept file-name args: say whether absolute
From: Drew Adams <[email-masked]>
To: "[email-masked]" <[email-masked]>
Date: Mon, 6 Dec 2021 22:26:46 +0000
List-Id: <debbugs-submit.debbugs.gnu.org>

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=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''