If I run javadoc against a single source file that has references to
other classes or methods in the same package, I get warnings.
For example, let's take TreeSet.java:

$ javadoc -d /tmp/t3 -sourcepath . java/util/TreeSet.java Loading source file java/util/TreeSet.java...
Constructing Javadoc information...
Standard Doclet version 1.6.0-ea
Building tree for all the packages and classes...
Generating /tmp/t3/java/util//TreeSet.html...
java/util/TreeSet.java:75: warning - Tag @see: reference not found: Collection
java/util/TreeSet.java:75: warning - Tag @see: reference not found: Set
java/util/TreeSet.java:75: warning - Tag @see: reference not found: HashSet
java/util/TreeSet.java:75: warning - Tag @see: reference not found: Comparator
java/util/TreeSet.java:75: warning - Tag @see: reference not found: Collections#synchronizedSortedSet(SortedSet)
java/util/TreeSet.java:75: warning - Tag @see: reference not found: TreeMap
Generating /tmp/t3/java/util//package-frame.html...
Generating /tmp/t3/java/util//package-summary.html...
Generating /tmp/t3/java/util//package-tree.html...
Generating /tmp/t3/constant-values.html...
Generating /tmp/t3/serialized-form.html...
Building index for all the packages and classes...
Generating /tmp/t3/overview-tree.html...
Generating /tmp/t3/index-all.html...
Generating /tmp/t3/deprecated-list.html...
Building index for all classes...
Generating /tmp/t3/allclasses-frame.html...
Generating /tmp/t3/allclasses-noframe.html...
Generating /tmp/t3/index.html...
Generating /tmp/t3/help-doc.html...
Generating /tmp/t3/stylesheet.css...
6 warnings

javadoc should act as if there was an explicit import

import java.util.*;

added to TreeSet.java, since that's the way javac works.

This is especially important for using javadoc with the -link option.
###@###.### 2005-06-05 02:25:16 GMT