On 03/11/2019 02:11 PM, Jonathan Gibbons wrote:
Please review a moderately simple fix to improve doclint's checking of
headings in doc comments.
Build folk: by default, the improved checking causes build issues
until the doc comments in some modules can be updated. To workaround
that, the doclint options in the build have been modified. It is
assumed we will re-enable the checks as the issues in each affected
module get addressed.
javadoc/doclint folk: the new guidelines of using h2 or h4 as the base
heading as appropriate are now hard-coded into doclint. In addition,
the error messages have been improved, and a new check added, for
using a heading that is too low for the context. Internally, some
names have been improved to reflect the current terminology. Tests
have been updated as appropriate.
-- Jon
Doh!
JBS: https://bugs.openjdk.java.net/browse/JDK-8220379
Webrev: http://cr.openjdk.java.net/~jjg/8220379/webrev.00
