Name: rlT66838 Date: 04/13/2000
java version "1.2.2"
Classic VM (build JDK-1.2.2.-001, native threads, symcjit)


References for the @link or @see lead to warnings in certain cases
and links are not created in the javadoc.

  Bug 4183834 describes the same problems I encountered, the state
is fixed and closed for JDK 1.2.2 but the program below shows the
wrong behaviour is still there (Sparc & Windows NT).

package nl.virgil;

import java.lang.*;
import java.lang.Integer;

public class Test {

    /**
     * This {@link Math Math link} won't work, not even when it is fully
     * qualified as this link {@link java.lang.Math} shows, even importing
     * java.lang.* doesn't help.
     * <p>
     * The funny thing is that everything for a {@link String String link}
     * seems to work.
     * <p>
     * You can get it working by importing all classes explicitly as you can
     * see in this {@link Integer Integer link}.
     */
    public Test() {

    }
}

javac nl/virgil/Test.java
javadoc -link http://java.sun.com/products/jdk/1.2/docs/api nl.virgil


[The following request has been submitted as separate bug #4396665 -dkramer]

Also I would like to point you at the fact it is sometimes extremely
hard to find the java source code responsible for the warnings
generated by javadoc (overview.html, package.html). Warnings show
up at different places, many times they are caused by the same source.
If all warnings and errors showed the responsible file, life
would be easier:

javadoc: warning - Tag @link: Class or Package not found: Math Math link
(Review ID: 103623)
======================================================================