Adapted usecases to full signature display

1 files changed, 33 insertions, 20 deletions

diff --git a/src/library/scala/collection/GenTraversableOnce.scala b/src/library/scala/collection/GenTraversableOnce.scala
index 67ea4cdb00..f18e2ab6bb 100644
--- a/src/library/scala/collection/GenTraversableOnce.scala
+++ b/src/library/scala/collection/GenTraversableOnce.scala
@@ -316,11 +316,12 @@ trait GenTraversableOnce[+A] extends Any {
    *   @return       the sum of all elements of this $coll with respect to the `+` operator in `num`.
    *
    *   @usecase def sum: A
+   *     @inheritdoc
    *
-   *   @return       the sum of all elements in this $coll of numbers of type `Int`.
-   *   Instead of `Int`, any other type `T` with an implicit `Numeric[T]` implementation
-   *   can be used as element type of the $coll and as result type of `sum`.
-   *   Examples of such types are: `Long`, `Float`, `Double`, `BigInt`.
+   *     @return       the sum of all elements in this $coll of numbers of type `Int`.
+   *     Instead of `Int`, any other type `T` with an implicit `Numeric[T]` implementation
+   *     can be used as element type of the $coll and as result type of `sum`.
+   *     Examples of such types are: `Long`, `Float`, `Double`, `BigInt`.
    *
    */
   def sum[A1 >: A](implicit num: Numeric[A1]): A1
@@ -333,11 +334,12 @@ trait GenTraversableOnce[+A] extends Any {
    *   @return       the product of all elements of this $coll with respect to the `*` operator in `num`.
    *
    *   @usecase def product: A
+   *     @inheritdoc
    *
-   *   @return       the product of all elements in this $coll of numbers of type `Int`.
-   *   Instead of `Int`, any other type `T` with an implicit `Numeric[T]` implementation
-   *   can be used as element type of the $coll and as result type of `product`.
-   *   Examples of such types are: `Long`, `Float`, `Double`, `BigInt`.
+   *     @return       the product of all elements in this $coll of numbers of type `Int`.
+   *     Instead of `Int`, any other type `T` with an implicit `Numeric[T]` implementation
+   *     can be used as element type of the $coll and as result type of `product`.
+   *     Examples of such types are: `Long`, `Float`, `Double`, `BigInt`.
    */
   def product[A1 >: A](implicit num: Numeric[A1]): A1
 
@@ -348,7 +350,9 @@ trait GenTraversableOnce[+A] extends Any {
    *  @return   the smallest element of this $coll with respect to the ordering `cmp`.
    *
    *  @usecase def min: A
-   *  @return   the smallest element of this $coll
+   *    @inheritdoc
+   *
+   *    @return   the smallest element of this $coll
    */
   def min[A1 >: A](implicit ord: Ordering[A1]): A
 
@@ -359,7 +363,9 @@ trait GenTraversableOnce[+A] extends Any {
    *  @return   the largest element of this $coll with respect to the ordering `cmp`.
    *
    *  @usecase def max: A
-   *  @return   the largest element of this $coll.
+   *    @inheritdoc
+   *
+   *    @return   the largest element of this $coll.
    */
   def max[A1 >: A](implicit ord: Ordering[A1]): A
 
@@ -387,12 +393,13 @@ trait GenTraversableOnce[+A] extends Any {
    *  Copying will stop once either the end of the current $coll is reached,
    *  or the end of the array is reached.
    *
-   *  $willNotTerminateInf
-   *
    *  @param  xs     the array to fill.
    *  @tparam B      the type of the elements of the array.
    *
    *  @usecase def copyToArray(xs: Array[A]): Unit
+   *    @inheritdoc
+   *
+   *    $willNotTerminateInf
    */
   def copyToArray[B >: A](xs: Array[B]): Unit
 
@@ -401,13 +408,14 @@ trait GenTraversableOnce[+A] extends Any {
    *  Copying will stop once either the end of the current $coll is reached,
    *  or the end of the array is reached.
    *
-   *  $willNotTerminateInf
-   *
    *  @param  xs     the array to fill.
    *  @param  start  the starting index.
    *  @tparam B      the type of the elements of the array.
    *
    *  @usecase def copyToArray(xs: Array[A], start: Int): Unit
+   *    @inheritdoc
+   *
+   *    $willNotTerminateInf
    */
   def copyToArray[B >: A](xs: Array[B], start: Int): Unit
 
@@ -450,15 +458,18 @@ trait GenTraversableOnce[+A] extends Any {
   def mkString: String
 
   /** Converts this $coll to an array.
-   *  $willNotTerminateInf
    *
    *  @tparam B the type of the elements of the array. A `ClassManifest` for
    *            this type must be available.
    *  @return   an array containing all elements of this $coll.
    *
    *  @usecase def toArray: Array[A]
-   *  @return  an array containing all elements of this $coll.
-   *           A `ClassManifest` must be available for the element type of this $coll.
+   *    @inheritdoc
+   *
+   *    $willNotTerminateInf
+   *
+   *    @return  an array containing all elements of this $coll.
+   *             A `ClassManifest` must be available for the element type of this $coll.
    */
   def toArray[A1 >: A: ClassManifest]: Array[A1]
 
@@ -530,11 +541,13 @@ trait GenTraversableOnce[+A] extends Any {
    *  pair in the map.  Duplicate keys will be overwritten by later keys:
    *  if this is an unordered collection, which key is in the resulting map
    *  is undefined.
-   *  $willNotTerminateInf
    *  @return    a map containing all elements of this $coll.
+   *
    *  @usecase   def toMap[T, U]: Map[T, U]
-   *  @return    a map of type `immutable.Map[T, U]`
-   *             containing all key/value pairs of type `(T, U)` of this $coll.
+   *    @inheritdoc
+   *    $willNotTerminateInf
+   *    @return    a map of type `immutable.Map[T, U]`
+   *               containing all key/value pairs of type `(T, U)` of this $coll.
    */
   def toMap[K, V](implicit ev: A <:< (K, V)): GenMap[K, V]
 }