-
Bug
-
Resolution: Fixed
-
P3
-
1.4.0
-
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.
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.