--- jsr166/src/jsr166e/ConcurrentHashMapV8.java 2012/12/14 16:33:42 1.83 +++ jsr166/src/jsr166e/ConcurrentHashMapV8.java 2012/12/15 20:21:25 1.84 @@ -100,23 +100,23 @@ import java.io.Serializable; *

Like {@link Hashtable} but unlike {@link HashMap}, this class * does not allow {@code null} to be used as a key or value. * - *

ConcurrentHashMapV8s support parallel operations using the {@link - * ForkJoinPool#commonPool}. (Tasks that may be used in other contexts - * are available in class {@link ForkJoinTasks}). These operations are - * designed to be safely, and often sensibly, applied even with maps - * that are being concurrently updated by other threads; for example, - * when computing a snapshot summary of the values in a shared - * registry. There are three kinds of operation, each with four - * forms, accepting functions with Keys, Values, Entries, and (Key, - * Value) arguments and/or return values. (The first three forms are - * also available via the {@link #keySet()}, {@link #values()} and - * {@link #entrySet()} views). Because the elements of a - * ConcurrentHashMapV8 are not ordered in any particular way, and may be - * processed in different orders in different parallel executions, the - * correctness of supplied functions should not depend on any - * ordering, or on any other objects or values that may transiently - * change while computation is in progress; and except for forEach - * actions, should ideally be side-effect-free. + *

ConcurrentHashMapV8s support sequential and parallel operations + * bulk operations. (Parallel forms use the {@link + * ForkJoinPool#commonPool()}). Tasks that may be used in other + * contexts are available in class {@link ForkJoinTasks}. These + * operations are designed to be safely, and often sensibly, applied + * even with maps that are being concurrently updated by other + * threads; for example, when computing a snapshot summary of the + * values in a shared registry. There are three kinds of operation, + * each with four forms, accepting functions with Keys, Values, + * Entries, and (Key, Value) arguments and/or return values. Because + * the elements of a ConcurrentHashMapV8 are not ordered in any + * particular way, and may be processed in different orders in + * different parallel executions, the correctness of supplied + * functions should not depend on any ordering, or on any other + * objects or values that may transiently change while computation is + * in progress; and except for forEach actions, should ideally be + * side-effect-free. * *