3 files changed, 15 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 081bb0af31..c2012f93fd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Tue Feb 17 10:47:20 2015  Iain Beeston  <[email protected]>
+
+	* hash.c: Added docs to explain that #include? and #member? do not
+	  check member equality
+	* lib/set.rb: ditto
+
 Mon Feb 16 20:58:49 2015  Nobuyoshi Nakada  <[email protected]>
 
 	* compile.c (compile_massign): optimization for special case,
diff --git a/hash.c b/hash.c
index 454ded20fd..3ef6668f5f 100644
--- a/hash.c
+++ b/hash.c
@@ -1920,6 +1920,10 @@ rb_hash_values(VALUE hash)
  *     h.has_key?("a")   #=> true
  *     h.has_key?("z")   #=> false
  *
+ *  Note that <code>include?</code> and <code>member?</code> do not test member
+ *  equality using <code>==</code> as do other Enumerables.
+ *
+ *  See also Enumerable#include?
  */
 
 VALUE
diff --git a/lib/set.rb b/lib/set.rb
index a3f185538f..59d70e82ca 100644
--- a/lib/set.rb
+++ b/lib/set.rb
@@ -208,6 +208,11 @@ class Set
   end
 
   # Returns true if the set contains the given object.
+  #
+  # Note that <code>include?</code> and <code>member?</code> do not test member
+  # equality using <code>==</code> as do other Enumerables.
+  #
+  # See also Enumerable#include?
   def include?(o)
     @hash[o]
   end