Oh, as a workaround, if you wanted to say something like this in your javadoc comments:
This would have the same effect:
But it's not as tidy and, imho, should not be required. (Note that NetBeans, the
IDE I am using, adds a "package-
info.java" file to your package, to hold your package-level javadoc, but the HTML it creates from that is written to package-
summary.html.)