Description Frederic Fusier 2007-11-27 07:49:18 EST

Consider the following test case:
package pack;
public class Test {
  /**
   * @see java
   * @see java.lang
   */
  public void foo() {}
}

Generate this test case with Javadoc tool, produces 2 warnings:
Generating D:\workspace\doc\pack\Test.html...
D:\workspace\src\pack\Test.java:8: warning - Tag @see: reference not found: java
D:\workspace\src\pack\Test.java:8: warning - Tag @see: reference not found: java.lang

JDT compiler does not raise any warning, even while processing Javadoc comments and reporting invalid references in tag.

Open this bug on version 3.0 as this behavior difference with Javadoc tool is the direct consequence of fix for bug 50695 which has been released in 3.0M7!

Note that bug 50695 was fixed upon Javadoc tool 1.4 "specification": http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html#@see
(see table Typical forms for @see package.class#member)

But it seems that the last syntax of this table "@see  package" is only valid for the package declaration. All other package references produce a warning during the Javadoc tool generation.

So, following syntax should still be accepted:
package pack;
public class Test {
  /**
   * @see pack
   */
  public void foo() {}
}