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

The fix for JDK-8141492 broke formatting of some javadoc documentation.

    Details

    • Subcomponent:
    • Resolved In Build:
      b165
    • CPU:
      generic
    • OS:
      generic
    • Verification:
      Verified

      Backports

        Description

        The fix for JDK-8141492 introduce the changes to the stylesheet.css, which is imported to all out javadoc files:
        These lines were added:
        =====
        a[name]:before, a[name]:target {
            content:"";
            display:block;
            height:120px;
            margin:-120px 0 0;
        }
        a[id]:before, a[id]:target {
            padding-top:129px;
            margin-top:-129px;
            color:red;
        }
        =====
        This caused an incorrect rendering of some existed javadoc files.
        For example check the difference between these two pages:
        http://download.java.net/java/jdk9/docs/api/javax/swing/package-summary.html
        http://download.java.net/java/jdk9/docs/api/javax/swing/package-summary.html#related

        The links above points to the same page, but in the second case the "Related Documentation" paragraph is incorrectly rendered. The reason is that it has an anchor name="related".
        The situation became worse if javadoc in this file will use "id" instead if 'name', in this case the text "Related Documentation" will be RED, which is really unexpected.
        Note that <a> name attribute is not supported in HTML5 and id attribute used instead.

        The fix for this issues also addresses the test failures caused due to fix for JDK-8177562.

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  bpatel Bhavesh Patel (Inactive)
                  Reporter:
                  serb Sergey Bylokhov
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  6 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: