1 files changed, 4 insertions, 3 deletions
diff --git a/object.c b/object.c
index 86a852c588..faf6db7d8f 100644
--- a/object.c
+++ b/object.c
@@ -1678,9 +1678,10 @@ rb_false(VALUE obj)
  *  call-seq:
  *     obj =~ other  -> nil
  *
- *  Pattern Match---Overridden by descendants (notably
- *  <code>Regexp</code> and <code>String</code>) to provide meaningful
- *  pattern-match semantics.
+ * This method is deprecated.
+ *
+ * This is not only unuseful but also troublesome because it
+ * may hide a type error.
  */
 
 static VALUE