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

Method signatures not formatted correctly in browser

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 13
    • 11.0.1
    • tools
    • None
    • b24
    • generic
    • generic

        Preformatted method signatures are not displayed correctly by the browser in javadoc pages (see attached screenshots for expected and actual display). This was probably introduced by JDK-8187288.

        This is the code used for the example screenshots:

        public interface JavadocAnnotationIssue {
          /**
          * Reproduces the formatting error when there is a long @Generated annotation.
          * @param one first
          * @param two second
          * @param three third
          */
          @javax.annotation.Generated(
                    value = "SomeGeneratedClassName",
                    date = "a date",
                    comments = "some really long comment to help demonstrate the issue")
          public void doSomething(String one, String two, String three);
        }

          1. generic-annotated-bad.png
            266 kB
            Hannes Wallnoefer
          2. generic-annotated-fixed.png
            318 kB
            Hannes Wallnoefer
          3. simple-methods-bad.png
            156 kB
            Hannes Wallnoefer
          4. simple-methods-fixed.png
            177 kB
            Hannes Wallnoefer

              hannesw Hannes Wallnoefer
              hannesw Hannes Wallnoefer
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Created:
                Updated:
                Resolved: