[DOC] Harmonize lt methods

1 files changed, 8 insertions, 7 deletions

diff --git a/object.c b/object.c
index 158bb0b219..b2b7a9d960 100644
--- a/object.c
+++ b/object.c
@@ -1948,14 +1948,15 @@ rb_class_inherited_p(VALUE mod, VALUE arg)
 
 /*
  * call-seq:
- *   mod < other   ->  true, false, or nil
+ *   self < other -> true, false, or nil
  *
- * Returns true if <i>mod</i> is a subclass of <i>other</i>. Returns
- * <code>false</code> if <i>mod</i> is the same as <i>other</i>
- * or <i>mod</i> is an ancestor of <i>other</i>.
- * Returns <code>nil</code> if there's no relationship between the two.
- * (Think of the relationship in terms of the class definition:
- * "class A < B" implies "A < B".)
+ * Returns whether +self+ is a subclass of +other+,
+ * or +nil+ if there is no relationship between the two:
+ *
+ *   Float < Numeric # => true
+ *   Numeric < Float # => false
+ *   Float < Float   # => false
+ *   Float < Hash    # => nil
  *
  */