Mark,
The font-family settings in the <dl> nodes were deliberate, and a
workaround for not having time to create a proper taglet for tool guides.
If you remove the style attribute, you'll see in your sample output that
the "Tool Guides" header is in Serif font, but the immediately following
"Since: " header is in the standard Sans Serif font.
See, for example, this page:
http://cr.openjdk.java.net/~mr/rev/8182776/api/jdk.compiler-summary.html
And for those that can see images in line:
Screnshot of mismatched header fonts
The screenshot has also been attached to the appropriate bug: JDK-8183161
I would recommend that JDK-8183161 should be "Not An Issue" and the
changes reverted in the proposed patch.
-- Jon
On 06/30/2017 02:36 PM, mark.reinh...@oracle.com wrote:
8182776: Fix typo "upgradeble" in the javadoc of upgradeable modules
8183161: Remove extraneous font-family style attributes from module declarations
8183251: Meta "keywords" tag malformed in overview-summary.html and related
pages
http://cr.openjdk.java.net/~mr/rev/8182776/jdk9-dev.patch
http://cr.openjdk.java.net/~mr/rev/8182776/api/ (sample output)
None of these is truly P1 but they're all fairly embarrassing and the
fixes are low-risk, so since we know we're going to do another build next
week anyway I'd like to include this patch.
The fix for 8183251 doesn't solve the problem of `<div>` occurring inside
`<h1>`, but this only ever happens in the frame-summary pages and appears
to do no harm when rendered.
This patch includes a few minor editorial fixes, e.g., changing `@link`
tags to `@linkplain` where appropriate in module declarations.
Thanks,
- Mark
