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

stddoclet: Displays unnecessary horizontal scroll bars - invalid HTML DOCTYPE

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 1.4.0
    • Fix Version/s: 1.4.2
    • Component/s: tools
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      mantis
    • CPU:
      generic
    • OS:
      other

      Description

      javaPlatform is Windows 2000 and IE6. Fire up just about any javadocs
      stuff (e.g., the www.sun.com/j2se/1.4/docs/api ) No matter how wide I
      make the browser window, the horizontal scroll bar remains present,
      and text is always hidden under the scrollbar. For example, with the
      javadocs URL mentioned above, the upper right corner says
      "Std. Ed. v1.4." and the last "0" of the version spec has about 8
      pixels showing, the rest of the "0" hiding under the scroll
      bar... unless I scroll over.

      This just started happening with IE6.

      I noticed that the javadocs API HTML starts off with a <!DOCTYPE ...>
      declaration that includes the optional second argument listing the
      "DTD" ("http://www.w3.org/TR/REC-html40/loose.dtd"):

      <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">

      According to other information I've found, this causes IE6 to
      strictly interpret HTML according to the W3C standard. IE5, and, I
      think, Netscape, use what they call "Quirk Mode" where they do things
      "not quite right, but everyone's used to it working that way."

      Apparently, as browsers transition to "strict/standard" html
      rendering, there are a fair number of behavior changes, many of which
      seem to be in how widths are inherited through tables and such...

      In fact, if I manually delete the second quoted argument within the
      "<!DOCTYPE" specification, IE6 reverts to "quirk mode" and renders the
      javadocs html perfectly (that is, no horizontal scroll bars and no
      hiding text).

      Does anyone know? Is this "scrollbars always present and text hiding
      behind the scrollbars" problem due to incorrect HTML generated by
      javadocs? Or is it due to a bug in IE6's rendering?

      I've been unable to find any mention of this formatting issue
      anywhere... And this same "issue" is showing up in our own javadocs,
      too...

      Thanks. (I searched quite a bit and wasn't able to find any issues
      that sounded like this one... If I've duplicated a previous posting,
      I'm really sorry!)

        Attachments

          Activity

            People

            • Assignee:
              dkramersunw Douglas Kramer (Inactive)
              Reporter:
              dkramersunw Douglas Kramer (Inactive)
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:
                Imported:
                Indexed: