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

AbstractMap should specify its default implementation using @implSpec

    Details

      Backports

        Description

        see discussion on core-libs-dev mailing list:
           http://mail.openjdk.java.net/pipermail/core-libs-dev/2013-December/024163.html
         
        --- snippet ---
        There might have been some mis-communication about whether the
        new @implSpec tag would be used in existing java.util.AbstractX
        classes. I had assumed that it would be, and pulled out a few
        javadoc overrides in java.util.concurrent classes that would
        not be needed if @implSpec were used. With @implSpec, you do
        not need to paste in the interface-level spec in an overridden
        method just to suppress inclusion of (incorrect) doc comments
        about the default implementation.

        Is it too late to do this for JDK8? It is easy -- just add a line
        with @implSpec for each defined method. AbstractMap diffs
        below. (They could be tweaked to get rid of now-unnecessary
        paragraph markup, but I don't think this would improve display.)
        ...
        --- snippet ---

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  chegar Chris Hegarty
                  Reporter:
                  chegar Chris Hegarty
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  6 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: