A DESCRIPTION OF THE REQUEST :
Please update the documentation of AtomicXXX.lazySet(). Currently it reads:
http://download.oracle.com/javase/6/docs/api/java/util/concurrent/atomic/AtomicReference.html#lazySet(V)
"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.

JUSTIFICATION :
It's unclear when it's appropriate to use the method.