bug#56673: 26.3; Doc of `file-equal-p'

[Eli Zaretskii <eliz@gnu.org>]

> From: Drew Adams <drew.adams@oracle.com>
> CC: "56673-done@debbugs.gnu.org" <56673-done@debbugs.gnu.org>
> Date: Thu, 21 Jul 2022 16:12:29 +0000
> 
> Do you disagree that that's the only case?

It doesn't matter for the purposes of this discussion, such as it is.

> If that's the only case, then could we perhaps say
> something like this (statement, not wording)?
> 
>  If neither file name has a `file-equal-p' handler
>  then if either file does not exist the return
>  value is nil.
> 
>  If either name has a `file-equal-p' handler then
>  the return value could be nil or non-nil when
>  either file does not exist.

It is not useful to write such documentation because there's no easy
way to know up front which file will have a handler and which won't.
(If you think only remote files have handlers, think again.)

> > >   This is similar to comparing their truenames, except that
> > >   remote file names are also handled in an appropriate manner.
> > 
> > The doc string already says that, albeit with different words.
> 
> I don't see how it even vaguely suggests that,
> in any way.  Could you point to the wording you
> think "already says that"?

Sorry, I dreamed it.