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

Doclet API: ThrowsTag.exception () returns null sometimes.

    • beta2
    • sparc
    • solaris_8
    • Verified

      ThrowsTag.exception() doesnt return an exception properly (while ThrowsTag.exceptionName() is working just fine).

      Please find the test results attached for java.io.RandomAccessFile.java (used as testcase here).
      -------------------------------------------

      Old Javadoc output *(Using the testdoclet attached alongwith)
      ------------------
      Loading source file RandomAccessFile.java...
      Constructing Javadoc information...
      Class: RandomAccessFile
          constructor: RandomAccessFile
              exceptionName of ThrowsTag: IllegalArgumentException
              exceptionComment of ThrowsTag: if the mode argument is not equal
                     to <code>"r"</code> or to <code>"rw"</code>.
              exception of ThrowsTag: IllegalArgumentException
              text of ThrowsTag: IllegalArgumentException if the mode argument is not
       equal
                     to <code>"r"</code> or to <code>"rw"</code>.
              exceptionName of ThrowsTag: IOException
              exceptionComment of ThrowsTag: if an I/O error occurs.
              exception of ThrowsTag: IOException
              text of ThrowsTag: IOException if an I/O error occurs.
      .
      .
      .
      .
      .
      ( Only relevant portion of output shown).

      Now find the new javadoc output as below.
      -----------------------------------------
      Loading source file RandomAccessFile.java...
      Constructing Javadoc information...
      Class: RandomAccessFile
          constructor: RandomAccessFile
              exceptionName of ThrowsTag: IllegalArgumentException
              exceptionComment of ThrowsTag: if the mode argument is not equal
                     to <code>"r"</code> or to <code>"rw"</code>.
              exception of ThrowsTag: IllegalArgumentException
              text of ThrowsTag: IllegalArgumentException if the mode argument is not
       equal
                     to <code>"r"</code> or to <code>"rw"</code>.
              exceptionName of ThrowsTag: IOException
              exceptionComment of ThrowsTag: if an I/O error occurs.
              what is this ??? : null
              text of ThrowsTag: IOException if an I/O error occurs.

      .
      .
      .
      .
      (Again, only relevant portion of output attached here).

      Please find the following line in Old Javadoc output,
              exception of ThrowsTag: IOException
      replaced by
              what is this ??? : null

      These lines correspond to the following block of code in the test doclet.
      -------------------------------------------------------------------------
      if (tag[i].exception() != null )
      {
      System.out.println(indent + "exception of ThrowsTag: " + tag[i].exception().name());
      }
      else
      {
              System.out.println (indent+"what is this ??? : "+tag[i].exception ());
      }

      The full test doclet is attached to this bug report.

            jhosunw Jamie Ho (Inactive)
            rvijayansunw Ra Vijayan (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: