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

jdk7 javadocs are hard to read

    XMLWordPrintable

Details

    Backports

      Description

        A DESCRIPTION OF THE PROBLEM :
        Go down to the Method Summary and try and find the two sort() methods.

        These pages are hard to read.

        Either indent the method description so the method names shows up, or change the format so that the method names are easily seen in the list.

        Same thing with the field summary.

        EXPECTED VERSUS ACTUAL BEHAVIOR :
        EXPECTED -
        Words are fine, it's the presentation of the method and field names that is bad.

        URL OF FAULTY DOCUMENTATION :
        http://docs.oracle.com/javase/7/docs/api/java/util/Collections.html

        Attachments

          Issue Links

            backported by

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8031268 jdk7 javadocs are hard to read

            • P3 - Major loss of function.
            • Resolved

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8032340 jdk7 javadocs are hard to read

            • P3 - Major loss of function.
            • Closed
            duplicates

            Bug - A problem which impairs or prevents the functions of the product. JDK-8021313 css font issues

            • P3 - Major loss of function.
            • Resolved

            Enhancement - null JDK-8024552 New JavaDoc format is harder to read - Java 6 docs are more usable

            • P3 - Major loss of function.
            • Resolved

            Enhancement - null JDK-4214553 stddoclet: Font size for return type in summary should be made stylesheet option

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            relates to

            Bug - A problem which impairs or prevents the functions of the product. JDK-8129828 Javadoc.exe generates stylesheet.css with dangling reference to dejavu.css

            • P3 - Major loss of function.
            • Resolved

            Activity

              People

                bpatel Bhavesh Patel (Inactive)
                webbuggrp Webbug Group
                Votes:
                0 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: