Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8008164

Invisible table captions in javadoc-generated html

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 8
    • 8
    • tools
    • b112
    • Verified

      From Martin Buchholz, via compiler-dev

      Hi doclet maintainers,

      This is a bug report with what might be an easy fix.

      At javadoc8's suggestion, jsr166 javadoc tables now have <caption> tags.
      But the caption text is invisible, because the background color is the same as the foreground color, #FFFFFF.

      See the invisible text for yourself here:
      http://gee.cs.oswego.edu/dl/jsr166/dist/docs/java/util/Deque.html
      If you mouse-select the caption text, it magically becomes visible.

      I think the culprit is this code from
      src/share/classes/com/sun/tools/doclets/internal/toolkit/resources/stylesheet.css

      .overviewSummary caption, .packageSummary caption, .contentContainer ul.blockList li.blockList caption, .summary caption, .classUseContainer caption, .constantValuesContainer caption {
          position:relative;
          text-align:left;
          background-repeat:no-repeat;
          color:#FFFFFF;
          font-weight:bold;
          clear:none;
          overflow:hidden;
          padding:0px;
          margin:0px;
      }

      I have reason to believe that if you change the color: above to e.g. color:#353833, the captions will become visible. I have no idea whether anything else will change.

      Martin

            bpatel Bhavesh Patel (Inactive)
            jjg Jonathan Gibbons
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: