GNU bug report logs - #18957
25.0.50; document #: in Elisp 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 18957 in the body.
You can then email your comments to 18957 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: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; document #: in Elisp manual
Date: Wed, 5 Nov 2014 08:43:50 -0800 (PST)

`#:' should be documented properly in the Elisp manual.  There are just
a few in-passing references to it, which do not explain it.

The Lisp reader should be documented well, from a user point of view,
with everything affecting it explained - preferably in one place.

That includes `#<', `#:', `#N=', `#N#', `#@COUNT', `#$', `#.', comments,
number syntax (including non-10 radix), \-escaped newlines and spaces,
hash tables.

In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm <at> gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 18957 <at> debbugs.gnu.org
Subject: Re: bug#18957: 25.0.50; document #: in Elisp manual
Date: Sat, 30 Apr 2016 17:02:06 +0200

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

> `#:' should be documented properly in the Elisp manual.  There are just
> a few in-passing references to it, which do not explain it.
>
> The Lisp reader should be documented well, from a user point of view,
> with everything affecting it explained - preferably in one place.
>
> That includes `#<', `#:', `#N=', `#N#', `#@COUNT', `#$', `#.', comments,
> number syntax (including non-10 radix), \-escaped newlines and spaces,
> hash tables.

I think most of these are explained in the sections where the objects
they describe appears, but it would be nice to have a section that just
describes them all, yes.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 18957 <at> debbugs.gnu.org
Subject: Re: bug#18957: 25.0.50; document #: in Elisp manual
Date: Sat, 12 Oct 2019 20:58:54 +0200

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

> `#:' should be documented properly in the Elisp manual.  There are just
> a few in-passing references to it, which do not explain it.
>
> The Lisp reader should be documented well, from a user point of view,
> with everything affecting it explained - preferably in one place.
>
> That includes `#<', `#:', `#N=', `#N#', `#@COUNT', `#$', `#.', comments,
> number syntax (including non-10 radix), \-escaped newlines and spaces,
> hash tables.

#$ and #. doesn't seem to be things Emacs understands?  But I've now
added a new node that lists all the rest, which I think is a useful
overview.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Noam Postavsky <npostavs <at> gmail.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: Drew Adams <drew.adams <at> oracle.com>, 18957 <at> debbugs.gnu.org
Subject: Re: bug#18957: 25.0.50; document #: in Elisp manual
Date: Sat, 12 Oct 2019 15:04:57 -0400

Lars Ingebrigtsen <larsi <at> gnus.org> writes:

> #$ and #. doesn't seem to be things Emacs understands?

#$ translates to current file, and is documented at the end of (info
"(elisp) Docs and Compilation").  #. is indeed a Common Lisp thing only
(though it's mentioned in (info "(elisp) Eval During Compile")).

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Noam Postavsky <npostavs <at> gmail.com>
Cc: Drew Adams <drew.adams <at> oracle.com>, 18957 <at> debbugs.gnu.org
Subject: Re: bug#18957: 25.0.50; document #: in Elisp manual
Date: Sat, 12 Oct 2019 21:15:29 +0200

Noam Postavsky <npostavs <at> gmail.com> writes:

> Lars Ingebrigtsen <larsi <at> gnus.org> writes:
>
>> #$ and #. doesn't seem to be things Emacs understands?
>
> #$ translates to current file, and is documented at the end of (info
> "(elisp) Docs and Compilation").

Thanks; I thought I had grepped for it, but I must have gotten the
escaping wrong.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: drew.adams <at> oracle.com, 18957 <at> debbugs.gnu.org
Subject: Re: bug#18957: 25.0.50; document #: in Elisp manual
Date: Sat, 12 Oct 2019 22:25:53 +0300

> From: Lars Ingebrigtsen <larsi <at> gnus.org>
> Date: Sat, 12 Oct 2019 20:58:54 +0200
> Cc: 18957 <at> debbugs.gnu.org
> 
> I've now added a new node that lists all the rest, which I think is
> a useful overview.

When you add a new node, you need to update the @detailmenu in
elisp.texi, and sometimes also the @menu there.

Thanks.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: drew.adams <at> oracle.com, 18957 <at> debbugs.gnu.org
Subject: Re: bug#18957: 25.0.50; document #: in Elisp manual
Date: Sat, 12 Oct 2019 21:37:09 +0200

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

> When you add a new node, you need to update the @detailmenu in
> elisp.texi, and sometimes also the @menu there.

Ah, sorry.  I assumed that saying "make" would warn me about all I
needed to fix.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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