This commit is contained in:
Daniel D. Daugherty 2022-07-20 22:56:17 +00:00
commit 9c19d89c9c
28 changed files with 489 additions and 77 deletions
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]);