[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#17403: 24.4.50; package-alist doc-string error
|
From: |
Basil L. Contovounesios |
|
Subject: |
bug#17403: 24.4.50; package-alist doc-string error |
|
Date: |
Wed, 17 Jul 2019 15:23:03 +0100 |
|
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) |
tags 17403 notabug
close 17403
quit
Stefan Kangas <stefan@marxist.se> writes:
> Is it a problem that this is documented as "(PKG . DESCS)" when the
> printed representation is "(PKG DESCS)"?
No, because the implicit printed representation is actually
(PKG DESC...), not (PKG DESCS). In other words, the cadr of each alist
element is a single package-desc structure, not a list thereof. Both
the code and the docstring agree on this AFAICT.
Dotted notation is often employed in documentation in order to more
explicitly describe metasyntactic structure. This may initially confuse
users who see the implicit printed representation, but sooner or later
all Emacsites ought to learn that (A B) is equivalent to (A . (B)).
> If not, we can close this as notabug.
Done, thanks.
--
Basil