From mark.reinhold at oracle.com Tue Dec 4 16:23:46 2012 From: mark.reinhold at oracle.com (mark.reinhold at oracle.com) Date: Tue, 4 Dec 2012 16:23:46 -0800 (PST) Subject: JEP 172: DocLint Message-ID: <20121205002346.447E5618@eggemoggin.niobe.net> Posted: http://openjdk.java.net/jeps/172 - Mark From zhong.j.yu at gmail.com Mon Dec 3 11:18:18 2012 From: zhong.j.yu at gmail.com (Zhong Yu) Date: Mon, 3 Dec 2012 13:18:18 -0600 Subject: Javadoc - group static methods? Message-ID: 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 From jonathan.gibbons at oracle.com Tue Dec 4 17:05:40 2012 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Tue, 04 Dec 2012 17:05:40 -0800 Subject: Javadoc - group static methods? In-Reply-To: References: Message-ID: <50BE9DE4.6090108@oracle.com> 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