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

Option values are not italicized on JDK 8 keytool documentation page

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 8
    • Fix Version/s: 8u40
    • Component/s: docs
    • Labels:

      Description

      The JDK 8 keytool documentation pages at
          http://docs.oracle.com/javase/8/docs/technotes/tools/windows/keytool.html
          http://docs.oracle.com/javase/8/docs/technotes/tools/unix/keytool.html
      appear to have some formatting issues.

      There is a bullet entry in the "Command and Option Notes" section that reads
      --- begin quote ---
      Items in italics (option values) represent the actual values that must be supplied. For example, here is the format of the -printcert command:

      keytool -printcert {-file cert_file} {-v}
      --- end quote ---

      "cert_file" should be italicized.

      Then, as specified in this bullet entry, every command in the "Commands" section has a list of available options, some of which should be italicized. For example:

      --- begin ---
      -gencert
      {-rfc} {-infile infile} {-outfile outfile} {-alias alias} {-sigalg sigalg} {-dname dname} {-startdate startdate {-ext ext}* {-validity valDays} [-keypass keypass] {-keystore keystore} [-storepass storepass] {-storetype storetype} {-providername provider_name} {-providerClass provider_class_name {-providerArg provider_arg}} {-v} {-protected} {-Jjavaoption}
      --- begin ---

      The lists for every command are missing the proper italics.

      For reference, the documentation for JDK 7 seems correct:
      http://docs.oracle.com/javase/7/docs/technotes/tools/windows/keytool.html

        Attachments

          Activity

            People

            Assignee:
            shommel Scott Hommel (Inactive)
            Reporter:
            juh Jason Uh (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Dates

              Due:
              Created:
              Updated:
              Resolved: