From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Tue, 6 Jul 2021 17:13:45 +0000 (+0200)
Subject: Explain what ( . c) means to the Emacs Lisp reader
X-Git-Tag: emacs-28.0.90~1941
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=abe5eb9adda956ccc72af02d714025701e528b55;p=emacs.git

Explain what ( . c) means to the Emacs Lisp reader

* doc/lispref/objects.texi (Dotted Pair Notation): Explain what
( . c) means to the Lisp reader (bug#24875).
---

diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index d8091f1b4b1..365d5ac8d61 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -1001,6 +1001,13 @@ It looks like this:
 @end example
 @end ifnottex
 
+  As a somewhat peculiar side effect of @code{(a b . c)} and
+@code{(a . (b . c))} being equivalent, for consistency this means
+that if you replace @code{b} here with the empty sequence, then it
+follows that @code{(a . c)} and @code{(a . ( . c))} are equivalent,
+too.  This also means that @code{( .  c)} is equivalent to @code{c},
+but this is seldom used.
+
 @node Association List Type
 @subsubsection Association List Type