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

Documentation not HTML 4.01 compliant.

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P4 P4
    • None
    • 1.4.0
    • tools



      Name: rmT116609 Date: 01/24/2003


      FULL PRODUCT VERSION :
      java version "1.4.0"
      Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
      Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

      FULL OPERATING SYSTEM VERSION :
      Microsoft Windows XP [versie 5.1.2600]

      A DESCRIPTION OF THE PROBLEM :
      I just wanted to tell you the Java documentation doesn't comply to the HTML standards... It kind of surprised me because that wasn't what I expected from you. Still though, if I run
      http://java.sun.com/j2se/1.4/docs/api/index.html or
      http://java.sun.com/j2se/1.4/docs/api/overview-summary.html through w3c's validator at
      http://validator.w3.org/, it doesn't pass.

      This doesn't nessecarily have to be that way - the document is perfectly well fit to comply to the HTML standards, however, it just doesn't. In most cases, it's only small bugs. I'll name a few:

      - Multiple <body> tags in the document, or body tags at the wrong place.

      - <b> tags within <a> tags (there can be no tags within an <a> tag, so they should be placed outside it).

      - The API frameset is not defined as a frameset in the doctype, it should say blablabla... "-//W3C//DTD HTML 4.0 Frameset//EN" ...blablabla.

      - There's no type definition in the <script> tags, it should be <script type="javascript"> or something.


      I think that as a result of this the documentation shows up improperly in my web browser (Internet Explorer 6), because for some reason it always displays a horizontal scrollbar, which is very annoying because the a small part of the right side of the document is obscured because of that.

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      1. Open documentation in Internet Explorer 6
      2. See how there is a horizontal scrollbar
      3. Validate the pages at http://validator.w3.org/

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      I expected there to be no horizontal scrollbar, however there is one.

      This bug can be reproduced always.
      (Review ID: 147186)
      ======================================================================

            dkramersunw Douglas Kramer (Inactive)
            rmandalasunw Ranjith Mandala (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: