GNU bug report logs - #56673
26.3; Doc of `file-equal-p'

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 56673 <at> debbugs.gnu.org
Subject: bug#56673: 26.3; Doc of `file-equal-p'
Date: Thu, 21 Jul 2022 19:30:59 +0300

> From: Drew Adams <drew.adams <at> oracle.com>
> CC: "56673-done <at> debbugs.gnu.org" <56673-done <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.