Skip to content

Commit 622f72b

Browse files
committed
8255853: Update all nroff manpages for JDK 16 release
Reviewed-by: erikj
1 parent cdf9cd8 commit 622f72b

File tree

28 files changed

+309
-132
lines changed

28 files changed

+309
-132
lines changed

src/java.base/share/man/java.1

Lines changed: 12 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
.\"t
21
.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
32
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
43
.\"
@@ -8,7 +7,7 @@
87
.\"
98
.\" This code is distributed in the hope that it will be useful, but WITHOUT
109
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1211
.\" version 2 for more details (a copy is included in the LICENSE file that
1312
.\" accompanied this code).
1413
.\"
@@ -20,9 +19,10 @@
2019
.\" or visit www.oracle.com if you need additional information or have any
2120
.\" questions.
2221
.\"
22+
.\"t
2323
.\" Automatically generated by Pandoc 2.3.1
2424
.\"
25-
.TH "JAVA" "1" "2020" "JDK 15" "JDK Commands"
25+
.TH "JAVA" "1" "2020" "JDK 16" "JDK Commands"
2626
.hy
2727
.SH NAME
2828
.PP
@@ -181,7 +181,7 @@ with new values added and old values removed.
181181
You\[aq]ll get an error message if you use a value of \f[I]N\f[R] that is
182182
no longer supported.
183183
The supported values of \f[I]N\f[R] are the current Java SE release
184-
(\f[CB]15\f[R]) and a limited number of previous releases, detailed in the
184+
(\f[CB]16\f[R]) and a limited number of previous releases, detailed in the
185185
command\-line help for \f[CB]javac\f[R], under the \f[CB]\-\-source\f[R] and
186186
\f[CB]\-\-release\f[R] options.
187187
.RE
@@ -4089,14 +4089,6 @@ This option was deprecated in JDK 8 and superseded by the
40894089
\f[CB]\-XX:MetaspaceSize\f[R] option.
40904090
.RS
40914091
.RE
4092-
.TP
4093-
.B \f[CB]\-XX:+UseParallelOldGC\f[R]
4094-
Enables the use of the parallel garbage collector for full GCs.
4095-
By default, this option is disabled.
4096-
Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R]
4097-
option.
4098-
.RS
4099-
.RE
41004092
.SH REMOVED JAVA OPTIONS
41014093
.PP
41024094
These \f[CB]java\f[R] options have been removed in JDK 15 and using them
@@ -4106,28 +4098,20 @@ results in an error of:
41064098
\f[CB]Unrecognized\ VM\ option\f[R] \f[I]option\-name\f[R]
41074099
.RE
41084100
.TP
4109-
.B \f[CB]\-XX:+FailOverToOldVerifier\f[R]
4110-
Enables automatic failover to the old verifier when the new type checker
4111-
fails.
4112-
By default, this option is disabled and it\[aq]s ignored (that is,
4113-
treated as disabled) for classes with a recent bytecode version.
4114-
You can enable it only for classes with older versions of the bytecode.
4115-
.RS
4116-
.RE
4117-
.TP
4118-
.B \f[CB]\-XX:+UseConcMarkSweepGC\f[R]
4119-
Enables the use of the CMS garbage collector for the old generation.
4120-
CMS is an alternative to the default garbage collector (G1), which also
4121-
focuses on meeting application latency requirements.
4122-
By default, this option is disabled and the collector is selected
4123-
automatically based on the configuration of the machine and type of the
4124-
JVM.
4101+
.B \f[CB]\-XX:+UseParallelOldGC\f[R]
4102+
Enables the use of the parallel garbage collector for full GCs.
4103+
By default, this option is disabled.
4104+
Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R]
4105+
option.
41254106
.RS
41264107
.RE
41274108
.PP
41284109
For the lists and descriptions of options removed in previous releases
41294110
see the \f[I]Removed Java Options\f[R] section in:
41304111
.IP \[bu] 2
4112+
\f[B]Java Platform, Standard Edition Tools Reference, Release 15\f[R]
4113+
[https://docs.oracle.com/en/java/javase/15/docs/specs/man/java.html]
4114+
.IP \[bu] 2
41314115
\f[B]Java Platform, Standard Edition Tools Reference, Release 14\f[R]
41324116
[https://docs.oracle.com/en/java/javase/14/docs/specs/man/java.html]
41334117
.IP \[bu] 2

src/java.base/share/man/keytool.1

Lines changed: 118 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
.\"t
21
.\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
32
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
43
.\"
@@ -8,7 +7,7 @@
87
.\"
98
.\" This code is distributed in the hope that it will be useful, but WITHOUT
109
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1211
.\" version 2 for more details (a copy is included in the LICENSE file that
1312
.\" accompanied this code).
1413
.\"
@@ -20,9 +19,10 @@
2019
.\" or visit www.oracle.com if you need additional information or have any
2120
.\" questions.
2221
.\"
22+
.\"t
2323
.\" Automatically generated by Pandoc 2.3.1
2424
.\"
25-
.TH "KEYTOOL" "1" "2020" "JDK 15" "JDK Commands"
25+
.TH "KEYTOOL" "1" "2020" "JDK 16" "JDK Commands"
2626
.hy
2727
.SH NAME
2828
.PP
@@ -980,6 +980,28 @@ Sockets Layer (SSL) server host and port
980980
.IP \[bu] 2
981981
{\f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R]}: Signed \f[CB]\&.jar\f[R] file
982982
.IP \[bu] 2
983+
{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
984+
.IP \[bu] 2
985+
{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
986+
.IP \[bu] 2
987+
[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
988+
.IP \[bu] 2
989+
{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
990+
.IP \[bu] 2
991+
{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
992+
.IP \[bu] 2
993+
{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
994+
\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
995+
an optional configure argument.
996+
.IP \[bu] 2
997+
{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
998+
\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
999+
an optional configure argument.
1000+
.IP \[bu] 2
1001+
{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
1002+
.IP \[bu] 2
1003+
{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
1004+
.IP \[bu] 2
9831005
{\f[CB]\-v\f[R]}: Verbose output
9841006
.PP
9851007
Use the \f[CB]\-printcert\f[R] command to read and print the certificate
@@ -1012,7 +1034,11 @@ command line for proxy tunneling.
10121034
.PP
10131035
\f[B]Note:\f[R]
10141036
.PP
1015-
This option can be used independently of a keystore.
1037+
This command can be used independently of a keystore.
1038+
This command does not check for the weakness of a certificate\[aq]s
1039+
signature algorithm if it is a trusted certificate in the user keystore
1040+
(specified by \f[CB]\-keystore\f[R]) or in the \f[CB]cacerts\f[R] keystore
1041+
(if \f[CB]\-trustcacerts\f[R] is specified).
10161042
.RE
10171043
.TP
10181044
.B \f[CB]\-printcertreq\f[R]
@@ -1038,6 +1064,28 @@ command:
10381064
.IP \[bu] 2
10391065
{\f[CB]\-file\ crl\f[R]}: Input file name
10401066
.IP \[bu] 2
1067+
{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
1068+
.IP \[bu] 2
1069+
{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
1070+
.IP \[bu] 2
1071+
[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
1072+
.IP \[bu] 2
1073+
{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
1074+
.IP \[bu] 2
1075+
{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
1076+
.IP \[bu] 2
1077+
{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
1078+
\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
1079+
an optional configure argument.
1080+
.IP \[bu] 2
1081+
{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
1082+
\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
1083+
an optional configure argument.
1084+
.IP \[bu] 2
1085+
{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
1086+
.IP \[bu] 2
1087+
{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
1088+
.IP \[bu] 2
10411089
{\f[CB]\-v\f[R]}: Verbose output
10421090
.PP
10431091
Use the \f[CB]\-printcrl\f[R] command to read the Certificate Revocation
@@ -1048,7 +1096,11 @@ The CA generates the \f[CB]crl\f[R] file.
10481096
.PP
10491097
\f[B]Note:\f[R]
10501098
.PP
1051-
This option can be used independently of a keystore.
1099+
This command can be used independently of a keystore.
1100+
This command attempts to verify the CRL using a certificate from the
1101+
user keystore (specified by \f[CB]\-keystore\f[R]) or the \f[CB]cacerts\f[R]
1102+
keystore (if \f[CB]\-trustcacerts\f[R] is specified), and will print out a
1103+
warning if it cannot be verified.
10521104
.RE
10531105
.SH COMMANDS FOR MANAGING THE KEYSTORE
10541106
.TP
@@ -1479,9 +1531,9 @@ The following examples show the defaults for various option values:
14791531
\-alias\ "mykey"
14801532

14811533
\-keysize
1482-
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA")
1483-
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "DSA")
1534+
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA",\ "DSA",\ or\ "RSASSA\-PSS")
14841535
\ \ \ \ 256\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC")
1536+
\ \ \ \ 255\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EdDSA")
14851537
\ \ \ \ 56\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DES")
14861538
\ \ \ \ 168\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DESede")
14871539

@@ -1564,7 +1616,66 @@ T}@T{
15641616
T}@T{
15651617
SHA512withECDSA
15661618
T}
1619+
T{
1620+
RSASSA\-PSS
1621+
T}@T{
1622+
<= 3072
1623+
T}@T{
1624+
RSASSA\-PSS (with SHA\-256)
1625+
T}
1626+
T{
1627+
T}@T{
1628+
<= 7680
1629+
T}@T{
1630+
RSASSA\-PSS (with SHA\-384)
1631+
T}
1632+
T{
1633+
T}@T{
1634+
> 7680
1635+
T}@T{
1636+
RSASSA\-PSS (with SHA\-512)
1637+
T}
1638+
T{
1639+
EdDSA
1640+
T}@T{
1641+
255
1642+
T}@T{
1643+
Ed25519
1644+
T}
1645+
T{
1646+
T}@T{
1647+
448
1648+
T}@T{
1649+
Ed448
1650+
T}
1651+
T{
1652+
Ed25519
1653+
T}@T{
1654+
255
1655+
T}@T{
1656+
Ed25519
1657+
T}
1658+
T{
1659+
Ed448
1660+
T}@T{
1661+
448
1662+
T}@T{
1663+
Ed448
1664+
T}
15671665
.TE
1666+
.IP \[bu] 2
1667+
An RSASSA\-PSS signature algorithm uses a \f[CB]MessageDigest\f[R]
1668+
algorithm as its hash and MGF1 algorithms.
1669+
.IP \[bu] 2
1670+
EdDSA supports 2 key sizes: Ed25519 and Ed448.
1671+
When generating an EdDSA key pair using \f[CB]\-keyalg\ EdDSA\f[R], a user
1672+
can specify \f[CB]\-keysize\ 255\f[R] or \f[CB]\-keysize\ 448\f[R] to
1673+
generate Ed25519 or Ed448 key pairs.
1674+
When no \f[CB]\-keysize\f[R] is specified, an Ed25519 key pair is
1675+
generated.
1676+
A user can also directly specify \f[CB]\-keyalg\ Ed25519\f[R] or
1677+
\f[CB]\-keyalg\ Ed448\f[R] to generate a key pair with the expected key
1678+
size.
15681679
.PP
15691680
\f[B]Note:\f[R]
15701681
.PP

src/java.rmi/share/man/rmid.1

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
.\"
88
.\" This code is distributed in the hope that it will be useful, but WITHOUT
99
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1111
.\" version 2 for more details (a copy is included in the LICENSE file that
1212
.\" accompanied this code).
1313
.\"
@@ -21,7 +21,7 @@
2121
.\"
2222
.\" Automatically generated by Pandoc 2.3.1
2323
.\"
24-
.TH "RMID" "1" "2020" "JDK 15" "JDK Commands"
24+
.TH "RMID" "1" "2020" "JDK 16" "JDK Commands"
2525
.hy
2626
.SH NAME
2727
.PP

src/java.rmi/share/man/rmiregistry.1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved.
1+
.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
22
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
33
.\"
44
.\" This code is free software; you can redistribute it and/or modify it
@@ -7,7 +7,7 @@
77
.\"
88
.\" This code is distributed in the hope that it will be useful, but WITHOUT
99
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1111
.\" version 2 for more details (a copy is included in the LICENSE file that
1212
.\" accompanied this code).
1313
.\"
@@ -21,7 +21,7 @@
2121
.\"
2222
.\" Automatically generated by Pandoc 2.3.1
2323
.\"
24-
.TH "RMIREGISTRY" "1" "2020" "JDK 15" "JDK Commands"
24+
.TH "RMIREGISTRY" "1" "2020" "JDK 16" "JDK Commands"
2525
.hy
2626
.SH NAME
2727
.PP

src/java.scripting/share/man/jrunscript.1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" Copyright (c) 2006, 2020, Oracle and/or its affiliates. All rights reserved.
1+
.\" Copyright (c) 2006, 2018, Oracle and/or its affiliates. All rights reserved.
22
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
33
.\"
44
.\" This code is free software; you can redistribute it and/or modify it
@@ -7,7 +7,7 @@
77
.\"
88
.\" This code is distributed in the hope that it will be useful, but WITHOUT
99
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1111
.\" version 2 for more details (a copy is included in the LICENSE file that
1212
.\" accompanied this code).
1313
.\"
@@ -21,7 +21,7 @@
2121
.\"
2222
.\" Automatically generated by Pandoc 2.3.1
2323
.\"
24-
.TH "JRUNSCRIPT" "1" "2020" "JDK 15" "JDK Commands"
24+
.TH "JRUNSCRIPT" "1" "2020" "JDK 16" "JDK Commands"
2525
.hy
2626
.SH NAME
2727
.PP

src/jdk.compiler/share/man/javac.1

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
.\"
88
.\" This code is distributed in the hope that it will be useful, but WITHOUT
99
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1111
.\" version 2 for more details (a copy is included in the LICENSE file that
1212
.\" accompanied this code).
1313
.\"
@@ -21,7 +21,7 @@
2121
.\"
2222
.\" Automatically generated by Pandoc 2.3.1
2323
.\"
24-
.TH "JAVAC" "1" "2020" "JDK 15" "JDK Commands"
24+
.TH "JAVAC" "1" "2020" "JDK 16" "JDK Commands"
2525
.hy
2626
.SH NAME
2727
.PP

src/jdk.compiler/share/man/serialver.1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved.
1+
.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
22
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
33
.\"
44
.\" This code is free software; you can redistribute it and/or modify it
@@ -7,7 +7,7 @@
77
.\"
88
.\" This code is distributed in the hope that it will be useful, but WITHOUT
99
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10-
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
10+
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1111
.\" version 2 for more details (a copy is included in the LICENSE file that
1212
.\" accompanied this code).
1313
.\"
@@ -21,7 +21,7 @@
2121
.\"
2222
.\" Automatically generated by Pandoc 2.3.1
2323
.\"
24-
.TH "SERIALVER" "1" "2020" "JDK 15" "JDK Commands"
24+
.TH "SERIALVER" "1" "2020" "JDK 16" "JDK Commands"
2525
.hy
2626
.SH NAME
2727
.PP

0 commit comments

Comments
 (0)