src/java.base/share/classes/java/util/concurrent/Phaser.java

8260664: Phaser.arrive() memory consistency effects
Reviewed-by: martin

@@ -146,10 +146,16 @@
  * methods may reflect transient states and so are not in general
  * useful for synchronization control.  Method {@link #toString}
  * returns snapshots of these state queries in a form convenient for
  * informal monitoring.
  *
+ * <p>Memory consistency effects: Actions prior to any form of arrive
+ * method <a href="package-summary.html#MemoryVisibility">
+ * <i>happen-before</i></a> a corresponding phase advance and
+ * onAdvance actions (if present), which in turn <i>happen-before</i>
+ * actions following the phase advance.
+ *
  * <p><b>Sample usages:</b>
  *
  * <p>A {@code Phaser} may be used instead of a {@code CountDownLatch}
  * to control a one-shot action serving a variable number of parties.
  * The typical idiom is for the method setting this up to first