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

AbstractMap should specify its default implementation using @implSpec

XMLWordPrintable

        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 ---

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

                Created:
                Updated:
                Resolved: