JDK-8232439 : Revisit/review column widths in javadoc tables
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 14
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • Submitted: 2019-10-17
  • Updated: 2022-07-18
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.
Other
tbdUnresolved
Related Reports
Relates :  
JDK-8253117 - Replace HTML tables in javadoc summaries with CSS grid elements
Description
javadoc tables look "ugly" when there are a series of tables each with the same number of columns but with varying widths.

It might be time to go back to fixed column widths.
Comments
Deferred to "tbd" as I'm not sure this is something we can do much about. We need to define columns widths with some amount of flexibility to accomodate to different kinds of contents, and the variability in actual widths is a direct result of this.
24-11-2021
I guess I'm OK with "Will Not Fix" for adjacent tables, but there's also the case of dynamic adjustment of a single table when the "tabs" are used to select different subsets of rows to be displayed. It may be that "Will Not Fix" is OK for that as well, but if so, that should be an explicit recorded decision.
26-12-2020
Given the above considerations and the fact that this is a purely aesthetic problem I will close this as won't fix. We can reopen it if we find a viable solution for it.
10-12-2020
The varying column width of neighboring tables (such as various summary tables in type pages) is still present with grid layout. I tried to impose a more regular partition when tweaking grid parameters, but invariably there was some case where it wouldn't fit table contents - space requirements are just too variable among use cases. With media queries and multi-line representation for small display sizes this becomes less of a problem I guess.
10-12-2020
How does this interact with the recent change to use CSS display:grid and the use of media queries for small devices?
09-12-2020