Update documentation to reflect changes concerning eq hash tables.

Document MAKE-WEAK-EQ-HASH-TABLE and MAKE-WEAK-EQV-HASH-TABLE.
Warn that MAKE-EQ-HASH-TABLE and MAKE-EQV-HASH-TABLE may become
aliases for MAKE-STRONG-EQ-HASH-TABLE and MAKE-STRONG-EQV-HASH-TABLE
instead.  Suggest using MAKE-STRONG-EQ-HASH-TABLE for symbol-keyed
tables, rather than MAKE-EQ-HASH-TABLE.

diff --git a/doc/ref-manual/associations.texi b/doc/ref-manual/associations.texi
index c49daad63d699e3a139687e66a8342852a5a6492..d00ecfdf7b5bf5b7dc34567b51ba89db1901362f 100644 (file)
--- a/doc/ref-manual/associations.texi
+++ b/doc/ref-manual/associations.texi
@@ -420,20 +420,52 @@ prevents its keys from being reclaimed by the garbage collector, it is
 said to hold its keys @dfn{strongly}; otherwise it holds its keys
 @dfn{weakly} (@pxref{Weak Pairs}).
 
-@deffn procedure make-eq-hash-table [initial-size]
+@deffn procedure make-strong-eq-hash-table [initial-size]
 @findex eq?
 Returns a newly allocated hash table that accepts arbitrary objects as
 keys, and compares those keys with @code{eq?}.  The keys are held
-weakly.  These are the fastest of the standard hash tables.
+strongly.  These are the fastest of the standard hash tables.
 @end deffn
 
-@deffn procedure make-eqv-hash-table [initial-size]
+@deffn procedure make-weak-eq-hash-table [initial-size]
+@findex eq?
+Returns a newly allocated hash table that accepts arbitrary objects as
+keys, and compares those keys with @code{eq?}.  The keys are held
+weakly.
+@end deffn
+
+@deffn procedure make-eq-hash-table [initial-size]
+@findex eq?
+This is an alias for @code{make-weak-eq-hash-table}.
+
+@strong{Warning}:  This become an alias
+@code{make-strong-eq-hash-table} instead.  We recommend that you use
+@code{make-weak-eq-hash-table} explicitly for weak hash tables.
+@end deffn
+
+@deffn procedure make-strong-eqv-hash-table [initial-size]
+@findex eqv?
+Returns a newly allocated hash table that accepts arbitrary objects as
+keys, and compares those keys with @code{eqv?}.  The keys are held
+strongly.  These hash tables are a little slower than those made by
+@code{make-strong-eq-hash-table}.
+@end deffn
+
+@deffn procedure make-weak-eqv-hash-table [initial-size]
 @findex eqv?
 Returns a newly allocated hash table that accepts arbitrary objects as
 keys, and compares those keys with @code{eqv?}.  The keys are held
-weakly, except that booleans, characters, and numbers are held strongly.
-These hash tables are a little slower than those made by
-@code{make-eq-hash-table}.
+weakly, except that booleans, characters, numbers, and interned symbols
+are held strongly.
+@end deffn
+
+@deffn procedure make-eqv-hash-table [initial-size]
+@findex eqv?
+This is an alias for @code{make-weak-eqv-hash-table}.
+
+@strong{Warning}:  This become an alias for
+@code{make-strong-eqv-hash-table} instead.  We recommend that you use
+@code{make-weak-eqv-hash-table} explicitly for weak hash tables.
 @end deffn
 
 @deffn procedure make-equal-hash-table [initial-size]
@@ -441,7 +473,7 @@ These hash tables are a little slower than those made by
 Returns a newly allocated hash table that accepts arbitrary objects as
 keys, and compares those keys with @code{equal?}.  The keys are held
 strongly.  These hash tables are quite a bit slower than those made by
-@code{make-eq-hash-table}.
+@code{make-strong-eq-hash-table}.
 @end deffn
 
 @deffn procedure make-string-hash-table [initial-size]
@@ -492,7 +524,7 @@ been defined:
 @findex string=?
 @example
 @group
-(define make-eq-hash-table
+(define make-weak-eq-hash-table
   (weak-hash-table/constructor eq-hash-mod eq? #t))
 
 (define make-equal-hash-table
@@ -819,12 +851,12 @@ standard address-hash-based hash tables.
 
 @deffn procedure eq-hash-mod object modulus
 This procedure is the key-hashing procedure used by
-@code{make-eq-hash-table}.
+@code{make-strong-eq-hash-table}.
 @end deffn
 
 @deffn procedure eqv-hash-mod object modulus
 This procedure is the key-hashing procedure used by
-@code{make-eqv-hash-table}.
+@code{make-strong-eqv-hash-table}.
 @end deffn
 
 @deffn procedure equal-hash-mod object modulus

diff --git a/doc/ref-manual/misc-datatypes.texi b/doc/ref-manual/misc-datatypes.texi
index 54524b962acae3acac97381ca7064984d7418d4e..1783c691011bceea2f6a4076f65e10d7ffeaaf33 100644 (file)
--- a/doc/ref-manual/misc-datatypes.texi
+++ b/doc/ref-manual/misc-datatypes.texi
@@ -396,9 +396,9 @@ non-negative integer.
 @end example
 
 This procedure is provided for convenience in constructing hash tables.
-However, it is normally preferable to use @code{make-eq-hash-table} to
-build hash tables keyed by symbols, because @code{eq?} hash tables are
-much faster.
+However, it is normally preferable to use
+@code{make-strong-eq-hash-table} to build hash tables keyed by symbols,
+because @code{eq?} hash tables are much faster.
 @end deffn
 
 @deffn procedure symbol<? symbol1 symbol2