Add more documentation on #eql?/#hash relationship [ci skip]

Fixes [Bug #14263]

1 files changed, 5 insertions, 1 deletions

diff --git a/object.c b/object.c
index 30f2d88831..3aa7cd20d2 100644
--- a/object.c
+++ b/object.c
@@ -186,7 +186,11 @@ rb_eql(VALUE obj1, VALUE obj2)
  *
  *  The #eql? method returns <code>true</code> if +obj+ and +other+
  *  refer to the same hash key.  This is used by Hash to test members
- *  for equality.  For objects of class Object, #eql?  is synonymous
+ *  for equality.  For any pair of objects where #eql? returns +true+,
+ *  the #hash value of both objects must be equal. So any subclass
+ *  that overrides #eql? should also override #hash appropriately.
+ *
+ *  For objects of class Object, #eql?  is synonymous
  *  with #==.  Subclasses normally continue this tradition by aliasing
  *  #eql? to their overridden #== method, but there are exceptions.
  *  Numeric types, for example, perform type conversion across #==,