ruby-changes:4909
From: ko1@a...
Date: Tue, 13 May 2008 15:11:13 +0900 (JST)
Subject: [ruby-changes:4909] knu - Ruby:r16402 (trunk): * enumerator.c: Update rdoc.
knu 2008-05-13 15:10:56 +0900 (Tue, 13 May 2008) New Revision: 16402 Modified files: trunk/ChangeLog trunk/enumerator.c Log: * enumerator.c: Update rdoc. (enumerator_initialize): Discourage the use. (enum_each_slice, enum_each_cons, enumerator_each) (enumerator_with_index): Add a note about a call without a block. http://svn.ruby-lang.org/cgi-bin/viewvc.cgi/trunk/ChangeLog?r1=16402&r2=16401&diff_format=u http://svn.ruby-lang.org/cgi-bin/viewvc.cgi/trunk/enumerator.c?r1=16402&r2=16401&diff_format=u Index: ChangeLog =================================================================== --- ChangeLog (revision 16401) +++ ChangeLog (revision 16402) @@ -1,3 +1,10 @@ +Tue May 13 15:09:38 2008 Akinori MUSHA <knu@i...> + + * enumerator.c: Update rdoc. + (enumerator_initialize): Discourage the use. + (enum_each_slice, enum_each_cons, enumerator_each) + (enumerator_with_index): Add a note about a call without a block. + Tue May 13 08:25:31 2008 Tanaka Akira <akr@f...> * io.c (rb_f_gets.): re-enable rdoc. Index: enumerator.c =================================================================== --- enumerator.c (revision 16401) +++ enumerator.c (revision 16402) @@ -114,8 +114,10 @@ /* * call-seq: * e.each_slice(n) {...} + * e.each_slice(n) * - * Iterates the given block for each slice of <n> elements. + * Iterates the given block for each slice of <n> elements. If no + * block is given, returns an enumerator. * * e.g.: * (1..10).each_slice(3) {|a| p a} @@ -165,9 +167,10 @@ /* * call-seq: * each_cons(n) {...} + * each_cons(n) * * Iterates the given block for each array of consecutive <n> - * elements. + * elements. If no block is given, returns an enumerator.a * * e.g.: * (1..10).each_cons(3) {|a| p a} @@ -236,12 +239,8 @@ * used as an Enumerable object using the given object's given * method with the given arguments. * - * e.g.: - * str = "xyz" - * - * enum = Enumerable::Enumerator.new(str, :each_byte) - * a = enum.map {|b| '%02x' % b } #=> ["78", "79", "7a"] - * + * Use of this method is not discouraged. Use Kernel#enum_for() + * instead. */ static VALUE enumerator_initialize(int argc, VALUE *argv, VALUE obj) @@ -291,7 +290,7 @@ * enum.each {...} * * Iterates the given block using the object and the method specified - * in the first place. + * in the first place. If no block is given, returns self. * */ static VALUE @@ -321,9 +320,10 @@ /* * call-seq: * e.with_index {|(*args), idx| ... } + * e.with_index * * Iterates the given block for each elements with an index, which - * start from 0. + * start from 0. If no block is given, returns an enumerator. * */ static VALUE -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/