[Emacs-diffs] trunk r113830: * lispref/lists.texi (List Elements): Undocument nth, nthcdr with n < 0

[Glenn Morris]

------------------------------------------------------------
revno: 113830
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Tue 2013-08-13 00:15:27 -0700
message:
  * lispref/lists.texi (List Elements): Undocument nth, nthcdr with n < 0
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/lists.texi         lists.texi-20091113204419-o5vbwnq5f7feedwu-6192

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-08-13 02:45:12 +0000
+++ b/doc/lispref/ChangeLog     2013-08-13 07:15:27 +0000
@@ -1,3 +1,8 @@
+2013-08-13  Glenn Morris  <address@hidden>
+
+       * lists.texi (List Elements):
+       Undocument behavior of nth and nthcdr with n < 0.  (Bug#15059)
+
 2013-08-13  Xue Fuqiao  <address@hidden>
 
        * frames.texi (Display Feature Testing): Add indexes.

=== modified file 'doc/lispref/lists.texi'
--- a/doc/lispref/lists.texi    2013-01-01 09:11:05 +0000
+++ b/doc/lispref/lists.texi    2013-08-13 07:15:27 +0000
@@ -270,8 +270,10 @@
 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
address@hidden
address@hidden Behavior for -ve n undefined since 2013/08; see bug#15059.
address@hidden
+If @var{n} is negative, @code{nth} returns the first element of @var{list}.
address@hidden ignore
 
 @example
 @group
@@ -281,10 +283,6 @@
 @group
 (nth 10 '(1 2 3 4))
      @result{} nil
address@hidden group
address@hidden
-(nth -3 '(1 2 3 4))
-     @result{} 1
 
 (nth n x) @equiv{} (car (nthcdr n x))
 @end group
@@ -300,7 +298,8 @@
 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
address@hidden "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 @@
      @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