Re: Misleading single "\" in Emacs Manual Section 25.3

[Heime <heimeborgia@protonmail.com>]

On Wednesday, July 17th, 2024 at 1:36 AM, Eli Zaretskii <eliz@gnu.org> wrote:

> > Date: Tue, 16 Jul 2024 12:39:08 +0000
> > From: Heime heimeborgia@protonmail.com
> > Cc: help-gnu-emacs@gnu.org
> > 
> > > > 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.
> 
> 
> I disagree.
> 
> > Some readers will initially think that they should write \= in their
> > string directly.
> 
> 
> Only if they fail to pay attention to the note about doubling the
> backslashes.

Or me can leave everything as is, but elaborate further about how the
processing phase of a docstring will strip away one layer of backslashes.

Then show couple of examples

  Entry        |  Interpretation
  -------------+----------------
  \\[COMMAND]  |  \[COMMAND]
  \\[\\-\\]    |  \[\-\]