; Add comment to hash_table_rehash (Bug#36447)

* src/fns.c (hash_table_rehash): Add a comment to explain that
hash_table_rehash is not used in "normal" rehashing, but only in the
rare case of rehashing on the first access to a preloaded hash-table.

diff --git a/src/fns.c b/src/fns.c
index 238a37193c1d0d6eb5494e7584569adfcc59bdd8..0497588689b9ea1d3ab4625f0678d2c3eefc5034 100644 (file)
--- a/src/fns.c
+++ b/src/fns.c
@@ -4231,6 +4231,11 @@ maybe_resize_hash_table (struct Lisp_Hash_Table *h)
     }
 }
 
+/* Recompute the hashes (and hence also the "next" pointers).
+   Normally there's never a need to recompute hashes.
+   This is done only on first-access to a hash-table loaded from
+   the "pdump", because the object's addresses may have changed, thus
+   affecting their hash.  */
 void
 hash_table_rehash (struct Lisp_Hash_Table *h)
 {