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

javadoc generation fails if javadoc contains @see with generics

XMLWordPrintable

      ADDITIONAL SYSTEM INFORMATION :
      macOS 12.5, Java 11.0.16

      A DESCRIPTION OF THE PROBLEM :
      Javadoc generation fails, if the javadocs contain @see pointing to a method with generics.

      REGRESSION : Last worked in version 17.0.4

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      Build the attached source code with javadoc 11.0.16

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      The javadoc generation is successful.
      ACTUAL -
      The javadoc generation fails with the following error:

      error: reference not found
           * @see Main#Main(Subject, String)
                       ^

      ---------- BEGIN SOURCE ----------
      package dev.notmyfault;

      /**
       * Dummy class
       *
       * @param <Subject> A subject.
       */
      public class Main<Subject> {

          private Subject input;

          public Main(Subject input, String time) {

          }

          /**
           * A subject with an input.
           *
           * @see Main#Main(Subject, String)
           */
          public Main(Subject input) {
              super();
              this.input = input;
          }

      }
      ---------- END SOURCE ----------

      CUSTOMER SUBMITTED WORKAROUND :
      Executing javadoc 17.0.4 on the source code attached works as expected and doesn't fail.

      FREQUENCY : always


            Unassigned Unassigned
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated: