Enhancements in Javadoc, Java SE 7

The following describes the changes and enhancements made for Javadoc tool in Java SE 7.

HTML documents generated by the Javadoc tool conform to the HTML 4.01 Transitional DTD (Document Type Definition). However, the Javadoc tool does not currently ensure that HTML fragments in Javadoc comments, or option values specified by the user, conform to this DTD.

Generated HTML documents are also compliant to the Electronic and Information Technology Accessibility Standards (Section 508) specification. Similarly, the Javadoc tool does not currently ensure compliance to this standard of any user-specified HTML fragments.

The look-and-feel of HTML documents generated by the Javadoc tool has been updated for this release. This is accomplished by using CSS (Cascading Style Sheets) files. You can change the look-and-feel of your API documentation by changing the CSS file. Future updates and releases of the JDK may include additional look-and-feel options through CSS files. The defalt stylesheet.css file can be found in the API documentation.

The -stylesheetfile <path> option can be used to specify a stylesheet other than the default.

For more information, see the following RFEs: 7052425 and 6851834.


Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.