Part of the documentation for lazySet is in the atomic package documentation where memory synchronization affects are described:
- lazySet has the memory effects of writing (assigning) a volatile variable except that it permits reorderings with subsequent (but not previous) memory actions that do not themselves impose reordering constraints with ordinary non-volatile writes. Among other usage contexts, lazySet may apply when nulling out, for the sake of garbage collection, a reference that is never accessed again.
This is essentially the documentation that arose from the description in 6275329.
It seems to me that what may be missing here is a link from the laztSet method docs back to the relevant section of the package docs. Though there is a presumption on the part of the JSR-166 expert group that anyone attempting to use tha atomics package has familiarised themselves with the information provided in the package docs, as this is where all the core, common semantics are described.