Summary

Enhance thejavadoc tool to generateHTML5 markup.

Goals

Provide an option to the standard doclet to request either HTML 4 or HTML5 output.The HTML5 markup is semantic, i.e., clearly separating meaning fromstyle and content. The parts of the pages generated by the standard docletusing HTML5 markup satisfy accessibility requirements.

Non-Goals

It is a not a goal to replace the current three-frame/no-frame structure of thegenerated HTML pages; that may be the subject of a future JEP.

It is not a goal to mandate the use of HTML5 in documentation comments,nor is it a goal to provide the ability to convert documentation comments written usingHTML 4 to HTML5.

Motivation

In JDK 8 and older releases, the standard doclet generated pages inHTML 4.01,which is an old standard, and not not provide support for satisfying accessibility requirements.
HTML5 is the latest standard for HTML. HTML5 increases the semantic value of webpages and makes it easier to create accessible web pages.

Description

• A command-line option is added to the standard doclet to request aspecific type of output markup. HTML4, which is the current type,will be the default. HTML5 will become the default in JDK 10.

• The semantic value of the generated HTML is improved by usingstructural HTML5 elements such asheader,footer,nav,etc.

• The HTML5 markup implements theWAI-ARIA standard foraccessibility. Specific roles are assigned to elements in theHTML document using the role attribute.

• The-Xdoclint feature is update to check documentation commentsfor common errors, based upon the requested type of output markup.

Testing

Tests are provided to ensure that:

• The HTML5 markup is valid
• The HTML5 markup is accessible
• The new command-line option works correctly
• The HTML5 markup works across all supported browsers

The lack of automated tools to test accessibility hamperscomprehensive accessibility testing. A representative sampleof different types of pages can checked using online web-basedtools.