-
Bug
-
Resolution: Fixed
-
P4
-
8
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
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