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

javadoc-generated pages set background, but not foreground color

XMLWordPrintable

      FULL PRODUCT VERSION :
      Noticed in J2SE 1.4.x, 1.5.0.

      ADDITIONAL OS VERSION INFORMATION :
      Irrelevant, probably applies to all OSs.

      EXTRA RELEVANT SYSTEM CONFIGURATION :
      Noticed on <URL:http://java.sun.com/j2se/1.5.0/docs/api/java/lang/package-summary.html>.

      A DESCRIPTION OF THE PROBLEM :
      As seen on <URL:http://java.sun.com/j2se/1.5.0/docs/api/java/lang/package-summary.html&gt;, the javadoc tool generates pages which are inaccessible to many users, because the background color is set to white, and the foreground color is not set.
      This results in a problem for uses who set the default colors in their browser to white on black, for example.

      Solution:
      Do not set any colors.
          OR
      Set the foreground color to black and set the background color to white.

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      Use, for example, the Mozilla browser <URL:http://mozilla.org/&gt;, and set the default colors to white foreground and black background. Then navigate to <URL:http://java.sun.com/j2se/1.5.0/docs/api/java/lang/package-summary.html>.

      You can also try this with any page generated by the javadoc tool, which does not use a stylesheet to override the colors.

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      Readable text.
      ACTUAL -
      You will not be able to read most texts, since they are presented in white on white background.

      REPRODUCIBILITY :
      This bug can be reproduced always.

      ---------- BEGIN SOURCE ----------
      The erroneous code snippet in the web page is:

      <BODY BGCOLOR="white"
      ---------- END SOURCE ----------

      CUSTOMER SUBMITTED WORKAROUND :
      Use sed on the generated pages to remove
          BGCOLOR="white"
      ###@###.### 2004-12-17 19:40:21 GMT

            dkramersunw Douglas Kramer (Inactive)
            gmanwanisunw Girish Manwani (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: