OK.  Given what this method exists for, I can agree with leaving the note in place since its just echoed from the system Javadoc.

I do love the differences in summary though, the Javadoc starts out saying its atomic, but then later implies it might not actually be atomic since it cannot be made to work reliably.  Cute.  :-)