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: Xie Shynur <one.last.kiss <at> outlook.com>
Subject: bug#60639: closed (Re: bug#60639: 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 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 60639 <at> debbugs.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: 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.

[Message part 3 (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 4 (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)]

Previous Next

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