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

javadoc should not use a monotype font for <dd> elements

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P2 P2
    • None
    • None
    • tools

      <dd> elements in <dl> lists look terrible, because they are displayed in monotype. E.g. look at

      http://download.java.net/jdk9/docs/api/java/util/concurrent/ThreadPoolExecutor.html

      after "Core and maximum pool sizes"

      Looking at src/jdk.javadoc/share/classes/com/sun/tools/doclets/internal/toolkit/resources/stylesheet.css
      that seems to be intentional, but I can't see any reason for it.
      I tried the obvious change

      --- a/src/jdk.javadoc/share/classes/com/sun/tools/doclets/internal/toolkit/resources/stylesheet.css
      +++ b/src/jdk.javadoc/share/classes/com/sun/tools/doclets/internal/toolkit/resources/stylesheet.css
      @@ -304,7 +304,6 @@
       .contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {
           margin:5px 0 10px 0px;
           font-size:14px;
      - font-family:'DejaVu Sans Mono',monospace;
       }
       .serializedFormContainer dl.nameValue dt {
           margin-left:1px;

      and that greatly improved the generated javadoc appearance.

      Consider getting a real CSS expert to review stylesheet.css

            bpatel Bhavesh Patel (Inactive)
            martin Martin Buchholz
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated:
              Resolved: