Moved unlift to the Function companion object, ...

Moved unlift to the Function companion object, which might have been
better in the first place. Had to make a minor change to genprod, and
then I couldn't escape that unscathed. Finished the not very complete
undertaking I found there to update the scaladoc. Lots of little changes
to the generated text and code.

I changed genprod to only put a unique stamp on Function0 so we can stop
having a 100 file diff everytime an i is dotted somewhere.

Closes #3825, no review.

1 files changed, 14 insertions, 10 deletions

diff --git a/src/library/scala/Function3.scala b/src/library/scala/Function3.scala
index f226e2858f..f67ed3cc66 100644
--- a/src/library/scala/Function3.scala
+++ b/src/library/scala/Function3.scala
@@ -5,22 +5,23 @@
 ** /____/\___/_/ |_/____/_/ | |                                         **
 **                          |/                                          **
 \*                                                                      */
-
-// generated by genprod on Sat Oct 16 11:19:09 PDT 2010  (with extra methods)
+// GENERATED CODE: DO NOT EDIT. See scala.Function0 for timestamp.
 
 package scala
 
 
-
-
-/** Function with 3 parameters.
+/** A function of 3 parameters.
  *
  */
 trait Function3[-T1, -T2, -T3, +R] extends AnyRef { self =>
-  def apply(v1:T1,v2:T2,v3:T3): R
-  override def toString() = "<function3>"
+  /** Apply the body of this function to the arguments.
+   *  @return   the result of function application.
+   */
+  def apply(v1: T1, v2: T2, v3: T3): R
 
-  /** f(x1, x2, x3)  == (f.curried)(x1)(x2)(x3)
+  /** Creates a curried version of this function.
+   *
+   *  @return   a function `f` such that `f(x1)(x2)(x3) == apply(x1, x2, x3)`
    */
   def curried: T1 => T2 => T3 => R = {
     (x1: T1) => (x2: T2) => (x3: T3) => apply(x1, x2, x3)
@@ -28,10 +29,13 @@ trait Function3[-T1, -T2, -T3, +R] extends AnyRef { self =>
   @deprecated("Use 'curried' instead")
   def curry = curried
 
-  /* f(x1, x2, x3) == (f.tupled)(Tuple3(x1, x2, x3))
+  /** Creates a tupled version of this function: instead of 3 arguments,
+   *  it accepts a single [[scala.Tuple3]] argument.
+   *
+   *  @return   a function `f` such that `f((x1, x2, x3)) == f(Tuple3(x1, x2, x3)) == apply(x1, x2, x3)`
    */
   def tupled: Tuple3[T1, T2, T3] => R = {
     case Tuple3(x1, x2, x3) => apply(x1, x2, x3)
   }
-
+  override def toString() = "<function3>"
 }