mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-30 20:32:00 -08:00
Code Issues Projects Releases Wiki Activity

(Building Lists): Add footnote to explain how to add

Browse source 
to the end of a list.
This commit is contained in:
Stefan Monnier 2000-11-12 15:14:15 +00:00
parent f5ed37df73
commit 1e344ee245
2 changed files with 15 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

5
lispref/ChangeLog
View file

@ -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.

12
lispref/lists.texi
View file

@ -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))