Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8026183

minor documentation problems in java.lang.invoke

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 8
    • 8
    • core-libs

      There is at least one mechanical or editorial problem in java.lang.invoke javadoc which should be fixed.

      Around line 657 of j.l.i.MethodHandle there is malformed javadoc:
         /**
          * Performs a variable arity invocation, passing the arguments in the given array
          * to the method handle, as if via an inexact {@link #invoke invoke} from a call site
          * which mentions only the type {@code Object}, and whose arity is the length
          * of the argument array.
          * <p>
          * This method is also equivalent to the following code:
          * <p><blockquote><pre>
          * {@link #invokeWithArguments(Object...) invokeWithArguments}{@code(arguments.toArray())}
          * </pre></blockquote>
          *
          * @param arguments the arguments to pass to the target
          * @return the result returned by the target
          * @throws NullPointerException if {@code arguments} is a null reference
          * @throws ClassCastException if an argument cannot be converted by reference casting
          * @throws WrongMethodTypeException if the target's type cannot be adjusted to take the given number of {@code Object} arguments
          * @throws Throwable anything thrown by the target method invocation
          */
         public Object invokeWithArguments(java.util.List<?> arguments) throws Throwable {
             return invokeWithArguments(arguments.toArray());
         }

      The javadoc should not include javadoc tags to be interpretted inside <pre></pre>.

            rriggs Roger Riggs
            jrose John Rose
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: