RFR 8040167: JDWP spec for ClassType#InvokeMethod contradicts JLS

[David Holmes]

Jaroslav,

Even though a seemingly trivial correction this needs a CCC request.

David

On 15/04/2014 6:21 PM, Jaroslav Bachorik wrote:
> Please, review this simple doc change.
>
> Issue : https://bugs.openjdk.java.net/browse/JDK-8040167
> Webrev: http://cr.openjdk.java.net/~jbachorik/8040167/webrev.00/
>
> Currently, the generated JDWP documentation falsely states that the
> InvokeMethod command
> "Invokes a static method. The method must be member of the class type or
> one of its superclasses,
> *superinterfaces*, or implemented interfaces."
>
> Up till JDK8 this was almost non-problem since interfaces could not
> specify static methods. For JDK8 this brings in ambiguity and
> contradicts JLS.
>
> The JDI docs
> (http://docs.oracle.com/javase/8/docs/jdk/api/jpda/jdi/com/sun/jdi/ClassType.html#invokeMethod-com.sun.jdi.ThreadReference-com.sun.jdi.Method-java.util.List-int-)
> state correctly that the InvokeMethod can be uses only on static methods
> from the class or its superclasses (no mention of interface) - following
> the JLS
> (http://docs.oracle.com/javase/specs/jls/se8/html/jls-8.html#jls-8.4.8)
> rules.
>
> The fix is to change the line to read
> "Invokes a static method. The method must be member of the class type or
> one of its superclasses." instead.
>
> Thanks,
>
> -JB-