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

@inheritDoc doesn't work with @exception

    Details

    • Type: Bug
    • Status: Open
    • Priority: P2
    • Resolution: Unresolved
    • Affects Version/s: 8-pool, 9
    • Fix Version/s: tbd_minor
    • Component/s: tools
    • Labels:
      None

      Description

      According to http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html, @throws "Behaves the same as the \@exception tag".

      Unfortunately, it's not the case when used with {\@inheritDoc} inline tag.

      Consider the descriptions for IndexOutOfBoundsException thrown from java.io.BufferedReader#read(char[], int, int).

      Documentation:
      http://download.java.net/java/jdk9/docs/api/java/io/BufferedReader.html#read-char:A-int-int-

      Source: http://hg.openjdk.java.net/jdk9/jdk9/jdk/file/f8a3c1510f95/src/java.base/share/classes/java/io/BufferedReader.java#l275

      (currently, build 119)


        Attachments

          Activity

            People

            • Assignee:
              ksrini Kumar Srinivasan
              Reporter:
              prappo Pavel Rappo
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated: