RFR: docs JDK-8220261: fix headings in java.base
jonathan.gibbons at oracle.com
Wed Mar 20 21:50:52 UTC 2019
Please review a medium-sized but conceptually simple patch to fix most
of the headings in the generated documentation for java.base, as
described in . This does not address the headings in
java.util.concurrent which are reported separately, in JDK-8220248.
The intent is to ensure that the headings in the generated pages are
well-structured, with no gaps, and correct implicit nesting. Generally,
the changes fall into three kinds:
* Headings in doc-comments for modules, packages and types start at <h2>
* Headings in doc comments for constructors, fields, methods and other
members start at <h4>
* Headings in package.html and doc-files/*.html start at <h1>
The headings have been verified with the doccheck utility.
We cannot re-enable doclint accessibility checking for java.base until
JDK-8220248 has also been fixed.
More information about the core-libs-dev