Name: nt126004 Date: 05/16/2002


FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)


FULL OPERATING SYSTEM VERSION :
all, but:
Linux draught.bbn.com 2.4.18-pre9-ac1 #2 SMP Wed Feb 13
10:04:09 EST 2002 i686 unknown


A DESCRIPTION OF THE PROBLEM :
@see Outer.Inner results in a warning when Outer is
imported - clearly, javadoc is using slightly different
import rules than javac.

See example source code.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. javac Zotz.java
(no errors - import is fine)
2. javadoc -quiet Zotz.java
(warning - see below:)


EXPECTED VERSUS ACTUAL BEHAVIOR :
Expected: No warning - this same @see reference is used in
various places in java.util sources.

Actual:
javadoc -quiet Zotz.java
Loading source file Zotz.java...
Constructing Javadoc information...
Standard Doclet version 1.4.0

Zotz.java:9: warning - Tag @see: reference not found:
Map.Entry This tag warns
1 warning


This bug can be reproduced always.

---------- BEGIN SOURCE ----------
package foo;
import java.util.*;

/**
 * @see Map This tag is ok
 * @see Map.Entry This tag warns
 * @see java.util.Map.Entry This is ok
 **/
public class Zotz {
  // this reference is ok
  Map.Entry x;
}


---------- END SOURCE ----------

CUSTOMER WORKAROUND :
Must use fully-qualified (with package) references to inner
classes.
(Review ID: 146678)
======================================================================