8285368: Overhaul doc-comment inheritance

6376959: Algorithm for Inheriting Method Comments seems to go not as documented
6934301: Support directed inheriting of class comments with @inheritDoc

Reviewed-by: jjg, rriggs, aivanov, smarks, martin

src/java.base/share/classes/java/util/TreeMap.java

@@ -1195,6 +1195,8 @@ public class TreeMap<K,V>
      * {@code Set.remove}, {@code removeAll}, {@code retainAll} and
      * {@code clear} operations.  It does not support the
      * {@code add} or {@code addAll} operations.
+     *
+     * @return {@inheritDoc SortedMap}
      */
     public Set<Map.Entry<K,V>> entrySet() {
         EntrySet es = entrySet;