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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 60639 in the body.
You can then email your comments to 60639 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

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 1 (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 #10 received at 60639 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Xie Shynur <one.last.kiss <at> outlook.com>
Cc: 60639 <at> debbugs.gnu.org
Subject: Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp Reference
 Manual
Date: Tue, 5 Sep 2023 16:38:55 -0700

tags 60639 wontfix
close 60639
thanks

Xie Shynur <one.last.kiss <at> outlook.com> writes:

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

I don't think "number sign" is very clear, and to be honest I think
our target audience should have to learn that "#" is called a hash.

So we won't be making this change.  Sorry.

Closing this as wontfix.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Stefan Kangas <stefankangas <at> gmail.com>, Xie Shynur
 <one.last.kiss <at> outlook.com>
Cc: "60639 <at> debbugs.gnu.org" <60639 <at> debbugs.gnu.org>
Subject: RE: [External] : bug#60639: Improvement to the Wording of GNU Emacs
 Lisp Reference Manual
Date: Wed, 6 Sep 2023 01:27:56 +0000

> > In the section 2.1 "Printed Representation and Read Syntax"
> > (.../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".
> 
> I don't think "number sign" is very clear, and to be honest I think
> our target audience should have to learn that "#" is called a hash.
> 
> So we won't be making this change.  Sorry.
> Closing this as wontfix.

If you're talking about this ASCII and Unicode
character: #, then Emacs (`C-u C-x =') tells us
the name for it is NUMBER SIGN:

Character code properties: customize what to show
  name: NUMBER SIGN
  general-category: Po (Punctuation, Other)
  decomposition: (35) ('#')

I do agree that "hash notation" is one way to
refer to use of the "hash" symbol.

But how about referring to the character by its
several names?  (It's also called "pound sign".)

A simple sentence such as this in Wikipedia can
make things clear:

 "The symbol # is known variously in
  English-speaking regions as the number sign,[1]
  hash,[2] or pound sign.[3]"

https://en.wikipedia.org/wiki/Number_sign

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Stefan Kangas <stefankangas <at> gmail.com>, Xie Shynur
 <one.last.kiss <at> outlook.com>
Cc: "60639 <at> debbugs.gnu.org" <60639 <at> debbugs.gnu.org>
Subject: RE: [External] : bug#60639: Improvement to the Wording of GNU Emacs
 Lisp Reference Manual
Date: Wed, 6 Sep 2023 01:33:03 +0000

(To be clear, with "How about...?" I meant
in the Elisp doc cited, not in the output of
`C-u C-x ='.)

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

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Drew Adams <drew.adams <at> oracle.com>, Xie Shynur <one.last.kiss <at> outlook.com>
Cc: "60639 <at> debbugs.gnu.org" <60639 <at> debbugs.gnu.org>
Subject: RE: [External] : bug#60639: Improvement to the Wording of GNU Emacs
 Lisp Reference Manual
Date: Tue, 5 Sep 2023 18:46:08 -0700

reopen 60639
thanks

Drew Adams <drew.adams <at> oracle.com> writes:

> A simple sentence such as this in Wikipedia can
> make things clear:
>
>  "The symbol # is known variously in
>   English-speaking regions as the number sign,[1]
>   hash,[2] or pound sign.[3]"
>
> https://en.wikipedia.org/wiki/Number_sign

Fair enough.

The patch actually just adds it as an alternative, so in that sense it's
already okay.  If there are no objections, I think we could install this
patch, then.  Let's see if there are any other opinions first though.

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

From: Visuwesh <visuweshm <at> gmail.com>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: Xie Shynur <one.last.kiss <at> outlook.com>, 60639 <at> debbugs.gnu.org
Subject: Re: bug#60639: Improvement to the Wording of GNU Emacs Lisp
 Reference Manual
Date: Wed, 06 Sep 2023 13:28:36 +0530

[செவ்வாய் செப்டம்பர் 05, 2023] Stefan Kangas wrote:

> tags 60639 wontfix
> close 60639
> thanks
>
> Xie Shynur <one.last.kiss <at> outlook.com> writes:
>
>> 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".
>
> I don't think "number sign" is very clear, and to be honest I think
> our target audience should have to learn that "#" is called a hash.

FWIW, we never use "#" before numbers, we simply write "No." so "number
sign" is an alien term.  People here call "#" hash or hashtag.

> So we won't be making this change.  Sorry.
>
> Closing this as wontfix.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
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, 06 Sep 2023 14:52:02 +0300

> Cc: "60639 <at> debbugs.gnu.org" <60639 <at> debbugs.gnu.org>
> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Tue, 5 Sep 2023 18:46:08 -0700
> 
> reopen 60639
> thanks
> 
> Drew Adams <drew.adams <at> oracle.com> writes:
> 
> > A simple sentence such as this in Wikipedia can
> > make things clear:
> >
> >  "The symbol # is known variously in
> >   English-speaking regions as the number sign,[1]
> >   hash,[2] or pound sign.[3]"
> >
> > https://en.wikipedia.org/wiki/Number_sign
> 
> Fair enough.
> 
> The patch actually just adds it as an alternative, so in that sense it's
> already okay.  If there are no objections, I think we could install this
> patch, then.  Let's see if there are any other opinions first though.

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:

The main point here is that "hash notation" is NOT what's known as
"number sign"; rather, the # character itself is known as "number
sign".

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.

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

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.