Subject: bug#60639: closed (Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp Reference Manual)

From: [email-masked] (GNU bug Tracking System)
Date: Wed, 06 Sep 2023 12:51:02 +0000

Your bug report

#60639: Improvement to the Wording of GNU Emacs Lisp Reference Manual

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
60639: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=60639
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp Reference Manual
From: Eli Zaretskii <[email-masked]>
To: Stefan Kangas <[email-masked]>
Cc: [email-masked], [email-masked], [email-masked]
Date: Wed, 06 Sep 2023 15:50:23 +0300
List-Id: <debbugs-submit.debbugs.gnu.org>

> From: Stefan Kangas <[email-masked]>
> Date: Wed, 6 Sep 2023 04:56:18 -0700
> Cc: [email-masked], [email-masked], [email-masked]
> 
> Eli Zaretskii <[email-masked]> 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.

Now installed on the emacs-29 branch, and closing the bug.

Subject: Improvement to the Wording of GNU Emacs Lisp Reference Manual
From: Xie Shynur <[email-masked]>
To: "[email-masked]" <[email-masked]>
Date: Sat, 7 Jan 2023 19:41:17 +0000
List-Id: <debbugs-submit.debbugs.gnu.org>

In the section 2.1 "Printed Representation and Read Syntax" (https://www.gnu.org/software/emacs/manual/html_node/elisp/Printed-Representation.html), word "hash notation" is used to refer to the symbol "#".
But it may well confuse non-native English speakers, because the "hash" is also associated with "hash function".

A better name for "#" is "number sign".