zzak	2012-09-14 03:32:07 +0900 (Fri, 14 Sep 2012)

  New Revision: 36964

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=36964

  Log:
    * array.c (rb_ary_select):
      Update documentation for Array#select
    * enum.c (enum_find_all, enum_reject):
      Update documentation for Enumerable#find_all and Enumerable#reject
      Based on a patch by Jeff Saracco
      [Bug #6908] [ruby-core:47285] [Fixes #166 on github]

  Modified files:
    trunk/ChangeLog
    trunk/array.c
    trunk/enum.c

Index: array.c
===================================================================
--- array.c	(revision 36963)
+++ array.c	(revision 36964)
@@ -2408,16 +2408,17 @@
  *     ary.select { |item| block } -> new_ary
  *     ary.select                  -> Enumerator
  *
- *  Invokes the given block passing in successive elements from +self+,
- *  returning an array containing those elements for which the block returns
- *  a +true+ value.
+ *  Returns a new array containing all elements of +ary+
+ *  for which the given +block+ returns a true value.
  *
- *  See also Enumerable#select.
- *
  *  If no block is given, an Enumerator is returned instead.
  *
+ *     [1,2,3,4,5].select { |num|  num.even?  }   #=> [2, 4]
+ *
  *     a = %w{ a b c d e f }
  *     a.select { |v| v =~ /[aeiou]/ }  #=> ["a", "e"]
+ *
+ *  See also Enumerable#select.
  */
 
 static VALUE
Index: ChangeLog
===================================================================
--- ChangeLog	(revision 36963)
+++ ChangeLog	(revision 36964)
@@ -1,3 +1,12 @@
+Fri Sep 14 03:30:00 2012  Zachary Scott  <zzak@r...>
+
+	* array.c (rb_ary_select):
+	  Update documentation for Array#select
+	* enum.c (enum_find_all, enum_reject):
+	  Update documentation for Enumerable#find_all and Enumerable#reject
+	  Based on a patch by Jeff Saracco
+	  [Bug #6908] [ruby-core:47285] [Fixes #166 on github]
+
 Fri Sep 14 00:20:00 2012  Zachary Scott  <zzak@r...>
 
 	* signal.c (rb_f_kill):
Index: enum.c
===================================================================
--- enum.c	(revision 36963)
+++ enum.c	(revision 36964)
@@ -311,15 +311,17 @@
  *     enum.find_all                 -> an_enumerator
  *     enum.select                   -> an_enumerator
  *
- *  Returns an array containing all elements of <i>enum</i> for which
- *  <em>block</em> is not <code>false</code> (see also
- *  <code>Enumerable#reject</code>).
+ *  Returns an array containing all elements of +enum+
+ *  for which the given +block+ returns a true value.
  *
- *  If no block is given, an enumerator is returned instead.
+ *  If no block is given, an Enumerator is returned instead.
  *
  *
  *     (1..10).find_all { |i|  i % 3 == 0 }   #=> [3, 6, 9]
  *
+ *     [1,2,3,4,5].select { |num|  num.even?  }   #=> [2, 4]
+ *
+ *  See also Enumerable#reject.
  */
 
 static VALUE
@@ -351,13 +353,16 @@
  *     enum.reject { |obj| block } -> array
  *     enum.reject                 -> an_enumerator
  *
- *  Returns an array for all elements of <i>enum</i> for which
- *  <em>block</em> is false (see also <code>Enumerable#find_all</code>).
+ *  Returns an array for all elements of +enum+ for which the given
+ *  +block+ returns false.
  *
- *  If no block is given, an enumerator is returned instead.
+ *  If no block is given, an Enumerator is returned instead.
  *
  *     (1..10).reject { |i|  i % 3 == 0 }   #=> [1, 2, 4, 5, 7, 8, 10]
  *
+ *     [1, 2, 3, 4, 5].reject { |num| num.even? } #=> [1, 3, 5]
+ *
+ *  See also Enumerable#find_all.
  */
 
 static VALUE

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/