Subject: bug#54191: 26.3; (elisp) `Magic File Names' FILENAME parameters: absolute names?

From: Drew Adams <[email-masked]>
Date: Sun, 27 Feb 2022 22:42:39 +0000

OK, I see that the doc string of `file-remote-p' -
but NOT its description in the Elisp manual - does
at least call out what happens if the arg FILE is
a relative file name: the function just returns nil.

That doesn't invalidate the rest of what this bug
report says.  Each function's description should say
what kind of file-name argument it expects, and if
it handles both relative and absolute file names,
how it does so - how it treats each kind.

Users shouldn't have to search the Elisp code base
to try to figure out whether they might need to
apply `expand-file-name' to a file name before
passing it to some function.