* object.c (rb_obj_alloc): RDoc updated. a patch from Gaston

  Ramos <ramos.gaston at gmail.com> in [ruby-core:17073].

git-svn-id: http://svn.ruby-lang.org/repos/ruby/trunk@16813 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 15 insertions, 2 deletions

diff --git a/object.c b/object.c
index 5d49b2ab6..70e7f1983 100644
--- a/object.c
+++ b/object.c
@@ -1361,8 +1361,21 @@ rb_class_initialize(int argc, VALUE *argv, VALUE klass)
  *  call-seq:
  *     class.allocate()   =>   obj
  *  
- *  Allocates space for a new object of <i>class</i>'s class. The
- *  returned object must be an instance of <i>class</i>.
+ *  Allocates space for a new object of <i>class</i>'s class and does not
+ *  call initialize on the new instance. The returned object must be an
+ *  instance of <i>class</i>.
+ *  
+ *      klass = Class.new do
+ *        def initialize(*args)
+ *          @initialized = true
+ *        end
+ *      
+ *        def initialized?
+ *          @initialized || false
+ *        end
+ *      end
+ *      
+ *      klass.allocate.initialized? #=> false
  *     
  */