Sunday, 16 February 2014

package.html vs.

Found a good reference1 on why you should use a class.

  • can contain (package) annotations
  • package-info is not a legal identifier for a class2. So there's no chance of mistakes from the compiler.
  • “It is recommended that, if it is present, take the place of package.html for javadoc and other similar documentation generation systems.”2
  • you're not messing up your source files with .html files, which was in fact the case with the old package.html.


[1] Javadoc: package.html or
[2] The Java™ Language Specification - Java SE 7

No comments:

Post a Comment