Subject: Re: bug#76023: 31.0.50; Observed behavior for substitute-in-file-name different from the doc string

From: Stefan Kangas <[email-masked]>
Date: Wed, 5 Feb 2025 14:51:52 -0800

Eli Zaretskii <[email-masked]> writes:

>> > And why is that a problem?  (Of course, one should almost never use
>> > file-name-concat, it exists for a small number of very special cases;
>> > everything else should use expand-file-name.)
>>
>> How should I know it is meant to be for a special cases?
>
> You are not supposed to know about that function at all ;-)

It's in the Elisp manual.  Would it make sense to add a warning about
its use there?