diff -r 49c0b1bda5db -r 93b368e54c1c jdk/src/share/classes/java/util/stream/StreamSupport.java --- a/jdk/src/share/classes/java/util/stream/StreamSupport.java Thu Sep 12 13:20:26 2013 -0400 +++ b/jdk/src/share/classes/java/util/stream/StreamSupport.java Fri Sep 06 22:20:01 2013 -0700 @@ -32,12 +32,8 @@ * Low-level utility methods for creating and manipulating streams. * *

This class is mostly for library writers presenting stream views - * of their data structures; most static stream methods for end users are in - * {@link Streams}. - * - *

Unless otherwise stated, streams are created as sequential - * streams. A sequential stream can be transformed into a parallel stream by - * calling the {@code parallel()} method on the created stream. + * of data structures; most static stream methods intended for end users are in + * the various {@code Stream} classes. * * @since 1.8 */ @@ -80,7 +76,7 @@ * {@code Supplier} of {@code Spliterator}. * *

The {@link Supplier#get()} method will be invoked on the supplier no - * more than once, and after the terminal operation of the stream pipeline + * more than once, and only after the terminal operation of the stream pipeline * commences. * *

For spliterators that report a characteristic of {@code IMMUTABLE} @@ -88,7 +84,7 @@ * late-binding, it is likely * more efficient to use {@link #stream(java.util.Spliterator, boolean)} * instead. - * The use of a {@code Supplier} in this form provides a level of + *

The use of a {@code Supplier} in this form provides a level of * indirection that reduces the scope of potential interference with the * source. Since the supplier is only invoked after the terminal operation * commences, any modifications to the source up to the start of the @@ -148,7 +144,7 @@ * {@code Supplier} of {@code Spliterator.OfInt}. * *

The {@link Supplier#get()} method will be invoked on the supplier no - * more than once, and after the terminal operation of the stream pipeline + * more than once, and only after the terminal operation of the stream pipeline * commences. * *

For spliterators that report a characteristic of {@code IMMUTABLE} @@ -156,7 +152,7 @@ * late-binding, it is likely * more efficient to use {@link #intStream(java.util.Spliterator.OfInt, boolean)} * instead. - * The use of a {@code Supplier} in this form provides a level of + *

The use of a {@code Supplier} in this form provides a level of * indirection that reduces the scope of potential interference with the * source. Since the supplier is only invoked after the terminal operation * commences, any modifications to the source up to the start of the @@ -215,7 +211,7 @@ * {@code Supplier} of {@code Spliterator.OfLong}. * *

The {@link Supplier#get()} method will be invoked on the supplier no - * more than once, and after the terminal operation of the stream pipeline + * more than once, and only after the terminal operation of the stream pipeline * commences. * *

For spliterators that report a characteristic of {@code IMMUTABLE} @@ -223,7 +219,7 @@ * late-binding, it is likely * more efficient to use {@link #longStream(java.util.Spliterator.OfLong, boolean)} * instead. - * The use of a {@code Supplier} in this form provides a level of + *

The use of a {@code Supplier} in this form provides a level of * indirection that reduces the scope of potential interference with the * source. Since the supplier is only invoked after the terminal operation * commences, any modifications to the source up to the start of the @@ -282,7 +278,7 @@ * {@code Supplier} of {@code Spliterator.OfDouble}. * *

The {@link Supplier#get()} method will be invoked on the supplier no - * more than once, and after the terminal operation of the stream pipeline + * more than once, and only after the terminal operation of the stream pipeline * commences. * *

For spliterators that report a characteristic of {@code IMMUTABLE} @@ -290,7 +286,7 @@ * late-binding, it is likely * more efficient to use {@link #doubleStream(java.util.Spliterator.OfDouble, boolean)} * instead. - * The use of a {@code Supplier} in this form provides a level of + *

The use of a {@code Supplier} in this form provides a level of * indirection that reduces the scope of potential interference with the * source. Since the supplier is only invoked after the terminal operation * commences, any modifications to the source up to the start of the