[Emacs-diffs] Changes to emacs/lispref/lists.texi

[Richard M. Stallman]

Index: emacs/lispref/lists.texi
diff -c emacs/lispref/lists.texi:1.37 emacs/lispref/lists.texi:1.38
*** emacs/lispref/lists.texi:1.37       Thu Sep 11 21:03:37 2003
--- emacs/lispref/lists.texi    Tue Sep 30 09:00:23 2003
***************
*** 1670,1683 ****
  @defun assq-delete-all key alist
  @tindex assq-delete-all
  This function deletes from @var{alist} all the elements whose @sc{car}
! is @code{eq} to @var{key}.  It returns @var{alist}, modified
! in this way.  Note that it modifies the original list structure
! of @var{alist}.
  
  @example
! (assq-delete-all 'foo
!                  '((foo 1) (bar 2) (foo 3) (lose 4)))
       @result{} ((bar 2) (lose 4))
  @end example
  @end defun
  
--- 1670,1688 ----
  @defun assq-delete-all key alist
  @tindex assq-delete-all
  This function deletes from @var{alist} all the elements whose @sc{car}
! is @code{eq} to @var{key}, much as if you used @code{delq} to delete
! such each element one by one.  It returns the shortened alist, and
! often modifies the original list structure of @var{alist}.  For
! correct results, use the return value of @code{assq-delete-all} rather
! than looking at the saved value of @var{alist}.
  
  @example
! (setq alist '((foo 1) (bar 2) (foo 3) (lose 4)))
!      @result{} ((foo 1) (bar 2) (foo 3) (lose 4))
! (assq-delete-all 'foo alist)
       @result{} ((bar 2) (lose 4))
+ alist
+      @result{} ((foo 1) (bar 2) (lose 4))
  @end example
  @end defun