GNU bug report logs - #60639
Improvement to the Wording of GNU Emacs Lisp Reference Manual

Previous Next

Full log

Message #34 received at 60639 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: one.last.kiss <at> outlook.com, drew.adams <at> oracle.com, 60639 <at> debbugs.gnu.org
Subject: Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp Reference
 Manual
Date: Wed, 6 Sep 2023 04:56:18 -0700

Eli Zaretskii <eliz <at> gnu.org> writes:

> I don't mind installing it, but IMO its wording needs some
> improvement.  Here's what I suggest to install:
>
>      In most cases, an object's printed representation is also a read
>    syntax for the object.  However, some types have no read syntax, since
>    it does not make sense to enter objects of these types as constants in
>    a Lisp program.  These objects are printed in @dfn{hash notation},
>    which consists of the characters @samp{#<}, a descriptive string
>    (typically the type name followed by the name of the object), and a
>    closing @samp{>}.  (This is called ``hash notation'' because it
>    begins with the @samp{#} character, known as ``hash'' or ``number
>    sign'').  For example:

Looks good to me.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.