bug#18957: 25.0.50; document #: in Elisp manual

bug#18957: 25.0.50; document #: in Elisp manual

[Drew Adams]

`#:' 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@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

bug#18957: 25.0.50; document #: in Elisp manual

[Lars Ingebrigtsen]

Drew Adams <drew.adams@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

bug#18957: 25.0.50; document #: in Elisp manual

[Lars Ingebrigtsen]

Drew Adams <drew.adams@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

bug#18957: 25.0.50; document #: in Elisp manual

[Noam Postavsky]

Lars Ingebrigtsen <larsi@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")).

bug#18957: 25.0.50; document #: in Elisp manual

[Lars Ingebrigtsen]

Noam Postavsky <npostavs@gmail.com> writes:

> Lars Ingebrigtsen <larsi@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

bug#18957: 25.0.50; document #: in Elisp manual

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Date: Sat, 12 Oct 2019 20:58:54 +0200
> Cc: 18957@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.

bug#18957: 25.0.50; document #: in Elisp manual

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@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