bug#55853: 28.1; Please document f#(...) syntax in Elisp manual

[Drew Adams <drew.adams@oracle.com>]

> > But is there any chance this "pretty"-printing itself
> > can be made more human-friendly / communicative?
> >
> > Aside from (I guess) naming the formal parameters, it
> > looks like it just says "BLAT$%@#(*&{}:"|?><(/.,!!".
> 
> Well, that's what byte code looks like.  Apart from that, "it" is a
> clickable button that will disassemble that code for you if you click
> it.  Not good enough?

Dunno whether it's good enough.  Depends on why someone
might want to understand what's printed.

From the original thread:

  this is apparently "special read syntax", i.e., Lisp
  reader syntax that's not readable by the Lisp reader
  but is meant to communicate something to humans. ...

  What the source code for the function is; what the
  function does (e.g., it's doc); or where it's defined
  -- nothing like that is conveyed in the "pretty"-print.
  And whether "compiled" there means byte-compiled or
  "native"-compiled also isn't made clear.

(Dunno whether any of those missing things has now been
added as part of the bug fix.)

Maybe instead of (or in addition to) a disassembly, a
user could be pointed - a least in some cases - to the
original source code (Lisp or C)?