Add `last'.

diff --git a/lispref/lists.texi b/lispref/lists.texi
index 64e634d2803d428192dcc5aed4607767d2f6a91e..458d011c489fbc9b708454002a6a2e31bfca018f 100644 (file)
--- a/lispref/lists.texi
+++ b/lispref/lists.texi
@@ -383,6 +383,14 @@ If @var{n} is zero or negative, @code{nthcdr} returns all of
 @end example
 @end defun
 
+@defun last list &optional n
+This function reruns the last link of the given @var{list}.  The
+@code{car} of this link is the list's last element.  If @var{list} is
+null, @code{nil} is returned.  If @var{n} is non-nil the
+@var{n}-th-to-last link is returned instead, or the whole @var{list} if
+@var{n} is bigger than @var{list}'s length.
+@end defun
+
 @defun safe-length list
 This function returns the length of @var{list}, with no risk
 of either an error or an infinite loop.