Javadoc - group static methods?

Jonathan Gibbons jonathan.gibbons at oracle.com
Tue Dec 4 17:05:40 PST 2012


See
http://bugs.sun.com/view_bug.do?bug_id=8002304
http://hg.openjdk.java.net/jdk8/jdk8/langtools/rev/522a1ee72340

-- Jon

On 12/03/2012 11:18 AM, Zhong Yu wrote:
> Hi, would it make more sense in javadoc to group static methods and
> give them a distinct section? So we'll probably have sections
>
>    static fields
>    static methods
>    constructors
>    instance fields
>    instance methods
>
> Some stats: among public static methods in java.*, apparently 401
> methods are factory methods like ByteBuffer.allocate(), 641 are
> utility methods in utility classes like Math.max(), and the remaining
> 377 are like Character.isLowerCase() - utility methods in non-utility
> classes.
>
> Zhong Yu



More information about the javadoc-dev mailing list