May fail - * spuriously and does not provide ordering guarantees, so is - * only rarely an appropriate alternative to {@code compareAndSet}. + *
This operation may fail spuriously and does not provide + * ordering guarantees, so is only rarely an appropriate + * alternative to {@code compareAndSet}. * * @param obj An object whose field to conditionally set * @param expect the expected value diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/AtomicLongFieldUpdater.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/AtomicLongFieldUpdater.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/AtomicLongFieldUpdater.java Wed Nov 28 15:25:14 2018 -0800 @@ -124,9 +124,9 @@ * other calls to {@code compareAndSet} and {@code set}, but not * necessarily with respect to other changes in the field. * - *
May fail - * spuriously and does not provide ordering guarantees, so is - * only rarely an appropriate alternative to {@code compareAndSet}. + *
This operation may fail spuriously and does not provide + * ordering guarantees, so is only rarely an appropriate + * alternative to {@code compareAndSet}. * * @param obj An object whose field to conditionally set * @param expect the expected value diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/AtomicMarkableReference.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/AtomicMarkableReference.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/AtomicMarkableReference.java Wed Nov 28 15:25:14 2018 -0800 @@ -110,14 +110,12 @@ } /** - * Atomically sets the value of both the reference and mark - * to the given update values if the - * current reference is {@code ==} to the expected reference - * and the current mark is equal to the expected mark. - * - *
May fail - * spuriously and does not provide ordering guarantees, so is - * only rarely an appropriate alternative to {@code compareAndSet}. + * Atomically sets the value of both the reference and mark to the + * given update values if the current reference is {@code ==} to + * the expected reference and the current mark is equal to the + * expected mark. This operation may fail spuriously and does not + * provide ordering guarantees, so is only rarely an + * appropriate alternative to {@code compareAndSet}. * * @param expectedReference the expected value of the reference * @param newReference the new value for the reference diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java Wed Nov 28 15:25:14 2018 -0800 @@ -143,9 +143,9 @@ * other calls to {@code compareAndSet} and {@code set}, but not * necessarily with respect to other changes in the field. * - *
May fail - * spuriously and does not provide ordering guarantees, so is - * only rarely an appropriate alternative to {@code compareAndSet}. + *
This operation may fail spuriously and does not provide + * ordering guarantees, so is only rarely an appropriate + * alternative to {@code compareAndSet}. * * @param obj An object whose field to conditionally set * @param expect the expected value diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/AtomicStampedReference.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/AtomicStampedReference.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/AtomicStampedReference.java Wed Nov 28 15:25:14 2018 -0800 @@ -110,14 +110,12 @@ } /** - * Atomically sets the value of both the reference and stamp - * to the given update values if the - * current reference is {@code ==} to the expected reference - * and the current stamp is equal to the expected stamp. - * - *
May fail - * spuriously and does not provide ordering guarantees, so is - * only rarely an appropriate alternative to {@code compareAndSet}. + * Atomically sets the value of both the reference and stamp to + * the given update values if the current reference is {@code ==} + * to the expected reference and the current stamp is equal to the + * expected stamp. This operation may fail spuriously and does not + * provide ordering guarantees, so is only rarely an + * appropriate alternative to {@code compareAndSet}. * * @param expectedReference the expected value of the reference * @param newReference the new value for the reference diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/DoubleAccumulator.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/DoubleAccumulator.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/DoubleAccumulator.java Wed Nov 28 15:25:14 2018 -0800 @@ -280,7 +280,7 @@ /** * Returns a - * + * * SerializationProxy * representing the state of this instance. * diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/DoubleAdder.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/DoubleAdder.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/DoubleAdder.java Wed Nov 28 15:25:14 2018 -0800 @@ -239,7 +239,7 @@ /** * Returns a - * + * * SerializationProxy * representing the state of this instance. * diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/LongAccumulator.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/LongAccumulator.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/LongAccumulator.java Wed Nov 28 15:25:14 2018 -0800 @@ -271,7 +271,7 @@ /** * Returns a - * + * * SerializationProxy * representing the state of this instance. * diff -r 5e2625783d58 -r 0775f246731b src/java.base/share/classes/java/util/concurrent/atomic/LongAdder.java --- a/src/java.base/share/classes/java/util/concurrent/atomic/LongAdder.java Wed Nov 28 15:25:14 2018 -0800 +++ b/src/java.base/share/classes/java/util/concurrent/atomic/LongAdder.java Wed Nov 28 15:25:14 2018 -0800 @@ -241,7 +241,7 @@ /** * Returns a - * + * * SerializationProxy * representing the state of this instance. *