From 17f6a689629ec3507a79fc156833f329dc641bed Mon Sep 17 00:00:00 2001
From: Burdette Lamar <BurdetteLamar@Yahoo.com>
Date: Fri, 7 Mar 2025 08:38:51 -0600
Subject: [PATCH] [DOC] Tweaks for Hash#rehash

---
 hash.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/hash.c b/hash.c
index 32180b3c7e..717a5e9d69 100644
--- a/hash.c
+++ b/hash.c
@@ -1988,8 +1988,9 @@ rb_hash_rehash_i(VALUE key, VALUE value, VALUE arg)
  *  call-seq:
  *     rehash -> self
  *
- *  Rebuilds the hash table by recomputing the hash index for each key;
+ *  Rebuilds the hash table for +self+ by recomputing the hash index for each key;
  *  returns <tt>self</tt>.
+ *  Calling this method ensures that the hash table is valid.
  *
  *  The hash table becomes invalid if the hash value of a key
  *  has changed after the entry was created.