JDK-8183161 : Fix font-family style attributes in module declarations
  • Type: Bug
  • Component: core-libs
  • Affected Version: 9
  • Priority: P1
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2017-06-28
  • Updated: 2017-10-09
  • Resolved: 2017-07-03
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 10 JDK 9
10Fixed 9 b177Fixed
Related Reports
Relates :  
JDK-8181639 - Add tool and services information to module summary
Description
Some of the platform's module declarations contain lines of the form:

  <dl style="font-family:'DejaVu Sans', Arial, Helvetica, sans serif">

This style attribute conflicts with the rules in the standard stylesheet,
which prefers "DejaVu Serif" etc.  These style attributes should be
removed.
Comments
It is verified as "Not verified" due to this is a noreg-* issue.
10-07-2017
Not truly P1 but fairly embarrassing and the fix is low-risk, so approving since at this point we're going to do at least one more build anyway.
03-07-2017
You're right, but the problem with placing the style attribute on the `<dl>` elements is that it forces the `<dd>` text into the sans-serif font. That's fine for the tool-guide links, since they're tool names, but it's wrong for provider descriptions, which are free text (see the attached image for the `java.base` module). The right fix is to repair the Javadoc stylesheet, but the expedient fix is to tweak the style attributes just where needed, so I'll do the latter for now.
03-07-2017
The style attributes should -not- be removed. They have been added to give visual consistency with the Since: header (and any other headers from block tags). Ideally, the tool guides would have been documented with a custom taglet, which would also have generated the same visual effect, i.e. using DejaVu Sans.
30-06-2017