summaryrefslogtreecommitdiff
path: root/doc/lispref/lists.texi
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2013-08-13 00:15:27 -0700
committerGlenn Morris <rgm@gnu.org>2013-08-13 00:15:27 -0700
commit3e6b67c9b7230bf10219082d9215d9617a33715e (patch)
treee55e450b9ef0cc50ec144e1b3264a20cf14189b3 /doc/lispref/lists.texi
parent16bcc96df4447cb5c47e53a4512671a2da7504f8 (diff)
downloademacs-3e6b67c9b7230bf10219082d9215d9617a33715e.tar.gz
* lispref/lists.texi (List Elements): Undocument nth, nthcdr with n < 0
Diffstat (limited to 'doc/lispref/lists.texi')
-rw-r--r--doc/lispref/lists.texi15
1 files changed, 7 insertions, 8 deletions
diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi
index 14601de1814..9daf01cd0a2 100644
--- a/doc/lispref/lists.texi
+++ b/doc/lispref/lists.texi
@@ -270,8 +270,10 @@ are numbered starting with zero, so the @sc{car} of @var{list} is
element number zero. If the length of @var{list} is @var{n} or less,
the value is @code{nil}.
-If @var{n} is negative, @code{nth} returns the first element of
-@var{list}.
+@c Behavior for -ve n undefined since 2013/08; see bug#15059.
+@ignore
+If @var{n} is negative, @code{nth} returns the first element of @var{list}.
+@end ignore
@example
@group
@@ -281,10 +283,6 @@ If @var{n} is negative, @code{nth} returns the first element of
@group
(nth 10 '(1 2 3 4))
@result{} nil
-@end group
-@group
-(nth -3 '(1 2 3 4))
- @result{} 1
(nth n x) @equiv{} (car (nthcdr n x))
@end group
@@ -300,7 +298,8 @@ This function returns the @var{n}th @sc{cdr} of @var{list}. In other
words, it skips past the first @var{n} links of @var{list} and returns
what follows.
-If @var{n} is zero or negative, @code{nthcdr} returns all of
+@c "or negative" removed 2013/08; see bug#15059.
+If @var{n} is zero, @code{nthcdr} returns all of
@var{list}. If the length of @var{list} is @var{n} or less,
@code{nthcdr} returns @code{nil}.
@@ -314,7 +313,7 @@ If @var{n} is zero or negative, @code{nthcdr} returns all of
@result{} nil
@end group
@group
-(nthcdr -3 '(1 2 3 4))
+(nthcdr 0 '(1 2 3 4))
@result{} (1 2 3 4)
@end group
@end example