all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Drew Adams <drew.adams@oracle.com>
To: Lars Ingebrigtsen <larsi@gnus.org>
Cc: "55853@debbugs.gnu.org" <55853@debbugs.gnu.org>
Subject: bug#55853: 28.1; Please document f#(...) syntax in Elisp manual
Date: Thu, 9 Jun 2022 14:04:52 +0000	[thread overview]
Message-ID: <SJ0PR10MB5488DD703161FDE1F02F2951F3A79@SJ0PR10MB5488.namprd10.prod.outlook.com> (raw)
In-Reply-To: <87k09q55ue.fsf@gnus.org>

> > See https://urldefense.com/v3/__https://stackoverflow.com/q/72547221/729907
> __;!!ACWV5N9M2RV99hQ!Js5VF7KbuZreJUFSLAH2FrOVle2g3oyTYcFXS7qlnAwG8QAl9v
> GcS1skzoz2U2AgbNowlTxv7NJQ$ .
> >
> > Users see this #f(...) syntax.  They should be able to consult the
> > doc in some way to find out what it is/means.  Please consider
> > documenting it in the Elisp manual.  Thx.
> 
> From the URL:
> 
> The syntax in question is in the following expression
> 
> ((remote . emacs)
>  (system . #f(compiled-function
>           (file path)
>           #<bytecode -0x47e8150df949387>))
>  (t . #f(compiled-function
>      (file path)
>      #<bytecode -0x47e8150df949387>)))
> 
> It's from:
> 
> (cl-defmethod cl-print-object ((object compiled-function) stream)
>   (unless stream (setq stream standard-output))
>   ;; We use "#f(...)" rather than "#<...>" so that pp.el gives better
> results.
>   (princ "#f(compiled-function " stream)
> 
> I.e., it's from the "pretty" version of prin1, and is not meant to be
> readable by the Lisp reader.
> 
> I've now mentioned this in the Special Read Syntax node in the lispref
> manual in Emacs 28.2.

Thanks, that's a start (and all that the bug report
requested: document in the manual).

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$%@#(*&{}:"|?><(/.,!!".

https://stackoverflow.com/a/72561466/729907





  reply	other threads:[~2022-06-09 14:04 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-06-08 16:56 bug#55853: 28.1; Please document f#(...) syntax in Elisp manual Drew Adams
2022-06-09 13:22 ` Lars Ingebrigtsen
2022-06-09 14:04   ` Drew Adams [this message]
2022-07-05 15:11     ` Michael Heerdegen
2022-07-05 15:23       ` Drew Adams
2022-07-05 18:55         ` Michael Heerdegen
2022-07-05 19:06           ` Drew Adams

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=SJ0PR10MB5488DD703161FDE1F02F2951F3A79@SJ0PR10MB5488.namprd10.prod.outlook.com \
    --to=drew.adams@oracle.com \
    --cc=55853@debbugs.gnu.org \
    --cc=larsi@gnus.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.