diff options
| -rw-r--r-- | lispref/ChangeLog | 5 | ||||
| -rw-r--r-- | lispref/lists.texi | 12 |
2 files changed, 15 insertions, 2 deletions
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)) |