[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#56673: 26.3; Doc of `file-equal-p'
From: |
Eli Zaretskii |
Subject: |
bug#56673: 26.3; Doc of `file-equal-p' |
Date: |
Thu, 21 Jul 2022 19:30:59 +0300 |
> 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.