Merge
This commit is contained in:
commit
9c19d89c9c
src
java.base/share/man
java.rmi/share/man
java.scripting/share/man
jdk.compiler/share/man
jdk.hotspot.agent/share/man
jdk.httpserver/share/man
jdk.jartool/share/man
jdk.javadoc/share/man
jdk.jcmd/share/man
jdk.jconsole/share/man
jdk.jdeps/share/man
jdk.jdi/share/man
jdk.jfr/share/man
jdk.jlink/share/man
jdk.jpackage/share/man
jdk.jshell/share/man
jdk.jstatd/share/man
test/langtools/jdk/javadoc/tool
@ -22,7 +22,7 @@
|
||||
.\"t
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "KEYTOOL" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "KEYTOOL" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -433,7 +433,7 @@ single\-element certificate chain.
|
||||
When the \f[CB]\-signer\f[R] option is specified, a new certificate is
|
||||
generated and signed by the designated signer and stored as a
|
||||
multiple\-element certificate chain (containing the generated
|
||||
certificate itself, and the signer???s certificate chain).
|
||||
certificate itself, and the signer?s certificate chain).
|
||||
The certificate chain and private key are stored in a new keystore entry
|
||||
that is identified by its alias.
|
||||
.PP
|
||||
@ -453,7 +453,7 @@ specified.
|
||||
The \f[CB]\-signer\f[R] value specifies the alias of a
|
||||
\f[CB]PrivateKeyEntry\f[R] for the signer that already exists in the
|
||||
keystore.
|
||||
This option is used to sign the certificate with the signer???s private
|
||||
This option is used to sign the certificate with the signer?s private
|
||||
key.
|
||||
This is especially useful for key agreement algorithms (i.e.
|
||||
the \f[CB]\-keyalg\f[R] value is \f[CB]XDH\f[R], \f[CB]X25519\f[R],
|
||||
@ -461,7 +461,7 @@ the \f[CB]\-keyalg\f[R] value is \f[CB]XDH\f[R], \f[CB]X25519\f[R],
|
||||
signatures, and therefore a self\-signed certificate cannot be created.
|
||||
.PP
|
||||
The \f[CB]\-signerkeypass\f[R] value specifies the password of the
|
||||
signer???s private key.
|
||||
signer?s private key.
|
||||
It can be specified if the private key of the signer entry is protected
|
||||
by a password different from the store password.
|
||||
.PP
|
||||
@ -1571,8 +1571,9 @@ The following examples show the defaults for various option values:
|
||||
\-alias\ "mykey"
|
||||
|
||||
\-keysize
|
||||
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA",\ "DSA",\ "RSASSA\-PSS",\ or\ "DH")
|
||||
\ \ \ \ 256\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC")
|
||||
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "DSA")
|
||||
\ \ \ \ 3072\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA",\ "RSASSA\-PSS",\ or\ "DH")
|
||||
\ \ \ \ 384\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC")
|
||||
\ \ \ \ 255\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EdDSA",\ or\ "XDH)
|
||||
\ \ \ \ 56\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DES")
|
||||
\ \ \ \ 168\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DESede")
|
||||
@ -1600,6 +1601,7 @@ signature algorithm (\f[CB]\-sigalg\f[R] option) is derived from the
|
||||
algorithm of the underlying private key to provide an appropriate level
|
||||
of security strength as follows:
|
||||
.PP
|
||||
Default Signature Algorithms
|
||||
.TS
|
||||
tab(@);
|
||||
l l l.
|
||||
@ -1621,9 +1623,9 @@ T}
|
||||
T{
|
||||
RSA
|
||||
T}@T{
|
||||
<= 3072
|
||||
< 624
|
||||
T}@T{
|
||||
SHA256withRSA
|
||||
SHA256withRSA (keysize is too small for using SHA\-384)
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
@ -1640,28 +1642,27 @@ T}
|
||||
T{
|
||||
EC
|
||||
T}@T{
|
||||
< 384
|
||||
T}@T{
|
||||
SHA256withECDSA
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
< 512
|
||||
T}@T{
|
||||
SHA384withECDSA
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
= 512
|
||||
>= 512
|
||||
T}@T{
|
||||
SHA512withECDSA
|
||||
T}
|
||||
T{
|
||||
RSASSA\-PSS
|
||||
T}@T{
|
||||
<= 3072
|
||||
< 624
|
||||
T}@T{
|
||||
RSASSA\-PSS (with SHA\-256)
|
||||
RSASSA\-PSS (with SHA\-256, keysize is too small for
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
T}@T{
|
||||
using SHA\-384)
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
@ -1946,9 +1947,9 @@ distinguished name is \f[CB]myname\f[R], \f[CB]mygroup\f[R],
|
||||
\f[CB]mycompany\f[R], and a two\-letter country code of
|
||||
\f[CB]mycountry\f[R].
|
||||
It uses the RSA key generation algorithm to create the keys; both are
|
||||
2048 bits
|
||||
3072 bits.
|
||||
.PP
|
||||
The command uses the default SHA256withRSA signature algorithm to create
|
||||
The command uses the default SHA384withRSA signature algorithm to create
|
||||
a self\-signed certificate that includes the public key and the
|
||||
distinguished name information.
|
||||
The certificate is valid for 180 days, and is associated with the
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "RMIREGISTRY" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "RMIREGISTRY" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JRUNSCRIPT" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JRUNSCRIPT" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JAVAC" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JAVAC" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "SERIALVER" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "SERIALVER" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JHSDB" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JHSDB" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JWEBSERVER" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JWEBSERVER" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -1,4 +1,4 @@
|
||||
.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Copyright (c) 1997, 2021, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
.\"
|
||||
.\" This code is free software; you can redistribute it and/or modify it
|
||||
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JAR" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JAR" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -211,6 +211,13 @@ You can use the following options to customize the actions of the create
|
||||
Stores without using ZIP compression.
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-date=\f[R]\f[I]TIMESTAMP\f[R]
|
||||
The timestamp in ISO\-8601 extended offset date\-time with optional
|
||||
time\-zone format, to use for the timestamp of the entries, e.g.
|
||||
"2022\-02\-12T12:30:00\-05:00".
|
||||
.RS
|
||||
.RE
|
||||
.SH OTHER OPTIONS
|
||||
.PP
|
||||
The following options are recognized by the \f[CB]jar\f[R] command and not
|
||||
@ -242,6 +249,16 @@ Create an archive, \f[CB]classes.jar\f[R], that contains two class files,
|
||||
.RE
|
||||
.RE
|
||||
.IP \[bu] 2
|
||||
Create an archive, \f[CB]classes.jar\f[R], that contains two class files,
|
||||
\f[CB]Foo.class\f[R] and \f[CB]Bar.class\f[R] setting the last modified date
|
||||
and time to \f[CB]2021\ Jan\ 6\ 12:36:00\f[R].
|
||||
.RS 2
|
||||
.RS
|
||||
.PP
|
||||
\f[CB]jar\ \-\-create\ \-\-date="2021\-01\-06T14:36:00+02:00"\ \-\-file=classes.jar\ Foo.class\ Bar.class\f[R]
|
||||
.RE
|
||||
.RE
|
||||
.IP \[bu] 2
|
||||
Create an archive, \f[CB]classes.jar\f[R], by using an existing manifest,
|
||||
\f[CB]mymanifest\f[R], that contains all of the files in the directory
|
||||
\f[CB]foo/\f[R].
|
||||
|
@ -22,7 +22,7 @@
|
||||
.\"t
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JARSIGNER" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JARSIGNER" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -301,6 +301,7 @@ By default, the \f[CB]jarsigner\f[R] command signs a JAR file using one of
|
||||
the following algorithms and block file extensions depending on the type
|
||||
and size of the private key:
|
||||
.PP
|
||||
Default Signature Algorithms and Block File Extensions
|
||||
.TS
|
||||
tab(@);
|
||||
l l l l.
|
||||
@ -326,7 +327,7 @@ T}
|
||||
T{
|
||||
RSA
|
||||
T}@T{
|
||||
<= 3072
|
||||
< 624
|
||||
T}@T{
|
||||
SHA256withRSA
|
||||
T}@T{
|
||||
@ -349,22 +350,15 @@ T}
|
||||
T{
|
||||
EC
|
||||
T}@T{
|
||||
< 384
|
||||
< 512
|
||||
T}@T{
|
||||
SHA256withECDSA
|
||||
SHA384withECDSA
|
||||
T}@T{
|
||||
\&.EC
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
< 512
|
||||
T}@T{
|
||||
SHA384withECDSA
|
||||
T}@T{
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
= 512
|
||||
>= 512
|
||||
T}@T{
|
||||
SHA512withECDSA
|
||||
T}@T{
|
||||
@ -372,7 +366,7 @@ T}
|
||||
T{
|
||||
RSASSA\-PSS
|
||||
T}@T{
|
||||
<= 3072
|
||||
< 624
|
||||
T}@T{
|
||||
RSASSA\-PSS (with SHA\-256)
|
||||
T}@T{
|
||||
@ -415,7 +409,7 @@ use the same parameters in the signature.
|
||||
Otherwise, jarsigner will use parameters that are determined by the size
|
||||
of the key as specified in the table above.
|
||||
For example, an 3072\-bit RSASSA\-PSS key will use RSASSA\-PSS as the
|
||||
signature algorithm and SHA\-256 as the hash and MGF1 algorithms.
|
||||
signature algorithm and SHA\-384 as the hash and MGF1 algorithms.
|
||||
.PP
|
||||
These default signature algorithms can be overridden by using the
|
||||
\f[CB]\-sigalg\f[R] option.
|
||||
@ -766,7 +760,7 @@ The file can be a sequence of concatenated X.509 certificates, or a
|
||||
single PKCS#7 formatted data block, either in binary encoding format or
|
||||
in printable encoding format (also known as Base64 encoding) as defined
|
||||
by \f[B]Internet RFC 1421 Certificate Encoding Standard\f[R]
|
||||
[https://tools.ietf.org/html/rfc1421].
|
||||
[http://tools.ietf.org/html/rfc1421].
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
@ -809,7 +803,7 @@ the entries of a JAR file.
|
||||
For a list of standard message digest algorithm names, see Java Security
|
||||
Standard Algorithm Names.
|
||||
.PP
|
||||
If this option isn\[aq]t specified, then \f[CB]SHA256\f[R] is used.
|
||||
If this option isn\[aq]t specified, then \f[CB]SHA\-384\f[R] is used.
|
||||
There must either be a statically installed provider supplying an
|
||||
implementation of the specified algorithm or the user must specify one
|
||||
with the \f[CB]\-addprovider\f[R] or \f[CB]\-providerClass\f[R] options;
|
||||
@ -946,7 +940,7 @@ digits like \f[CB]1.2.3.4\f[R], for example.
|
||||
.B \f[CB]\-tsadigestalg\f[R] \f[I]algorithm\f[R]
|
||||
Specifies the message digest algorithm that is used to generate the
|
||||
message imprint to be sent to the TSA server.
|
||||
If this option isn\[aq]t specified, SHA\-256 will be used.
|
||||
If this option isn\[aq]t specified, SHA\-384 will be used.
|
||||
.RS
|
||||
.PP
|
||||
See \f[B]Supported Algorithms\f[R].
|
||||
@ -1058,6 +1052,14 @@ The preferred way to load PKCS11 is by using modules.
|
||||
See \f[CB]\-addprovider\f[R].
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-providerPath\f[R] \f[I]classpath\f[R]
|
||||
Used to specify the classpath for providers specified by the
|
||||
\f[CB]\-providerClass\f[R] option.
|
||||
Multiple paths should be separated by the system\-dependent
|
||||
path\-separator character.
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-J\f[R]\f[I]javaoption\f[R]
|
||||
Passes through the specified \f[I]javaoption\f[R] string directly to the
|
||||
Java interpreter.
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JAVADOC" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JAVADOC" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -1055,6 +1055,7 @@ The hierarchy is produced by default.
|
||||
.TP
|
||||
.B \f[CB]\-\-override\-methods\f[R] (\f[CB]detail\f[R]|\f[CB]summary\f[R])
|
||||
Documents overridden methods in the detail or summary sections.
|
||||
The default is \f[CB]detail\f[R].
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
@ -1270,6 +1271,28 @@ are subject to change without notice.
|
||||
Additional options are less commonly used or are otherwise regarded as
|
||||
advanced.
|
||||
.TP
|
||||
.B \f[CB]\-\-date\f[R] \f[I]date\-and\-time\f[R]
|
||||
Specifies the value to be used to timestamp the generated pages, in
|
||||
\f[B]ISO 8601\f[R]
|
||||
[https://www.iso.org/iso\-8601\-date\-and\-time\-format.html] format.
|
||||
The specified value must be within 10 years of the current date and
|
||||
time.
|
||||
It is an error to specify both \f[CB]\-notimestamp\f[R] and
|
||||
\f[CB]\-\-date\f[R].
|
||||
Using a specific value means the generated documentation can be part of
|
||||
a \f[B]reproducible build\f[R] [https://reproducible\-builds.org/].
|
||||
If the option is not given, the default value is the current date and
|
||||
time.
|
||||
For example:
|
||||
.RS
|
||||
.IP
|
||||
.nf
|
||||
\f[CB]
|
||||
javadoc\ \-\-date\ 2022\-02\-01T17:41:59\-08:00\ mypackage
|
||||
\f[R]
|
||||
.fi
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-legal\-notices\f[R] (\f[CB]default\f[R]|\f[CB]none\f[R]|\f[I]directory\f[R])
|
||||
Specifies the location from which to copy legal files to the generated
|
||||
documentation.
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JCMD" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JCMD" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JINFO" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JINFO" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JMAP" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JMAP" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JPS" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JPS" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JSTACK" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JSTACK" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JSTAT" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JSTAT" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JCONSOLE" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JCONSOLE" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JAVAP" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JAVAP" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JDEPRSCAN" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JDEPRSCAN" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JDEPS" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JDEPS" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JDB" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JDB" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JFR" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JFR" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JLINK" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JLINK" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -1,4 +1,4 @@
|
||||
.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Copyright (c) 2017, 2021, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
.\"
|
||||
.\" This code is free software; you can redistribute it and/or modify it
|
||||
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JMOD" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JMOD" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -124,6 +124,13 @@ into the resulting JMOD file.
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-date\f[R]\f[I]TIMESTAMP\f[R]
|
||||
The timestamp in ISO\-8601 extended offset date\-time with optional
|
||||
time\-zone format, to use for the timestamp of the entries, e.g.
|
||||
"2022\-02\-12T12:30:00\-05:00".
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-dir\f[R] \f[I]path\f[R]
|
||||
Specifies the location where \f[CB]jmod\f[R] puts extracted files from the
|
||||
specified JMOD archive.
|
||||
@ -278,6 +285,16 @@ jmod\ create\ \-\-class\-path\ mods/com.greetings\ \-\-cmds\ commands
|
||||
\ \ \-\-os\-version\ "10.10.5"\ greetingsmod
|
||||
\f[R]
|
||||
.fi
|
||||
.PP
|
||||
Create a JMOD file specifying the date for the entries as
|
||||
\f[CB]2022\ March\ 15\ 00:00:00\f[R]:
|
||||
.IP
|
||||
.nf
|
||||
\f[CB]
|
||||
jmod\ create\ \-\-class\-path\ build/foo/classes\ \-\-date\ 2022\-03\-15T00:00:00Z
|
||||
\ \ \ jmods/foo1.jmod
|
||||
\f[R]
|
||||
.fi
|
||||
.SH JMOD HASH EXAMPLE
|
||||
.PP
|
||||
The following example demonstrates what happens when you try to link a
|
||||
|
@ -1,4 +1,4 @@
|
||||
.\" Copyright (c) 2018, 2021, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Copyright (c) 2018, 2022, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
.\"
|
||||
.\" This code is free software; you can redistribute it and/or modify it
|
||||
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JPACKAGE" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JPACKAGE" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -209,10 +209,10 @@ of key, value pairs
|
||||
.PP
|
||||
(absolute path or relative to the current directory)
|
||||
.PP
|
||||
The keys "module", "main\-jar", "main\-class", "arguments",
|
||||
"java\-options", "app\-version", "icon", "win\-console",
|
||||
"win\-shortcut", "win\-menu", "linux\-app\-category", and
|
||||
"linux\-shortcut", can be used.
|
||||
The keys "module", "main\-jar", "main\-class", "description",
|
||||
"arguments", "java\-options", "app\-version", "icon",
|
||||
"launcher\-as\-service", "win\-console", "win\-shortcut", "win\-menu",
|
||||
"linux\-app\-category", and "linux\-shortcut" can be used.
|
||||
.PP
|
||||
These options are added to, or used to overwrite, the original command
|
||||
line options to build an additional alternative launcher.
|
||||
@ -277,7 +277,7 @@ application which requires console interactions
|
||||
An identifier that uniquely identifies the application for macOS
|
||||
.RS
|
||||
.PP
|
||||
Defaults to the the main class name.
|
||||
Defaults to the main class name.
|
||||
.PP
|
||||
May only use alphanumeric (A\-Z,a\-z,0\-9), hyphen (\-), and period (.)
|
||||
characters.
|
||||
@ -302,7 +302,7 @@ package identifier.
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-mac\-sign\f[R]
|
||||
Request that the bundle be signed.
|
||||
Request that the package or the predefined application image be signed.
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
@ -344,12 +344,10 @@ URL of the application\[aq]s home page
|
||||
.TP
|
||||
.B \f[CB]\-\-app\-image\f[R] \f[I]directory\f[R]
|
||||
Location of the predefined application image that is used to build an
|
||||
installable package
|
||||
installable package (on all platforms) or to be signed (on macOS)
|
||||
.RS
|
||||
.PP
|
||||
(absolute path or relative to the current directory)
|
||||
.PP
|
||||
See create\-app\-image mode options to create the application image.
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-file\-associations\f[R] \f[I]path\f[R]
|
||||
@ -365,7 +363,7 @@ This option can be used multiple times.
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-install\-dir\f[R] \f[I]path\f[R]
|
||||
Absolute path of the installation directory of the application (on macos
|
||||
Absolute path of the installation directory of the application (on macOS
|
||||
or linux), or relative sub\-path of the installation directory such as
|
||||
"Program Files" or "AppData" (on Windows)
|
||||
.RS
|
||||
@ -396,6 +394,12 @@ Path of the predefined runtime image to install
|
||||
.PP
|
||||
Option is required when creating a runtime installer.
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]\-\-launcher\-as\-service\f[R]
|
||||
Request to create an installer that will register the main application
|
||||
launcher as a background service\-type application.
|
||||
.RS
|
||||
.RE
|
||||
.SS Platform dependent options for creating the application package:
|
||||
.SS Windows platform options (available only when running on Windows):
|
||||
.TP
|
||||
@ -551,3 +555,350 @@ Generate\ a\ Java\ runtime\ package:
|
||||
jpackage\ \-n\ name\ \-\-runtime\-image\ <runtime\-image>
|
||||
\f[R]
|
||||
.fi
|
||||
.IP
|
||||
.nf
|
||||
\f[CB]
|
||||
Sign\ the\ predefined\ application\ image\ (on\ macOS):
|
||||
\f[R]
|
||||
.fi
|
||||
.IP
|
||||
.nf
|
||||
\f[CB]
|
||||
jpackage\ \-\-type\ app\-image\ \-\-app\-image\ <app\-image>\ \\
|
||||
\ \ \ \ \-\-mac\-sign\ [<additional\ signing\ options>...]
|
||||
|
||||
Note:\ the\ only\ additional\ options\ that\ are\ permitted\ in\ this\ mode\ are:
|
||||
\ \ \ \ \ \ the\ set\ of\ additional\ mac\ signing\ options\ and\ \-\-verbose
|
||||
\f[R]
|
||||
.fi
|
||||
.SH JPACKAGE RESOURCE DIRECTORY
|
||||
.PP
|
||||
Icons, template files, and other resources of jpackage can be
|
||||
over\-ridden by adding replacement resources to this directory.
|
||||
jpackage will lookup files by specific names in the resource directory.
|
||||
.SS Resource directory files considered only when running on Linux:
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>.png\f[R]
|
||||
Application launcher icon
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]JavaApp.png\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>.desktop\f[R]
|
||||
A desktop file to be used with \f[CB]xdg\-desktop\-menu\f[R] command
|
||||
.RS
|
||||
.PP
|
||||
Considered with application launchers registered for file associations
|
||||
and/or have an icon
|
||||
.PP
|
||||
Default resource is \f[I]template.desktop\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when building Linux DEB/RPM
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-<launcher\-name>.service\f[R]
|
||||
systemd unit file for application launcher registered as a background
|
||||
service\-type application
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]unit\-template.service\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when building Linux RPM
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]<package\-name>.spec\f[R]
|
||||
RPM spec file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.spec\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when building Linux DEB
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]control\f[R]
|
||||
Control file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.control\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]copyright\f[R]
|
||||
Copyright file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.copyright\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]preinstall\f[R]
|
||||
Pre\-install shell script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.preinstall\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]prerm\f[R]
|
||||
Pre\-remove shell script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.prerm\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]postinstall\f[R]
|
||||
Post\-install shell script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.postinstall\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]postrm\f[R]
|
||||
Post\-remove shell script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]template.postrm\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when running on Windows:
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>.ico\f[R]
|
||||
Application launcher icon
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]JavaApp.ico\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>.properties\f[R]
|
||||
Properties file for application launcher executable
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]WinLauncher.template\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when building Windows
|
||||
MSI/EXE installer:
|
||||
.TP
|
||||
.B \f[CB]<application\-name>\-post\-image.wsf\f[R]
|
||||
A Windows Script File (WSF) to run after building application image
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]main.wxs\f[R]
|
||||
Main WiX project file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]main.wxs\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]overrides.wxi\f[R]
|
||||
Overrides WiX project file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]overrides.wxi\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]service\-installer.exe\f[R]
|
||||
Service installer executable
|
||||
.RS
|
||||
.PP
|
||||
Considered if some application launchers are registered as background
|
||||
service\-type applications
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>\-service\-install.wxi\f[R]
|
||||
Service installer WiX project file
|
||||
.RS
|
||||
.PP
|
||||
Considered if some application launchers are registered as background
|
||||
service\-type applications
|
||||
.PP
|
||||
Default resource is \f[I]service\-install.wxi\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>\-service\-config.wxi\f[R]
|
||||
Service installer WiX project file
|
||||
.RS
|
||||
.PP
|
||||
Considered if some application launchers are registered as background
|
||||
service\-type applications
|
||||
.PP
|
||||
Default resource is \f[I]service\-config.wxi\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]InstallDirNotEmptyDlg.wxs\f[R]
|
||||
WiX project file for installer UI dialog checking installation directory
|
||||
doesn\[aq]t exist or is empty
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]InstallDirNotEmptyDlg.wxs\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]ShortcutPromptDlg.wxs\f[R]
|
||||
WiX project file for installer UI dialog configuring shortcuts
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]ShortcutPromptDlg.wxs\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]bundle.wxf\f[R]
|
||||
WiX project file with the hierarchy of components of application image
|
||||
.RS
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]ui.wxf\f[R]
|
||||
WiX project file for installer UI
|
||||
.RS
|
||||
.RE
|
||||
.SS Resource directory files considered only when building Windows EXE
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]WinInstaller.properties\f[R]
|
||||
Properties file for the installer executable
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]WinInstaller.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-post\-msi.wsf\f[R]
|
||||
A Windows Script File (WSF) to run after building embedded MSI installer
|
||||
for EXE installer
|
||||
.RS
|
||||
.RE
|
||||
.SS Resource directory files considered only when running on macOS:
|
||||
.TP
|
||||
.B \f[CB]<launcher\-name>.icns\f[R]
|
||||
Application launcher icon
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]JavaApp.icns\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]Info.plist\f[R]
|
||||
Application property list file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]Info\-lite.plist.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]Runtime\-Info.plist\f[R]
|
||||
Java Runtime property list file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]Runtime\-Info.plist.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<application\-name>.entitlements\f[R]
|
||||
Signing entitlements property list file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]sandbox.plist\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when building macOS PKG/DMG
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-post\-image.sh\f[R]
|
||||
Shell script to run after building application image
|
||||
.RS
|
||||
.RE
|
||||
.SS Resource directory files considered only when building macOS PKG
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]uninstaller\f[R]
|
||||
Uninstaller shell script
|
||||
.RS
|
||||
.PP
|
||||
Considered if some application launchers are registered as background
|
||||
service\-type applications
|
||||
.PP
|
||||
Default resource is \f[I]uninstall.command.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]preinstall\f[R]
|
||||
Pre\-install shell script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]preinstall.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]postinstall\f[R]
|
||||
Post\-install shell script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]postinstall.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]services\-preinstall\f[R]
|
||||
Pre\-install shell script for services package
|
||||
.RS
|
||||
.PP
|
||||
Considered if some application launchers are registered as background
|
||||
service\-type applications
|
||||
.PP
|
||||
Default resource is \f[I]services\-preinstall.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]services\-postinstall\f[R]
|
||||
Post\-install shell script for services package
|
||||
.RS
|
||||
.PP
|
||||
Considered if some application launchers are registered as background
|
||||
service\-type applications
|
||||
.PP
|
||||
Default resource is \f[I]services\-postinstall.template\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-background.png\f[R]
|
||||
Background image
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]background_pkg.png\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-background\-darkAqua.png\f[R]
|
||||
Dark background image
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]background_pkg.png\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]product\-def.plist\f[R]
|
||||
Package property list file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]product\-def.plist\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-<launcher\-name>.plist\f[R]
|
||||
launchd property list file for application launcher registered as a
|
||||
background service\-type application
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]launchd.plist.template\f[R]
|
||||
.RE
|
||||
.SS Resource directory files considered only when building macOS DMG
|
||||
installer:
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-dmg\-setup.scpt\f[R]
|
||||
Setup AppleScript script
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]DMGsetup.scpt\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-license.plist\f[R]
|
||||
License property list file
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]lic_template.plist\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-background.tiff\f[R]
|
||||
Background image
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]background_dmg.tiff\f[R]
|
||||
.RE
|
||||
.TP
|
||||
.B \f[CB]<package\-name>\-volume.icns\f[R]
|
||||
Volume icon
|
||||
.RS
|
||||
.PP
|
||||
Default resource is \f[I]JavaApp.icns\f[R]
|
||||
.RE
|
||||
|
@ -22,7 +22,7 @@
|
||||
.\"t
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JSHELL" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JSHELL" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@ -1135,6 +1135,7 @@ The Ctrl key and Meta key are used in key combinations.
|
||||
If your keyboard doesn\[aq]t have a Meta key, then the Alt key is often
|
||||
mapped to provide Meta key functionality.
|
||||
.PP
|
||||
Line Editing Shortcuts
|
||||
.TS
|
||||
tab(@);
|
||||
l l.
|
||||
@ -1155,9 +1156,9 @@ T}@T{
|
||||
Move the cursor to the left one character.
|
||||
T}
|
||||
T{
|
||||
Right arrow
|
||||
Right arrow Move
|
||||
T}@T{
|
||||
Move the cursor to the right one character.
|
||||
the cursor to the right one character.
|
||||
T}
|
||||
T{
|
||||
Ctrl+A
|
||||
|
@ -21,7 +21,7 @@
|
||||
.\"
|
||||
.\" Automatically generated by Pandoc 2.3.1
|
||||
.\"
|
||||
.TH "JSTATD" "1" "2022" "JDK 19\-ea" "JDK Commands"
|
||||
.TH "JSTATD" "1" "2022" "JDK 19" "JDK Commands"
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
|
@ -66,7 +66,7 @@ public class CheckManPageOptions {
|
||||
|
||||
static final PrintStream out = System.err;
|
||||
|
||||
List<String> MISSING_IN_MAN_PAGE = List.of("--date");
|
||||
List<String> MISSING_IN_MAN_PAGE = List.of();
|
||||
|
||||
void run(String... args) throws Exception {
|
||||
var file = args.length == 0 ? findDefaultFile() : Path.of(args[0]);
|
||||
|
Loading…
x
Reference in New Issue
Block a user