Name: krT82822 Date: 10/07/99


Running javadoc on the following code (with appropriate -link/-linkoff line arguments to point to JDK docs) shows that javadoc doesn't resolve the reference to IllegalStateException unless f() actually declares "throws IllegalStateException". I.e., if it is only mentioned in an @throws tag, it isn't resolved. The method g() demonstrates that the problem doesn't arise with other exception classes in package java.lang.

package desdemona;

public class B {
    /**
     * @throws IllegalStateException occasionally
     */

    public void f () {
    }

    /**
      * @throws IllegalArgumentException occasionally
      */

    public void g () {
    }
}

In the generated HTML, IllegalArgumentException is linked successfully to the relevant JDK docs, but IllegalStateException is not.
(Review ID: 96148)
======================================================================