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

Javadoc missing link to member method

XMLWordPrintable

    • b04
    • 12
    • b18
    • x86_64
    • generic

      ADDITIONAL SYSTEM INFORMATION :
      Microsoft Windows [Version 10.0.17763.348]
      OpenJDK 11.0.2+7
      OpenJDK 12-ea+32
      OpenJDK 13-ea+10

      A DESCRIPTION OF THE PROBLEM :
      See repro steps below

      REGRESSION : Last worked in version 11.0.2

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      1. Create testcase as mentioned below
      2. "cd target"
      3. "javadoc.bat"
      4. Open the Javadoc for com.company.Child
      5. Notice that "methodMethodLink" listed in the method summary is missing a hyperlink to the detailed description below.
      6. Edit javadoc.bat so it runs JDK 11.0.2
      7. "javadoc.bat"
      8. Notice that Child.methodMethodLink contains a hyperlink as expected.

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      methodMethodLink should link to the detailed Javadoc at the bottom of the page
      ACTUAL -
      methodMethodLink is not linked

      ---------- BEGIN SOURCE ----------
      src/main/java/com/company/Child.java:
      --------------------------------------------
      package com.company;

      public abstract class Child extends Parent<String> {
          private static final Child INSTANCE = new Child() {
              @Override
              protected String methodMissingLink() {
                  return "test";
              }
          };

          public static Child getInstance() {
              return INSTANCE;
          }
      }
      --------------------------------------------

      src/main/java/com/company/Parent.java:
      --------------------------------------------
      package com.company;

      abstract class Parent<T> {
          /**
           * Returns some value.
           *
           * @return some value
           */
          protected abstract String methodMissingLink();
      }
      --------------------------------------------

      target/javadoc.bat:
      --------------------------------------------
      rem "C:\Program Files\Java\jdk-11.0.2\bin\javadoc.exe" @options @packages
      rem "C:\Program Files\Java\jdk-12-ea+32\bin\javadoc.exe" @options @packages
      "C:\Program Files\Java\jdk-13-ea+10\bin\javadoc.exe" @options @packages
      --------------------------------------------

      target/options:
      --------------------------------------------
      -sourcepath
      '../src/main/java'
      -d
      '.'
      --------------------------------------------

      target/packages:
      --------------------------------------------
      com.company
      --------------------------------------------
      ---------- END SOURCE ----------

      FREQUENCY : always


            hannesw Hannes Wallnoefer
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated:
              Resolved: