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

[Luc Teirlinck]

Index: emacs/lispref/hash.texi
diff -c emacs/lispref/hash.texi:1.10 emacs/lispref/hash.texi:1.11
*** emacs/lispref/hash.texi:1.10        Mon Sep  1 11:45:41 2003
--- emacs/lispref/hash.texi     Sat Nov  8 23:44:28 2003
***************
*** 76,83 ****
  
  @table @code
  @item eql
! Keys which are numbers are ``the same'' if they are equal in value;
! otherwise, two distinct objects are never ``the same''.
  
  @item eq
  Any two distinct Lisp objects are ``different'' as keys.
--- 76,84 ----
  
  @table @code
  @item eql
! Keys which are numbers are ``the same'' if they are @code{equal}, that
! is, if they are equal in value and either both are integers or both
! are floats; otherwise, two distinct objects are never ``the same''.
  
  @item eq
  Any two distinct Lisp objects are ``different'' as keys.
***************
*** 158,165 ****
  argument list.  The argument @var{test} specifies the method
  of key lookup.
  
! If you want to specify other parameters, you should use
! @code{make-hash-table}.
  @end defun
  
  @node Hash Access
--- 159,165 ----
  argument list.  The argument @var{test} specifies the method
  of key lookup.
  
! This function is obsolete. Use @code{make-hash-table} instead.
  @end defun
  
  @node Hash Access
***************
*** 187,192 ****
--- 187,196 ----
  This function removes the association for @var{key} from @var{table}, if
  there is one.  If @var{key} has no association, @code{remhash} does
  nothing.
+ 
+ @b{Common Lisp note:} In Common Lisp, @code{remhash} returns
+ address@hidden if it actually removed an association and @code{nil}
+ otherwise.  In Emacs Lisp, @code{remhash} always returns @code{nil}.
  @end defun
  
  @tindex clrhash
***************
*** 194,199 ****
--- 198,206 ----
  This function removes all the associations from hash table @var{table},
  so that it becomes empty.  This is also called @dfn{clearing} the hash
  table.
+ 
+ @b{Common Lisp note:} In Common Lisp, @code{clrhash} returns the empty
+ @var{table}.  In Emacs Lisp, it returns @code{nil}.
  @end defun
  
  @tindex maphash
***************
*** 255,262 ****
  @var{obj1})} and @code{(sxhash @var{obj2})} are the same integer.
  
  If the two objects are not equal, the values returned by @code{sxhash}
! are usually different, but not always; but once in a rare while, by
! luck, you will encounter two distinct-looking objects that give the same
  result from @code{sxhash}.
  @end defun
  
--- 262,269 ----
  @var{obj1})} and @code{(sxhash @var{obj2})} are the same integer.
  
  If the two objects are not equal, the values returned by @code{sxhash}
! are usually different, but not always; once in a rare while, by luck,
! you will encounter two distinct-looking objects that give the same
  result from @code{sxhash}.
  @end defun