2 files changed, 15 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog
index 48baf4f4b1..53c258ac7f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Sun Jun 22 09:51:14 2008  Nobuyoshi Nakada  <nobu@ruby-lang.org>
+
+	* object.c (rb_class_superclass): rdoc improvement, a patch from
+	  Gaston Ramos <ramos.gaston AT gmail.com> in [ruby-core:17371].
+
 Sun Jun 22 07:16:42 2008  Nobuyoshi Nakada  <nobu@ruby-lang.org>
 
 	* string.c (str_buf_cat): check for self concatenation.
diff --git a/object.c b/object.c
index 75153b843a..548e6acf2c 100644
--- a/object.c
+++ b/object.c
@@ -1652,9 +1652,16 @@ rb_class_new_instance(argc, argv, klass)
  *  
  *  Returns the superclass of <i>class</i>, or <code>nil</code>.
  *     
- *     File.superclass     #=> IO
- *     IO.superclass       #=> Object
- *     Object.superclass   #=> nil
+ *     File.superclass         #=> IO
+ *     IO.superclass           #=> Object
+ *
+ *     class Foo; end
+ *     class Bar < Foo; end
+ *     Bar.superclass          #=> Foo
+ *
+ *  returns nil when the given class hasn't a parent class:
+ *
+ *     Object.superclass       #=> nil
  *     
  */