(SRFI-1 Selectors): In drop-right, note always a
authorKevin Ryde <user42@zip.com.au>
Tue, 3 May 2005 22:50:21 +0000 (22:50 +0000)
committerKevin Ryde <user42@zip.com.au>
Tue, 3 May 2005 22:50:21 +0000 (22:50 +0000)
new list.  In take-right, note result shares common tail.  Per spec.

doc/ref/srfi-modules.texi

index a29784d..0dda78c 100644 (file)
@@ -361,6 +361,7 @@ Return a list containing all but the first @var{i} elements of
 
 @deffn {Scheme Procedure} take-right lst i
 Return the a list containing the @var{i} last elements of @var{lst}.
+The return shares a common tail with @var{lst}.
 @end deffn
 
 @deffn {Scheme Procedure} drop-right lst i
@@ -368,8 +369,9 @@ Return the a list containing the @var{i} last elements of @var{lst}.
 Return the a list containing all but the @var{i} last elements of
 @var{lst}.
 
-@code{drop-right!} may modify the structure of the argument list
-@var{lst} in order to produce the result.
+@code{drop-right} always returns a new list, even when @var{i} is
+zero.  @code{drop-right!} may modify the structure of the argument
+list @var{lst} in order to produce the result.
 @end deffn
 
 @deffn {Scheme Procedure} split-at lst i