From: Stefan Monnier <monnier@iro.umontreal.ca>
Date: Sun, 12 Nov 2000 15:14:15 +0000 (+0000)
Subject: (Building Lists): Add footnote to explain how to add
X-Git-Tag: emacs-pretest-21.0.90~112
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1e344ee24587d2cf5e33cd5eb741d4edde20f33a;p=emacs.git

(Building Lists): Add footnote to explain how to add
to the end of a list.
---

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index e8e3a71f91b..64e61df4665 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2000-11-12  Stefan Monnier  <monnier@cs.yale.edu>
+
+	* lists.texi (Building Lists): Add footnote to explain how to add
+	to the end of a list.
+
 2000-10-25  Gerd Moellmann  <gerd@gnu.org>
 
 	* files.texi (Visiting Functions): Typos.
diff --git a/lispref/lists.texi b/lispref/lists.texi
index 458d011c489..222f723944f 100644
--- a/lispref/lists.texi
+++ b/lispref/lists.texi
@@ -457,8 +457,16 @@ objects, but most often @var{object2} is a list.
 
 @cindex consing
 @code{cons} is often used to add a single element to the front of a
-list.  This is called @dfn{consing the element onto the list}.  For
-example:
+list.  This is called @dfn{consing the element onto the list}.
+@footnote{There is no strictly equivalent way to add an element to
+the end of a list.  You can use @code{(append @var{listname} (list
+@var{newelt}))}, which creates a whole new list by copying @var{listname}
+and adding @var{newelt} to its end.  Or you can use @code{(nconc
+@var{listname} (list @var{newelt}))}, which modifies @var{listname}
+by following all the @sc{cdr}s and then replacing the terminating
+@code{nil}.  Compare this to adding an element to the beginning of a
+list with @code{cons}, which neither copies nor modifies the list.}
+For example:
 
 @example
 (setq list (cons newelt list))