Update Module#instance_methods documentation for visibility changes/aliases

Requested by matz in comment on #18435.

1 files changed, 9 insertions, 0 deletions

diff --git a/class.c b/class.c
index 54d9e6e177..5e57068f03 100644
--- a/class.c
+++ b/class.c
@@ -1755,6 +1755,15 @@ class_instance_method_list(int argc, const VALUE *argv, VALUE mod, int obj, int
  *     B.instance_methods(true).include?(:method1) #=> true
  *     C.instance_methods(false)                   #=> [:method3]
  *     C.instance_methods.include?(:method2)       #=> true
+ *
+ *  Note that method visibility changes in the current class, as well as aliases,
+ *  are considered as methods of the current class by this method:
+ *
+ *     class C < B
+ *       alias method4 method2
+ *       protected :method2
+ *     end
+ *     C.instance_methods(false).sort               #=> [:method2, :method3, :method4]
  */
 
 VALUE