Of course. And for blue the programmer should just use the names of the
symbols there, as always. Shorthands are not the names of symbols, as i
keep reminding.

If the docstring reader is ever enhanced, then maybe programmers can refer
to symbols there using shorthands. Until then, shorthands are Lisp-only.

On Sat, Nov 12, 2022, 17:01 Eli Zaretskii <eliz@gnu.org> wrote:

> > From: João Távora <joaotavora@gmail.com>
> > Date: Sat, 12 Nov 2022 16:46:51 +0000
> > Cc: Eli Zaretskii <eliz@gnu.org>, 59082@debbugs.gnu.org
> >
> > Hmm, not sure we should be using shorthands in docstrings, which aren't
> read by the Lisp reader, but by
> > something else... This is what is at stake, right?
>
> References to functions and variables in doc strings are a matter of
> routine.
>