Subject: Re: bug#23902: 25.1.50; Strange warning on string-collate-equalp's docstring

From: [email-masked] (Óscar Fuentes)
Date: Wed, 06 Jul 2016 19:44:50 +0200

Eli Zaretskii <[email-masked]> writes:

>> I understand why comparing file names with string-collate-equalp is a
>> bad idea (it can return t for cases where the names are different from
>> the POV of the file system) but then explaining this in full and
>> pointing to file-equal-p doesn't take too much space (about the same as
>> the current note, I'll say).
>
> If you think adding that will make the issue more clear, go ahead and
> propose or push a patch.

What about replacing the paragraph with this one:

  Note that this function is not adequate for testing if two strings
  name the same file. Use `file-equal-p' for that purpose.

?