-
Bug
-
Resolution: Fixed
-
P5
-
1.4.0
-
sparc
-
solaris_9
-
Not verified
For build 83 of Merlin,
-=---------------------
for the following testcase,
jtools-sqe:/home/vr128054/vertest/4493048 143 % more test.java
/**
* @bug EmitAWarningAndStop
* @bogusTag NoMoreThanOneWarning
* @IAmNotATag JustOneWarning
* @author ValidTag
*/
public class test
{
}
the following runtime log is got.
=================================
jtools-sqe:/home/vr128054/vertest/4493048 144 % javadoc test.java
Loading source file test.java...
Constructing Javadoc information...
Standard Doclet version 1.4.0
Generating constant-values.html...
Building tree for all the packages and classes...
Building index for all the packages and classes...
Generating overview-tree.html...
Generating index-all.html...
Generating deprecated-list.html...
Building index for all classes...
Generating allclasses-frame.html...
Generating allclasses-noframe.html...
Generating index.html...
Generating packages.html...
Generating test.html...
test.java:7: warning - @bug is an unknown tag.
test.java:7: warning - @bogusTag is an unknown tag.
test.java:7: warning - @IAmNotATag is an unknown tag.
Generating package-list...
Generating help-doc.html...
Generating stylesheet.css...
3 warnings
All the three warnings are reported at line number 7, which is the location of the start of the class which is documented. This might be misleading when the classes have huge documentations with identical tags, descriptions etc.
-=---------------------
for the following testcase,
jtools-sqe:/home/vr128054/vertest/4493048 143 % more test.java
/**
* @bug EmitAWarningAndStop
* @bogusTag NoMoreThanOneWarning
* @IAmNotATag JustOneWarning
* @author ValidTag
*/
public class test
{
}
the following runtime log is got.
=================================
jtools-sqe:/home/vr128054/vertest/4493048 144 % javadoc test.java
Loading source file test.java...
Constructing Javadoc information...
Standard Doclet version 1.4.0
Generating constant-values.html...
Building tree for all the packages and classes...
Building index for all the packages and classes...
Generating overview-tree.html...
Generating index-all.html...
Generating deprecated-list.html...
Building index for all classes...
Generating allclasses-frame.html...
Generating allclasses-noframe.html...
Generating index.html...
Generating packages.html...
Generating test.html...
test.java:7: warning - @bug is an unknown tag.
test.java:7: warning - @bogusTag is an unknown tag.
test.java:7: warning - @IAmNotATag is an unknown tag.
Generating package-list...
Generating help-doc.html...
Generating stylesheet.css...
3 warnings
All the three warnings are reported at line number 7, which is the location of the start of the class which is documented. This might be misleading when the classes have huge documentations with identical tags, descriptions etc.