Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8356549 javadoc has incorrect {@link/@linkplain} tags with refer to private/protected types
  3. JDK-8356553

Incorrect uses of {@link} in AbstractQueuedLongSynchronizer and AbstractQueuedSynchronizer

XMLWordPrintable

    • Icon: Sub-task Sub-task
    • Resolution: Unresolved
    • Icon: P4 P4
    • None
    • None
    • core-libs
    • None

      After adding a warning for `{@link}` tags that refer to private/protected types, we see these warnings when building javadoc.

      ```
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java:1307: warning: reference to non-visible type: AbstractQueuedLongSynchronizer.acquire(AbstractQueuedLongSynchronizer.Node, long, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java:1350: warning: reference to non-visible type: AbstractQueuedLongSynchronizer.acquire(AbstractQueuedLongSynchronizer.Node, long, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java:1402: warning: reference to non-visible type: AbstractQueuedLongSynchronizer.acquire(AbstractQueuedLongSynchronizer.Node, long, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java:1446: warning: reference to non-visible type: AbstractQueuedLongSynchronizer.acquire(AbstractQueuedLongSynchronizer.Node, long, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedLongSynchronizer.java:1489: warning: reference to non-visible type: AbstractQueuedLongSynchronizer.acquire(AbstractQueuedLongSynchronizer.Node, long, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:89: warning: reference to non-visible type: acquire(AbstractQueuedSynchronizer.Node, int, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
       * this object, and {@link #acquire}, given this saved state value,
                          ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:1686: warning: reference to non-visible type: AbstractQueuedSynchronizer.acquire(AbstractQueuedSynchronizer.Node, int, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:1729: warning: reference to non-visible type: AbstractQueuedSynchronizer.acquire(AbstractQueuedSynchronizer.Node, int, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:1781: warning: reference to non-visible type: AbstractQueuedSynchronizer.acquire(AbstractQueuedSynchronizer.Node, int, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:1825: warning: reference to non-visible type: AbstractQueuedSynchronizer.acquire(AbstractQueuedSynchronizer.Node, int, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:1868: warning: reference to non-visible type: AbstractQueuedSynchronizer.acquire(AbstractQueuedSynchronizer.Node, int, boolean, boolean, boolean, long) (use -protected or -private options to document non-public types)
               * {@link #acquire} with saved state as argument.
                     ^
      ```

            alanb Alan Bateman
            nbenalla Nizar Benalla
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated: