/javadoc: Treat methods defined in parent class's as the class's own methods.
Closed this issue · 2 comments
/javadoc StringBuilder#capacity
Sorry, I never heard of that class. :(
The capacity method is defined in the AbstractStringBuilder class.
If you look at the Java source code, the StringBuilder class extends AbstractStringBuilder, which is package-private. However, if you look at the Javadocs, AbstractStringBuilder is not part of the public Java API.
Because of this, its methods get "merged" with StringBuilder in the Javadocs, so it looks like the capacity method is part of the StringBuilder class.
The problem is that this is causing oakbot-doclet to ignore all the methods in the AbstractStringBuilder class. It does not generate an XML file for AbstractStringBuilder. I guess this is because the class is package-private and is not returned by Rootdoc.classes(). However, it still marks this class as being the parent class of StringBuilder.
Possible solution: When iterating over the list of classes returned by Rootdoc.classes(), check to see if each class's parent class is package-private. If it is, treat all of the parent class's methods, interfaces, and parent classes as if they belonged to the child class and do not mark the child class as having a parent class.