Possible inconsistency with auto generated javadoc for methods with @Override

[Sven Reimers]

Sorry for crossposting this from javadoc-dev, but the e-mail seems to be
stuck in moderating queue and I assume I will reach more people here.
-----

Hi,

I would assume that following the rules from

http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc
.html#inheritingcomments


the javadoc output of

public interface Test {

    void method();

    public abstract class AbstractEmptyTest implements Test {}

    public abstract class DefiningEmptyTest implements Test {
        @Override abstract public void method();
    }

    public class DirectTest implements Test {
        @Override public void method() {}
    }


    public class DefaultWithDefiningTest extends DefiningEmptyTest {
        @Override public void method() {}
    }

    public class DefaultWithEmptyTest extends AbstractEmptyTest {
        @Override public void method() {}
    }
}

should show at least a specified by link in the javadoc for method () on
all non abstract classes?

It seems to me that having an abstract class inbetween the concrete class
with the implementing method and the original interface, somehow the
specified by is not resolved.

Any comments? Shall I file a bug? Did I misread the spec?

Thanks

-Sven



-- 
Sven Reimers

* Senior Expert Software Architect
* NetBeans Dream Team Member: http://dreamteam.netbeans.org
* Community Leader  NetBeans: http://community.java.net/netbeans
                              Desktop Java:
http://community.java.net/javadesktop
* Duke's Choice Award Winner 2009
* Blog: http://nbguru.blogspot.com

* XING: https://www.xing.com/profile/Sven_Reimers8
* LinkedIn: http://www.linkedin.com/in/svenreimers

Join the NetBeans Groups:
* XING: http://www.xing.com/group-20148.82db20
* NUGM: http://haug-server.dyndns.org/display/NUGM/Home
* LinkedIn: http://www.linkedin.com/groups?gid=1860468
                   http://www.linkedin.com/groups?gid=107402
                   http://www.linkedin.com/groups?gid=1684717
* Oracle: https://mix.oracle.com/groups/18497