* object.c (rb_class_superclass): rdoc improvement, a patch from

  Gaston Ramos <ramos.gaston AT gmail.com> in [ruby-core:17371].


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_8@17533 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 10 insertions, 3 deletions

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
  *     
  */