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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#60639: closed (Improvement to the Wording of GNU Emacs Lisp
 Reference Manual)
Date: Wed, 06 Sep 2023 12:51:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Wed, 06 Sep 2023 15:50:23 +0300
with message-id <83wmx31n5c.fsf <at> gnu.org>
and subject line Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp Reference Manual
has caused the debbugs.gnu.org bug report #60639,
regarding Improvement to the Wording of GNU Emacs Lisp Reference Manual
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
60639: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=60639
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Xie Shynur <one.last.kiss <at> outlook.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: Improvement to the Wording of GNU Emacs Lisp Reference Manual
Date: Sat, 7 Jan 2023 19:41:17 +0000

[Message part 3 (text/plain, inline)]

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".

[0001-better-word-for-hash-notation.patch (application/octet-stream, attachment)]

[Message part 5 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 60639-done <at> debbugs.gnu.org, one.last.kiss <at> outlook.com,
 drew.adams <at> oracle.com
Subject: Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp Reference
 Manual
Date: Wed, 06 Sep 2023 15:50:23 +0300

> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Wed, 6 Sep 2023 04:56:18 -0700
> Cc: drew.adams <at> oracle.com, one.last.kiss <at> outlook.com, 60639 <at> debbugs.gnu.org
> 
> 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.

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

Previous Next

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