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

Remove superfluous period in @throws tag description

    XMLWordPrintable

Details

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

    Description

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

      Attachments

        Issue Links

          Activity

            People

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

              Dates

                Created:
                Updated:
                Resolved: