The javadoc comments say there is to be a bit of sample code, but the sample
code is missing in action. In the source file it reads <pre></pre>.

Also the section beginning "Calling this method is equivalent .." is
badly formatted.