* 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

2 files changed, 20 insertions, 2 deletions

diff --git a/ChangeLog b/ChangeLog
index a8aa69827..bc4ac6910 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Wed Jun  4 18:53:39 2008  Yukihiro Matsumoto  <matz@ruby-lang.org>
+
+	* object.c (rb_obj_alloc): RDoc updated.  a patch from Gaston
+	  Ramos <ramos.gaston at gmail.com> in [ruby-core:17073].
+
 Wed Jun  4 18:36:11 2008  Yukihiro Matsumoto  <matz@ruby-lang.org>
 
 	* lib/rdoc.rb: massive spelling correction patch from Evan Farrar
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
  *     
  */