[Emacs-diffs] Changes to emacs/lispref/sequences.texi [emacs-unicode-2]

[Miles Bader]

Index: emacs/lispref/sequences.texi
diff -c emacs/lispref/sequences.texi:1.18.6.1 
emacs/lispref/sequences.texi:1.18.6.2
*** emacs/lispref/sequences.texi:1.18.6.1       Mon Apr 19 07:01:43 2004
--- emacs/lispref/sequences.texi        Mon Jun 28 07:28:59 2004
***************
*** 69,76 ****
  sequence.
  
  @defun sequencep object
! Returns @code{t} if @var{object} is a list, vector,
! string, bool-vector, or char-table, @code{nil} otherwise.
  @end defun
  
  @defun length sequence
--- 69,76 ----
  sequence.
  
  @defun sequencep object
! Returns @code{t} if @var{object} is a list, vector, string,
! bool-vector, or char-table, @code{nil} otherwise.
  @end defun
  
  @defun length sequence
***************
*** 80,91 ****
  @cindex sequence length
  @cindex char-table length
  This function returns the number of elements in @var{sequence}.  If
! @var{sequence} is a cons cell that is not a list (because the final
! @sc{cdr} is not @code{nil}), a @code{wrong-type-argument} error is
! signaled.  For a char-table, the value returned is always one more
! than the maximum Emacs character code.
  
! @xref{List Elements}, for the related function @code{safe-length}.
  
  @example
  @group
--- 80,91 ----
  @cindex sequence length
  @cindex char-table length
  This function returns the number of elements in @var{sequence}.  If
! @var{sequence} is a dotted list, a @code{wrong-type-argument} error is
! signaled.  Circular lists may cause an infinite loop.  For a
! char-table, the value returned is always one more than the maximum
! Emacs character code.
  
! @xref{Definition of safe-length}, for the related function @code{safe-length}.
  
  @example
  @group
***************
*** 121,130 ****
  @defun elt sequence index
  @cindex elements of sequences
  This function returns the element of @var{sequence} indexed by
! @var{index}.  Legitimate values of @var{index} are integers ranging from
! 0 up to one less than the length of @var{sequence}.  If @var{sequence}
! is a list, then out-of-range values of @var{index} return @code{nil};
! otherwise, they trigger an @code{args-out-of-range} error.
  
  @example
  @group
--- 121,131 ----
  @defun elt sequence index
  @cindex elements of sequences
  This function returns the element of @var{sequence} indexed by
! @var{index}.  Legitimate values of @var{index} are integers ranging
! from 0 up to one less than the length of @var{sequence}.  If
! @var{sequence} is a list, out-of-range values behave as for
! @code{nth}.  @xref{Definition of nth}.  Otherwise, out-of-range values
! trigger an @code{args-out-of-range} error.
  
  @example
  @group
***************
*** 151,157 ****
  @end example
  
  This function generalizes @code{aref} (@pxref{Array Functions}) and
! @code{nth} (@pxref{List Elements}).
  @end defun
  
  @defun copy-sequence sequence
--- 152,158 ----
  @end example
  
  This function generalizes @code{aref} (@pxref{Array Functions}) and
! @code{nth} (@pxref{Definition of nth}).
  @end defun
  
  @defun copy-sequence sequence
***************
*** 171,176 ****
--- 172,180 ----
  list.  However, the actual values of the properties are shared.
  @xref{Text Properties}.
  
+ This function does not work for dotted lists.  Trying to copy a
+ circular list may cause an infinite loop.
+ 
  See also @code{append} in @ref{Building Lists}, @code{concat} in
  @ref{Creating Strings}, and @code{vconcat} in @ref{Vector Functions},
  for other ways to copy sequences.
***************
*** 472,480 ****
  @defun vconcat &rest sequences
  @cindex copying vectors
  This function returns a new vector containing all the elements of the
! @var{sequences}.  The arguments @var{sequences} may be any kind of
! arrays, including lists, vectors, or strings.  If no @var{sequences} are
! given, an empty vector is returned.
  
  The value is a newly constructed vector that is not @code{eq} to any
  existing vector.
--- 476,484 ----
  @defun vconcat &rest sequences
  @cindex copying vectors
  This function returns a new vector containing all the elements of the
! @var{sequences}.  The arguments @var{sequences} may be true lists,
! vectors, strings or bool-vectors.  If no @var{sequences} are given, an
! empty vector is returned.
  
  The value is a newly constructed vector that is not @code{eq} to any
  existing vector.