When trying to create package level Javadoc comments, whats the preferred method? What do you do?
package-info.java
- Pros
- Newer
- Cons
- Abuse of a class - Classes are for code, not for only comments
package.html
- Pros
- HTML extension means its not code
- Syntax highlighting in IDE's/text editors
- Cons
- None?
For me, I've always used Package.html. But I'm wondering if its the correct choice.
package-info.java
can contain [package] annotations - it's not necessarily all API docs. – Tom Hawtin - tackline Sep 5 '10 at 2:12package-info.java
for Javadoc and Annotations is not an abuse of a class. – mjaggard Sep 27 '12 at 10:22