naruse	2017-03-13 01:23:09 +0900 (Mon, 13 Mar 2017)

  New Revision: 57923

  https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=revision&revision=57923

  Log:
    merge revision(s) 57765: [Backport #13273]
    
    proc.c: documentation for Proc#{call,yield,[]}
    
    * proc.c: [DOC] fix and improve docs for Proc#{call,yield,[]}:
    
      * change order of Document-method directives as workaround for an
        RDoc rendering problem where the documentation for Proc#call displays
        a "Document-method: []" code block.  [ruby-core:79887] [Bug #13273]
      * add missing call-seq and example for Proc#yield
      * remove pointless cross reference to Proc#yield
      * update description for handling of extra or missing arguments,
        improve examples and add cross reference to #lambda?

  Modified directories:
    branches/ruby_2_4/
  Modified files:
    branches/ruby_2_4/proc.c
    branches/ruby_2_4/version.h
Index: ruby_2_4/version.h
===================================================================
--- ruby_2_4/version.h	(revision 57922)
+++ ruby_2_4/version.h	(revision 57923)
@@ -1,6 +1,6 @@ https://github.com/ruby/ruby/blob/trunk/ruby_2_4/version.h#L1
 #define RUBY_VERSION "2.4.0"
 #define RUBY_RELEASE_DATE "2017-03-13"
-#define RUBY_PATCHLEVEL 78
+#define RUBY_PATCHLEVEL 79
 
 #define RUBY_RELEASE_YEAR 2017
 #define RUBY_RELEASE_MONTH 3
Index: ruby_2_4/proc.c
===================================================================
--- ruby_2_4/proc.c	(revision 57922)
+++ ruby_2_4/proc.c	(revision 57923)
@@ -777,45 +777,42 @@ rb_block_lambda(void) https://github.com/ruby/ruby/blob/trunk/ruby_2_4/proc.c#L777
 /* CHECKME: are the argument checking semantics correct? */
 
 /*
- *  Document-method: call
  *  Document-method: []
+ *  Document-method: call
  *  Document-method: yield
  *
  *  call-seq:
  *     prc.call(params,...)   -> obj
  *     prc[params,...]        -> obj
  *     prc.(params,...)       -> obj
+ *     prc.yield(params,...)  -> obj
  *
  *  Invokes the block, setting the block's parameters to the values in
  *  <i>params</i> using something close to method calling semantics.
- *  Generates a warning if multiple values are passed to a proc that
- *  expects just one (previously this silently converted the parameters
- *  to an array).  Note that <code>prc.()</code> invokes
- *  <code>prc.call()</code> with the parameters given.  It's a syntax sugar to
- *  hide "call".
- *
- *  Returns the value of the last expression evaluated in the block. See
- *  also Proc#yield.
- *
- *     a_proc = Proc.new { |scalar, *values| values.collect { |value| value*scalar } }
- *     a_proc.call(9, 1, 2, 3)   #=> [9, 18, 27]
- *     a_proc[9, 1, 2, 3]        #=> [9, 18, 27]
- *     a_proc.(9, 1, 2, 3)       #=> [9, 18, 27]
+ *  Returns the value of the last expression evaluated in the block.
+ *
+ *     a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } }
+ *     a_proc.call(9, 1, 2, 3)    #=> [9, 18, 27]
+ *     a_proc[9, 1, 2, 3]         #=> [9, 18, 27]
+ *     a_proc.(9, 1, 2, 3)        #=> [9, 18, 27]
+ *     a_proc.yield(9, 1, 2, 3)   #=> [9, 18, 27]
+ *
+ *  Note that <code>prc.()</code> invokes <code>prc.call()</code> with
+ *  the parameters given.  It's syntactic sugar to hide "call".
  *
  *  For procs created using <code>lambda</code> or <code>->()</code> an error
- *  is generated if the wrong number of parameters are passed to a Proc with
- *  multiple parameters.  For procs created using <code>Proc.new</code> or
- *  <code>Kernel.proc</code>, extra parameters are silently discarded.
- *
- *     a_proc = lambda {|a,b| a}
- *     a_proc.call(1,2,3)
- *
- *  <em>produces:</em>
- *
- *     prog.rb:4:in `block in <main>': wrong number of arguments (given 3, expected 2) (ArgumentError)
- *     	from prog.rb:5:in `call'
- *     	from prog.rb:5:in `<main>'
+ *  is generated if the wrong number of parameters are passed to the proc.
+ *  For procs created using <code>Proc.new</code> or <code>Kernel.proc</code>,
+ *  extra parameters are silently discarded and missing parameters are
+ *  set to +nil+.
+ *
+ *     a_proc = proc {|a,b| [a,b] }
+ *     a_proc.call(1)   #=> [1, nil]
+ *
+ *     a_proc = lambda {|a,b| [a,b] }
+ *     a_proc.call(1)   # ArgumentError: wrong number of arguments (given 1, expected 2)
  *
+ *  See also Proc#lambda?.
  */
 #if 0
 static VALUE

Property changes on: ruby_2_4
___________________________________________________________________
Modified: svn:mergeinfo
   Merged /trunk:r57765


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