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

Javadoc should expose covariant return type overrides

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 11, 12, 13
    • Fix Version/s: 13
    • Component/s: tools
    • Labels:
      None
    • Subcomponent:
    • Resolved In Build:
      b23
    • CPU:
      generic
    • OS:
      generic

      Backports

        Description

        Not showing which methods have covariant return type overrides hides some information from the user. For example, java.nio.MappedByteBuffer has some covariant return type overrides such as

            /**
             * {@inheritDoc}
             */
            @Override
            public final MappedByteBuffer reset() {
                super.reset();
                return this;
            }

        but reset(), et. al., show up under "Methods declared in class java.nio.Buffer". The hierarchy is MappedByteBuffer extends ByteBuffer extends Buffer extends Object.

          Attachments

            Issue Links

              Activity

                People

                Assignee:
                jjg Jonathan Gibbons
                Reporter:
                bpb Brian Burkhalter
                Votes:
                1 Vote for this issue
                Watchers:
                2 Start watching this issue

                  Dates

                  Created:
                  Updated:
                  Resolved: