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

Remove superfluous period in @throws tag description

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P5 P5
    • 20
    • 20
    • core-libs
    • b19

      https://docs.oracle.com/en/java/javase/19/docs/api/java.prefs/java/util/prefs/AbstractPreferences.html#remove(java.lang.String)

      the above is rendered as:

      Throws:
      IllegalStateException - if this node (or an ancestor) has been removed with the removeNode() method.
      IllegalArgumentException - if key contains the null control character, code point U+0000.
      NullPointerException - if key is null..

      (Note two successive periods after null in the NPE entry). That happens because of this:

           * @throws NullPointerException {@inheritDoc}.
           */
          public void remove(String key) {

           ...

           * @throws NullPointerException if {@code key} is {@code null}.
           ...
           */
          public abstract void remove(String key);

            prappo Pavel Rappo
            prappo Pavel Rappo
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: