United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-7128512 Javadoc typo in java.lang.invoke.MethodHandle
JDK-7128512 : Javadoc typo in java.lang.invoke.MethodHandle

Details
Type:
Bug
Submit Date:
2012-01-10
Status:
Closed
Updated Date:
2013-09-04
Project Name:
JDK
Resolved Date:
2012-01-25
Component:
core-libs
OS:
generic
Sub-Component:
java.lang.invoke
CPU:
generic
Priority:
P5
Resolution:
Fixed
Affected Versions:
8
Fixed Versions:

Related Reports
Backport:
Backport:
Backport:
Relates:

Sub Tasks

Description
There is a javadoc problem in java.lang.invoke.MethodHandle which stems from the arguments to the {@link} javadoc tag being reversed in the class's description.

For discussion see
http://mail.openjdk.java.net/pipermail/core-libs-dev/2012-January/008870.html

                                    

Comments
SUGGESTED FIX

diff -r 858038d89fd5 src/share/classes/java/lang/invoke/MethodHandle.java
--- a/src/share/classes/java/lang/invoke/MethodHandle.java    Mon Jan 09 15:54:44 2012 -0800
+++ b/src/share/classes/java/lang/invoke/MethodHandle.java    Mon Jan 09 18:14:23 2012 -0800
@@ -275,7 +275,7 @@
  * generates a single invokevirtual instruction with
  * the symbolic type descriptor indicated in the following comment.
  * In these examples, the helper method {@code assertEquals} is assumed to
- * be a method which calls {@link Objects.equals java.util.Objects#equals}
+ * be a method which calls {@link java.util.Objects#equals(Object,Object) Objects.equals }
  * on its arguments, and asserts that the result is true.
  *
  * <h3>Exceptions</h3>
                                     
2012-01-10
EVALUATION

A fine idea.
                                     
2012-01-10
PUBLIC COMMENTS

See
http://hg.openjdk.java.net/jdk8/tl/jdk/rev/dd69d3695cee
                                     
2012-01-10



Hardware and Software, Engineered to Work Together