The javadoc for JSR 292 needs to be scrubbed, so that it conforms to the style guide.
http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#styleguide
Example:
public MutableCallSite(MethodHandle target):
--------------------------------------------
Make a blank call site object, possibly equipped with an initial target method
handle.
-->
Creates a call site object with an initial target method handle.
The present CR is a companion to this one:
7032323: implement JSR 292 EG adjustments through Public Review (March 2011)
The purpose of a pair of CRs is to distinguish final changes to executable code, versus changes to documentation. This CR deals with non-executable changes (except perhaps tests of javadoc examples).