8211877: Broken links in java.util.concurrent.atomic

Reviewed-by: martin, jjg

src/java.base/share/classes/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.java

@@ -121,9 +121,9 @@ public abstract class AtomicIntegerFieldUpdater<T> {
      * other calls to {@code compareAndSet} and {@code set}, but not
      * necessarily with respect to other changes in the field.
      *
-     * <p><a href="package-summary.html#weakCompareAndSet">May fail
+     * <p>This operation may fail spuriously and does not provide
-     * spuriously and does not provide ordering guarantees</a>, so is
+     * ordering guarantees, so is only rarely an appropriate
-     * only rarely an appropriate alternative to {@code compareAndSet}.
+     * alternative to {@code compareAndSet}.
      *
      * @param obj An object whose field to conditionally set
      * @param expect the expected value

src/java.base/share/classes/java/util/concurrent/atomic/AtomicLongFieldUpdater.java

@@ -124,9 +124,9 @@ public abstract class AtomicLongFieldUpdater<T> {
      * other calls to {@code compareAndSet} and {@code set}, but not
      * necessarily with respect to other changes in the field.
      *
-     * <p><a href="package-summary.html#weakCompareAndSet">May fail
+     * <p>This operation may fail spuriously and does not provide
-     * spuriously and does not provide ordering guarantees</a>, so is
+     * ordering guarantees, so is only rarely an appropriate
-     * only rarely an appropriate alternative to {@code compareAndSet}.
+     * alternative to {@code compareAndSet}.
      *
      * @param obj An object whose field to conditionally set
      * @param expect the expected value

src/java.base/share/classes/java/util/concurrent/atomic/AtomicMarkableReference.java

@@ -110,14 +110,12 @@ public class AtomicMarkableReference<V> {
     }
 
     /**
-     * Atomically sets the value of both the reference and mark
+     * Atomically sets the value of both the reference and mark to the
-     * to the given update values if the
+     * given update values if the current reference is {@code ==} to
-     * current reference is {@code ==} to the expected reference
+     * the expected reference and the current mark is equal to the
-     * and the current mark is equal to the expected mark.
+     * expected mark. This operation may fail spuriously and does not
-     *
+     * provide ordering guarantees, so is only rarely an
-     * <p><a href="package-summary.html#weakCompareAndSet">May fail
+     * appropriate alternative to {@code compareAndSet}.
-     * spuriously and does not provide ordering guarantees</a>, 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

src/java.base/share/classes/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java

@@ -143,9 +143,9 @@ public abstract class AtomicReferenceFieldUpdater<T,V> {
      * other calls to {@code compareAndSet} and {@code set}, but not
      * necessarily with respect to other changes in the field.
      *
-     * <p><a href="package-summary.html#weakCompareAndSet">May fail
+     * <p>This operation may fail spuriously and does not provide
-     * spuriously and does not provide ordering guarantees</a>, so is
+     * ordering guarantees, so is only rarely an appropriate
-     * only rarely an appropriate alternative to {@code compareAndSet}.
+     * alternative to {@code compareAndSet}.
      *
      * @param obj An object whose field to conditionally set
      * @param expect the expected value

src/java.base/share/classes/java/util/concurrent/atomic/AtomicStampedReference.java

@@ -110,14 +110,12 @@ public class AtomicStampedReference<V> {
     }
 
     /**
-     * Atomically sets the value of both the reference and stamp
+     * Atomically sets the value of both the reference and stamp to
-     * to the given update values if the
+     * the given update values if the current reference is {@code ==}
-     * current reference is {@code ==} to the expected reference
+     * to the expected reference and the current stamp is equal to the
-     * and the current stamp is equal to the expected stamp.
+     * expected stamp. This operation may fail spuriously and does not
-     *
+     * provide ordering guarantees, so is only rarely an
-     * <p><a href="package-summary.html#weakCompareAndSet">May fail
+     * appropriate alternative to {@code compareAndSet}.
-     * spuriously and does not provide ordering guarantees</a>, 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

src/java.base/share/classes/java/util/concurrent/atomic/DoubleAccumulator.java

@@ -280,7 +280,7 @@ public class DoubleAccumulator extends Striped64 implements Serializable {
 
     /**
      * Returns a
-     * <a href="../../../../serialized-form.html#java.util.concurrent.atomic.DoubleAccumulator.SerializationProxy">
+     * <a href="{@docRoot}/serialized-form.html#java.util.concurrent.atomic.DoubleAccumulator.SerializationProxy">
      * SerializationProxy</a>
      * representing the state of this instance.
      *

src/java.base/share/classes/java/util/concurrent/atomic/DoubleAdder.java

@@ -239,7 +239,7 @@ public class DoubleAdder extends Striped64 implements Serializable {
 
     /**
      * Returns a
-     * <a href="../../../../serialized-form.html#java.util.concurrent.atomic.DoubleAdder.SerializationProxy">
+     * <a href="{@docRoot}/serialized-form.html#java.util.concurrent.atomic.DoubleAdder.SerializationProxy">
      * SerializationProxy</a>
      * representing the state of this instance.
      *

src/java.base/share/classes/java/util/concurrent/atomic/LongAccumulator.java

@@ -271,7 +271,7 @@ public class LongAccumulator extends Striped64 implements Serializable {
 
     /**
      * Returns a
-     * <a href="../../../../serialized-form.html#java.util.concurrent.atomic.LongAccumulator.SerializationProxy">
+     * <a href="{@docRoot}/serialized-form.html#java.util.concurrent.atomic.LongAccumulator.SerializationProxy">
      * SerializationProxy</a>
      * representing the state of this instance.
      *

src/java.base/share/classes/java/util/concurrent/atomic/LongAdder.java

@@ -241,7 +241,7 @@ public class LongAdder extends Striped64 implements Serializable {
 
     /**
      * Returns a
-     * <a href="../../../../serialized-form.html#java.util.concurrent.atomic.LongAdder.SerializationProxy">
+     * <a href="{@docRoot}/serialized-form.html#java.util.concurrent.atomic.LongAdder.SerializationProxy">
      * SerializationProxy</a>
      * representing the state of this instance.
      *