src/java.base/share/classes/java/util/concurrent/package-info.java

8225490: Miscellaneous changes imported from jsr166 CVS 2019-09
Reviewed-by: martin, alanb

*** 224,236 ****
   * reflect any modifications subsequent to construction.
   * </ul>
   *
   * <h2 id="MemoryVisibility">Memory Consistency Properties</h2>
   *
-  * <a href="https://docs.oracle.com/javase/specs/jls/se11/html/jls-17.html#jls-17.4.5">
   * Chapter 17 of
!  * <cite>The Java&trade; Language Specification</cite></a> defines the
   * <i>happens-before</i> relation on memory operations such as reads and
   * writes of shared variables.  The results of a write by one thread are
   * guaranteed to be visible to a read by another thread only if the write
   * operation <i>happens-before</i> the read operation.  The
   * {@code synchronized} and {@code volatile} constructs, as well as the
--- 224,235 ----
   * reflect any modifications subsequent to construction.
   * </ul>
   *
   * <h2 id="MemoryVisibility">Memory Consistency Properties</h2>
   *
   * Chapter 17 of
!  * <cite>The Java&trade; Language Specification</cite> defines the
   * <i>happens-before</i> relation on memory operations such as reads and
   * writes of shared variables.  The results of a write by one thread are
   * guaranteed to be visible to a read by another thread only if the write
   * operation <i>happens-before</i> the read operation.  The
   * {@code synchronized} and {@code volatile} constructs, as well as the
*** 300,307 ****
--- 299,308 ----
   *   subsequent to a successful return from the corresponding {@code await}
   *   in other threads.
   *
   * </ul>
   *
+  * @jls 17.4.5 Happens-before Order
+  *
   * @since 1.5
   */
  package java.util.concurrent;