Possible inconsistency with auto generated javadoc on overridden elements

Sven Reimers sven.reimers at gmail.com
Tue Jul 23 05:00:18 PDT 2013


Hi,

since I got no response so far  (stuck in moderator queue) this is a retry
to get this through to the list.

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

P.S. Hope this makes it through this time.
-- 
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
<https://mix.oracle.com/groups/18497>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20130723/a70201cb/attachment.html 


More information about the javadoc-dev mailing list