How Do I Document Packages in Java?

Question

In the Java APIs I can see Javadoc comments for packages.

How/where do I place Javadoc comments to document a package?

Answer 1

With a package.html file at the package level (i.e. in the directory for that package). This should be a fully-formed HTML file, with the tag defined in it