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, 8 insertions, 13 deletions

diff --git a/src/library/scala/Product1.scala b/src/library/scala/Product1.scala
index 9345d77874..ab8b0a4505 100644
--- a/src/library/scala/Product1.scala
+++ b/src/library/scala/Product1.scala
@@ -5,36 +5,30 @@
 ** /____/\___/_/ |_/____/_/ | |                                         **
 **                          |/                                          **
 \*                                                                      */
-
-// generated by genprod on Sat Oct 16 11:19:09 PDT 2010
+// GENERATED CODE: DO NOT EDIT. See scala.Function0 for timestamp.
 
 package scala
 
-
-
 object Product1 {
   def unapply[T1](x: Product1[T1]): Option[Product1[T1]] =
     Some(x)
 }
 
 /** Product1 is a cartesian product of 1 component.
- *
  *  @since 2.3
  */
 trait Product1[@specialized(Int, Long, Double) +T1] extends Product {
-  /**
-   *  The arity of this product.
+  /** The arity of this product.
    *  @return 1
    */
   override def productArity = 1
 
 
-  /**
-   *  Returns the n-th projection of this product if 0 < n <= productArity,
-   *  otherwise throws IndexOutOfBoundsException.
+  /** Returns the n-th projection of this product if 0 < n <= productArity,
+   *  otherwise throws an `IndexOutOfBoundsException`.
    *
    *  @param n number of the projection to be returned
-   *  @return  same as _(n+1)
+   *  @return  same as `._(n+1)`, for example `productElement(1)` is the same as `._1`.
    *  @throws  IndexOutOfBoundsException
    */
 
@@ -44,9 +38,10 @@ trait Product1[@specialized(Int, Long, Double) +T1] extends Product {
     case _ => throw new IndexOutOfBoundsException(n.toString())
  }
 
-  /** projection of this product */
+  /** A projection of element 1 of this Product.
+   *  @return   A projection of element 1.
+   */
   def _1: T1
 
 
-
 }