@inheritDoc does not work if standalone

XMLWordPrintable

    • Type: Bug
    • Resolution: Not an Issue
    • Priority: P3
    • None
    • Affects Version/s: 10, 11, 12, 13, 14, 15
    • Component/s: tools

      Prefixing a method with

          /**
           * {@inheritDoc}
           */

      is ignored by Javadoc. Seems to be that way since JDK 10, okay in 9.

      Examples can be found in
         MutableCallSite::dynamicInvoker
         VolatileCallSite::dynamicInvoker
         Constructor::getModifiers
         Constructor::getParameterTypes
         Constructor::getExceptionTypes
         Executable::getDeclaredAnnotations
         Field::getDeclaredAnnotations
         Method::getModifiers
         Method::getParameterTypes
         Method::getExceptionTypes
         DecimalFormat::setGroupingUsed

      There are 554 occurrences in the JDK, grep: /\*\*\s*\n\s*\*\s*\{@inheritDoc\}\s*\n\s*\*/

            Assignee:
            Jonathan Gibbons
            Reporter:
            Jim Laskey
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: