Misleading single "\" in Emacs Manual Section 25.3

[Heime <heimeborgia@protonmail.com>]

On Tuesday, July 16th, 2024 at 10:31 PM, Eli Zaretskii <eliz@gnu.org> wrote:

> > Date: Tue, 16 Jul 2024 08:50:15 +0000
> > From: Heime heimeborgia@protonmail.com
> > 
> > The Elisp documentation "25.3 Substituting Key Bindings in Documentation" states
> > that each '\' must be doubled when written in a string in Emacs Lisp.
> > 
> > I find this a bit confusing because the section is about writing within the documentation
> > string. Meaning that the "\" should be doubled.
> > 
> > Using "\[COMMAND]" will not work in the documentation. One has to use "\\[COMMAND]"
> > 
> > The commands in the section with a single "\" is misleading.
> 
> 
> I don't think they are misleading, since the text says right away that
> each backslash in the forms above needs to be doubled.

It is already confusing enough on how many \ are needed for some expressions to be
printed (e.g. for regex expressions).  

When the topic is about documentation strings, the commands should conform to what
one would type in the documentation string.  

After that, it can be stated that the string processing phase will strip away one layer
of backslashes.  It would be more understandable this way.  Some readers will initially 
think that they should write \= in their string directly.