I was generating JavaDoc for my new API recently and noticed that JavaDoc had some trouble resolving @see tags when a method parameter was an inner class (or enum).

Consider the following test case. When generating doc for method1_fail, JavaDoc can't seem to resolve the methods in the @see tags and therefore does not link to them in documentation. In method1_succeed, I've fully qualified the parameter and it works.

I've read in the JavaDoc specification that inner classes must be specified as "Outer.Inner". It would be nice if it could be simplified such that using just "Inner" works.

----------

public class JDTest {
   public class Inner1 {}
   public static class Inner2 {}
   public enum Enum3 {ONE, TWO}

   public void findme2(Inner1 obj) {}
   public void findme3(Inner2 obj) {}
   public void findme4(Enum3 obj) {}

   /**
    * @see #findme2(Inner1)
    * @see #findme3(Inner2)
    * @see #findme4(Enum3)
    */
   public void method1_fail() {}

   /**
    * @see #findme2(JDTest.Inner1)
    * @see #findme3(JDTest.Inner2)
    * @see #findme4(JDTest.Enum3)
    */
   public void method1_succeed() {
   }
}