A DESCRIPTION OF THE REQUEST :
Please update the documentation of AtomicXXX.lazySet(). Currently it reads:
"Eventually sets to the given value." which doesn't really explain when it should be used versus set().
You can find a more detailed explanation of lazySet() here: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6275329
Please simplify the explanation and update the Javadoc so it's clear how this method compares to set(), and when it is appropriate to use it.
It's unclear when it's appropriate to use the method.