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

Javadoc: CSS margin is not applied consistently

    XMLWordPrintable

Details

    • b25
    • Verified

    Description

      A DESCRIPTION OF THE PROBLEM :
      It appears the javadoc Standard Doclet does not apply CSS margin consistently, instead some elements have no margin or only left and bottom margin and then only some of the contained elements have margin on the right.
      This causes cases where margin is missing behind the end of the text, or where text in one paragraph is wrapped at a different point than text of another paragraph.

      Affected cases (list is likely incomplete):
      - Class documentation:
        The regular text has no margin on the left, causing it to be at the same horizontal position as <hr> element at the top, but has margin on the right causing it to end slightly before the end of the <hr>.
        On the other hand, the content of block tags in the class documentation has no margin on the right causing it to be as wide as the <hr> element.
      - Method documentation:
        Regular text has margin on the right, causing it to end slightly before the white background ends.
        On the other hand, block tags (their name and their content) have no margin on the right causing their text content to sometimes directly end exactly at the end of the white background.

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      This can be seen best when inspecting the HTML elements using the web browser, but is also visible by for example having a look at methods with "API Note" (or similar block tags which contain long sentences) and then zooming in and out until the text directly reaches the end of the white background.
      For example: https://docs.oracle.com/en/java/javase/14/docs/api/java.base/java/lang/Module.html#addOpens(java.lang.String,java.lang.Module)


      Attachments

        Issue Links

          Activity

            People

              hannesw Hannes Wallnoefer
              webbuggrp Webbug Group
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: