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

[Óscar Fuentes]

Eli Zaretskii <eliz@gnu.org> 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.

?