--- old/src/java.base/share/man/java.1 2020-01-14 13:13:47.806976799 -0800 +++ new/src/java.base/share/man/java.1 2020-01-14 13:13:47.494963040 -0800 @@ -8,7 +8,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -22,7 +22,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JAVA" "1" "2019" "JDK 13" "JDK Commands" +.TH "JAVA" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -181,8 +181,8 @@ You\[aq]ll get an error message if you use a value of \f[I]N\f[R] that is no longer supported. Supported values of \f[I]N\f[R] for this release are \f[CB]7\f[R], -\f[CB]8\f[R], \f[CB]9\f[R], \f[CB]10\f[R], \f[CB]11\f[R], \f[CB]12\f[R], and -\f[CB]13\f[R]. +\f[CB]8\f[R], \f[CB]9\f[R], \f[CB]10\f[R], \f[CB]11\f[R], \f[CB]12\f[R], +\f[CB]13\f[R], and \f[CB]14\f[R]. .RE .PP If the file does not have the \f[CB]\&.java\f[R] extension, the @@ -267,7 +267,7 @@ of which is taken as the class to be executed. .IP \[bu] 2 The compiler does not enforce the optional restriction defined at the -end of JLS §7.6, that a type in a named package should exist in a file +end of JLS ??7.6, that a type in a named package should exist in a file whose name is composed from the type name followed by the \f[CB]\&.java\f[R] extension. .IP \[bu] 2 @@ -315,7 +315,7 @@ same manner as that specified in the command line. .PP Single (\f[CB]\[aq]\f[R]) or double (\f[CB]"\f[R]) quotes can be used to -enclose arguments that\ contain whitespace characters. +enclose arguments that contain whitespace characters. All content between the open quote and the first matching close quote are preserved by simply removing the pair of quotes. In case a matching quote is not found, the launcher will abort with an @@ -802,20 +802,6 @@ .RS .RE .TP -.B \f[CB]\-Xcomp\f[R] -Forces compilation of methods on first invocation. -By default, the Client VM (\f[CB]\-client\f[R]) performs 1,000 interpreted -method invocations and the Server VM (\f[CB]\-server\f[R]) performs 10,000 -interpreted method invocations to gather information for efficient -compilation. -Specifying the \f[CB]\-Xcomp\f[R] option disables interpreted method -invocations to increase compilation performance at the expense of -efficiency. -You can also change the number of interpreted method invocations before -compilation using the \f[CB]\-XX:CompileThreshold\f[R] option. -.RS -.RE -.TP .B \f[CB]\-Xdebug\f[R] Does nothing. Provided for backward compatibility. @@ -852,6 +838,8 @@ .B \f[CB]\-Xmixed\f[R] Executes all bytecode by the interpreter except for hot methods, which are compiled to native code. +On by default. +Use \f[CB]\-Xint\f[R] to switch off. .RS .RE .TP @@ -1643,7 +1631,7 @@ (\f[CB]\-XX:\-PreserveFramePointer\f[R]) and using the RBP register to hold the frame pointer of the currently executing method (\f[CB]\-XX:+PreserveFramePointer\f[R] . -If the frame pointer is available, then external profiling tools\ (for +If the frame pointer is available, then external profiling tools (for example, Linux perf) can construct more accurate stack traces. .RS .RE @@ -1694,6 +1682,19 @@ See \f[B]Application Class Data Sharing\f[R]. .RE .TP +.B \f[CB]\-XX:+ShowCodeDetailsInExceptionMessages\f[R] +Enables printing of improved \f[CB]NullPointerException\f[R] messages. +When an application throws a \f[CB]NullPointerException\f[R], the option +enables the JVM to analyze the program\[aq]s bytecode instructions to +determine precisely which reference is \f[CB]null\f[R], and describes the +source with a null\-detail message. +The null\-detail message is calculated and returned by +\f[CB]NullPointerException.getMessage()\f[R], and will be printed as the +exception message along with the method, filename, and line number. +By default, this option is disabled. +.RS +.RE +.TP .B \f[CB]\-XX:+ShowMessageBoxOnError\f[R] Enables the display of a dialog box when the JVM experiences an irrecoverable error. @@ -1830,7 +1831,7 @@ Sets the Java thread stack size (in kilobytes). Use of a scaling suffix, such as \f[CB]k\f[R], results in the scaling of the kilobytes value so that \f[CB]\-XX:ThreadStackSize=1k\f[R] sets the -Java thread stack size\ to 1024*1024 bytes or 1 megabyte. +Java thread stack size to 1024*1024 bytes or 1 megabyte. The default value depends on the platform: .RS .IP \[bu] 2 @@ -1892,9 +1893,9 @@ are available to a Java process running in docker containers. It uses this information to allocate system resources. This support is only available on Linux x64 platforms. -\ If supported, the default for this flag is\ \f[CB]true\f[R], and -container support is enabled by default. -\ It\ can be disabled with\ \f[CB]\-XX:\-UseContainerSupport\f[R]. +If supported, the default for this flag is \f[CB]true\f[R], and container +support is enabled by default. +It can be disabled with \f[CB]\-XX:\-UseContainerSupport\f[R]. .RS .PP Unified Logging is available to help to diagnose issues related to this @@ -1964,8 +1965,6 @@ .PP \f[CB]\-XX:AllocateInstancePrefetchLines=1\f[R] .RE -.PP -Only the Java HotSpot Server VM supports this option. .RE .TP .B \f[CB]\-XX:AllocatePrefetchDistance=\f[R]\f[I]size\f[R] @@ -1990,14 +1989,11 @@ .PP \f[CB]\-XX:AllocatePrefetchDistance=1024\f[R] .RE -.PP -Only the Java HotSpot Server VM supports this option. .RE .TP .B \f[CB]\-XX:AllocatePrefetchInstr=\f[R]\f[I]instruction\f[R] Sets the prefetch instruction to prefetch ahead of the allocation pointer. -Only the Java HotSpot Server VM supports this option. Possible values are from 0 to 3. The actual instructions behind the values depend on the platform. By default, the prefetch instruction is set to 0: @@ -2006,8 +2002,6 @@ .PP \f[CB]\-XX:AllocatePrefetchInstr=0\f[R] .RE -.PP -Only the Java HotSpot Server VM supports this option. .RE .TP .B \f[CB]\-XX:AllocatePrefetchLines=\f[R]\f[I]lines\f[R] @@ -2023,8 +2017,6 @@ .PP \f[CB]\-XX:AllocatePrefetchLines=5\f[R] .RE -.PP -Only the Java HotSpot Server VM supports this option. .RE .TP .B \f[CB]\-XX:AllocatePrefetchStepSize=\f[R]\f[I]size\f[R] @@ -2038,8 +2030,6 @@ .PP \f[CB]\-XX:AllocatePrefetchStepSize=16\f[R] .RE -.PP -Only the Java HotSpot Server VM supports this option. .RE .TP .B \f[CB]\-XX:AllocatePrefetchStyle=\f[R]\f[I]style\f[R] @@ -2054,7 +2044,7 @@ .TP .B \f[CB]1\f[R] Execute prefetch instructions after each allocation. -This is the default parameter. +This is the default setting. .RS .RE .TP @@ -2065,11 +2055,9 @@ .RE .TP .B \f[CB]3\f[R] -Use BIS instruction on SPARC for allocation prefetch. +Generate one prefetch instruction per cache line. .RS .RE -.PP -Only the Java HotSpot Server VM supports this option. .RE .TP .B \f[CB]\-XX:+BackgroundCompilation\f[R] @@ -2083,9 +2071,8 @@ .TP .B \f[CB]\-XX:CICompilerCount=\f[R]\f[I]threads\f[R] Sets the number of compiler threads to use for compilation. -By default, the number of threads is set to 2 for the server JVM, to 1 -for the client JVM, and it scales to the number of cores if tiered -compilation is used. +By default, the number of compiler threads is selected automatically +depending on the number of CPUs and memory available for compiled code. The following example shows how to set the number of threads to 2: .RS .RS @@ -2094,6 +2081,13 @@ .RE .RE .TP +.B \f[CB]\-XX:+UseDynamicNumberOfCompilerThreads\f[R] +Dynamically create compiler thread up to the limit specified by +\f[CB]\-XX:CICompilerCount\f[R]. +This option is enabled by default. +.RS +.RE +.TP .B \f[CB]\-XX:CompileCommand=\f[R]\f[I]command\f[R]\f[CB],\f[R]\f[I]method\f[R][\f[CB],\f[R]\f[I]option\f[R]] Specifies a \f[I]command\f[R] to perform on a \f[I]method\f[R]. For example, to exclude the \f[CB]indexOf()\f[R] method of the @@ -2318,33 +2312,13 @@ .fi .RE .TP -.B \f[CB]\-XX:CompileThreshold=\f[R]\f[I]invocations\f[R] -Sets the number of interpreted method invocations before compilation. -By default, in the server JVM, the JIT compiler performs 10,000 -interpreted method invocations to gather information for efficient -compilation. -For the client JVM, the default setting is 1,500 invocations. -This option is ignored when tiered compilation is enabled; see the -option \f[CB]\-XX:\-TieredCompilation\f[R]. -The following example shows how to set the number of interpreted method -invocations to 5,000: -.RS -.RS -.PP -\f[CB]\-XX:CompileThreshold=5000\f[R] -.RE -.PP -You can completely disable interpretation of Java methods before -compilation by specifying the \f[CB]\-Xcomp\f[R] option. -.RE -.TP .B \f[CB]\-XX:CompileThresholdScaling=\f[R]\f[I]scale\f[R] Provides unified control of first compilation. This option controls when methods are first compiled for both the tiered and the nontiered modes of operation. -The \f[CB]CompileThresholdScaling\f[R] option has an integer value between -0 and +Inf and scales the thresholds corresponding to the current mode -of operation (both tiered and nontiered). +The \f[CB]CompileThresholdScaling\f[R] option has a floating point value +between 0 and +Inf and scales the thresholds corresponding to the +current mode of operation (both tiered and nontiered). Setting \f[CB]CompileThresholdScaling\f[R] to a value less than 1.0 results in earlier compilation while values greater than 1.0 delay compilation. @@ -2358,7 +2332,6 @@ This option is enabled by default. To disable the use of escape analysis, specify \f[CB]\-XX:\-DoEscapeAnalysis\f[R]. -Only the Java HotSpot Server VM supports this option. .RS .RE .TP @@ -2367,7 +2340,7 @@ Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes, \f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or \f[CB]G\f[R] to indicate gigabytes. -The default value is set to 500 KB. +The default value depends on the platform. The initial code cache size shouldn\[aq]t be less than the system\[aq]s minimal memory page size. The following example shows how to set the initial code cache size to 32 @@ -2387,14 +2360,14 @@ .RE .TP .B \f[CB]\-XX:InlineSmallCode=\f[R]\f[I]size\f[R] -Sets the maximum code size (in bytes) for compiled methods that should -be inlined. +Sets the maximum code size (in bytes) for already compiled methods that +may be inlined. Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes, \f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or \f[CB]G\f[R] to indicate gigabytes. -Only compiled methods with the size smaller than the specified size is -inlined. -By default, the maximum code size is set to 1000 bytes: +The default value depends on the platform and on whether tiered +compilation is enabled. +In the following example it is set to 1000 bytes: .RS .RS .PP @@ -2420,8 +2393,23 @@ \f[CB]\-XX:+PrintCompilation\f[R] option. .RE .TP +.B \f[CB]\-XX:FreqInlineSize=\f[R]\f[I]size\f[R] +Sets the maximum bytecode size (in bytes) of a hot method to be inlined. +Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes, +\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or +\f[CB]G\f[R] to indicate gigabytes. +The default value depends on the platform. +In the following example it is set to 325 bytes: +.RS +.RS +.PP +\f[CB]\-XX:FreqInlineSize=325\f[R] +.RE +.RE +.TP .B \f[CB]\-XX:MaxInlineSize=\f[R]\f[I]size\f[R] -Sets the maximum bytecode size (in bytes) of a method to be inlined. +Sets the maximum bytecode size (in bytes) of a cold method to be +inlined. Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes, \f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or \f[CB]G\f[R] to indicate gigabytes. @@ -2433,14 +2421,30 @@ .RE .RE .TP +.B \f[CB]\-XX:MaxTrivialSize=\f[R]\f[I]size\f[R] +Sets the maximum bytecode size (in bytes) of a trivial method to be +inlined. +Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes, +\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or +\f[CB]G\f[R] to indicate gigabytes. +By default, the maximum bytecode size of a trivial method is set to 6 +bytes: +.RS +.RS +.PP +\f[CB]\-XX:MaxTrivialSize=6\f[R] +.RE +.RE +.TP .B \f[CB]\-XX:MaxNodeLimit=\f[R]\f[I]nodes\f[R] Sets the maximum number of nodes to be used during single method compilation. -By default, the maximum number of nodes is set to 65,000: +By default the value depends on the features enabled. +In the following example the maximum number of nodes is set to 100,000: .RS .RS .PP -\f[CB]\-XX:MaxNodeLimit=65000\f[R] +\f[CB]\-XX:MaxNodeLimit=100000\f[R] .RE .RE .TP @@ -2461,27 +2465,11 @@ .RS .RE .TP -.B \f[CB]\-XX:MaxTrivialSize=\f[R]\f[I]size\f[R] -Sets the maximum bytecode size (in bytes) of a trivial method to be -inlined. -Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes, -\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or -\f[CB]G\f[R] to indicate gigabytes. -By default, the maximum bytecode size of a trivial method is set to 6 -bytes: -.RS -.RS -.PP -\f[CB]\-XX:MaxTrivialSize=6\f[R] -.RE -.RE -.TP .B \f[CB]\-XX:+OptimizeStringConcat\f[R] Enables the optimization of \f[CB]String\f[R] concatenation operations. This option is enabled by default. To disable the optimization of \f[CB]String\f[R] concatenation operations, specify \f[CB]\-XX:\-OptimizeStringConcat\f[R]. -Only the Java HotSpot Server VM supports this option. .RS .RE .TP @@ -2595,15 +2583,25 @@ .B \f[CB]\-XX:\-TieredCompilation\f[R] Disables the use of tiered compilation. By default, this option is enabled. -Only the Java HotSpot Server VM supports this option. +.RS +.RE +.TP +.B \f[CB]\-XX:UseSSE=\f[R]\f[I]version\f[R] +Enables the use of SSE instruction set of a specified version. +Is set by default to the highest supported version available (x86 only). +.RS +.RE +.TP +.B \f[CB]\-XX:UseAVX=\f[R]\f[I]version\f[R] +Enables the use of AVX instruction set of a specified version. +Is set by default to the highest supported version available (x86 only). .RS .RE .TP .B \f[CB]\-XX:+UseAES\f[R] -Enables hardware\-based AES intrinsics for Intel, AMD, and SPARC -hardware. -Intel Westmere (2010 and newer), AMD Bulldozer (2011 and newer), and -SPARC (T4 and newer) are the supported hardware. +Enables hardware\-based AES intrinsics for hardware that supports it. +This option is on by default on hardware that has the necessary +instructions. The \f[CB]\-XX:+UseAES\f[R] is used in conjunction with UseAESIntrinsics. Flags that control intrinsics now require the option \f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. @@ -2611,8 +2609,9 @@ .RE .TP .B \f[CB]\-XX:+UseAESIntrinsics\f[R] -Enables \f[CB]\-XX:+UseAES\f[R] and \f[CB]\-XX:+UseAESIntrinsics\f[R] flags -by default and are supported only for the Java HotSpot Server VM. +Enables AES intrinsics. +Specifying\f[CB]\-XX:+UseAESIntrinsics\f[R] is equivalent to also enabling +\f[CB]\-XX:+UseAES\f[R]. To disable hardware\-based AES intrinsics, specify \f[CB]\-XX:\-UseAES\ \-XX:\-UseAESIntrinsics\f[R]. For example, to enable hardware AES, use the following flags: @@ -2624,9 +2623,147 @@ .PP Flags that control intrinsics now require the option \f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. -To support UseAES and UseAESIntrinsics flags, use the \f[CB]\-server\f[R] -option to select the Java HotSpot Server VM. -These flags aren\[aq]t supported on Client VM. +.RE +.TP +.B \f[CB]\-XX:+UseAESCTRIntrinsics\f[R] +Analogous to \f[CB]\-XX:+UseAESIntrinsics\f[R] enables AES/CTR intrinsics. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseGHASHIntrinsics\f[R] +Controls the use of GHASH intrinsics. +Enabled by default on platforms that support the corresponding +instructions. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseBASE64Intrinsics\f[R] +Controls the use of accelerated BASE64 encoding routines for +\f[CB]java.util.Base64\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseAdler32Intrinsics\f[R] +Controls the use of Adler32 checksum algorithm intrinsic for +\f[CB]java.util.zip.Adler32\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseCRC32Intrinsics\f[R] +Controls the use of CRC32 intrinsics for \f[CB]java.util.zip.CRC32\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseCRC32CIntrinsics\f[R] +Controls the use of CRC32C intrinsics for \f[CB]java.util.zip.CRC32C\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseSHA\f[R] +Enables hardware\-based intrinsics for SHA crypto hash functions for +SPARC hardware. +The \f[CB]UseSHA\f[R] option is used in conjunction with the +\f[CB]UseSHA1Intrinsics\f[R], \f[CB]UseSHA256Intrinsics\f[R], and +\f[CB]UseSHA512Intrinsics\f[R] options. +.RS +.PP +The \f[CB]UseSHA\f[R] and \f[CB]UseSHA*Intrinsics\f[R] flags are enabled by +default on machines that support the corresponding instructions. +.PP +This feature is applicable only when using the +\f[CB]sun.security.provider.Sun\f[R] provider for SHA operations. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.PP +To disable all hardware\-based SHA intrinsics, specify the +\f[CB]\-XX:\-UseSHA\f[R]. +To disable only a particular SHA intrinsic, use the appropriate +corresponding option. +For example: \f[CB]\-XX:\-UseSHA256Intrinsics\f[R]. +.RE +.TP +.B \f[CB]\-XX:+UseSHA1Intrinsics\f[R] +Enables intrinsics for SHA\-1 crypto hash function. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseSHA256Intrinsics\f[R] +Enables intrinsics for SHA\-224 and SHA\-256 crypto hash functions. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseSHA512Intrinsics\f[R] +Enables intrinsics for SHA\-384 and SHA\-512 crypto hash functions. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseMathExactIntrinsics\f[R] +Enables intrinsification of various \f[CB]java.lang.Math.*Exact()\f[R] +functions. +Enabled by default. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \f[CB]\-XX:+UseMultiplyToLenIntrinsic\f[R] +Enables intrinsification of \f[CB]BigInteger.multiplyToLen()\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \-XX:+UseSquareToLenIntrinsic +Enables intrinsification of \f[CB]BigInteger.squareToLen()\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \-XX:+UseMulAddIntrinsic +Enables intrinsification of \f[CB]BigInteger.mulAdd()\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \-XX:+UseMontgomeryMultiplyIntrinsic +Enables intrinsification of \f[CB]BigInteger.montgomeryMultiply()\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS +.RE +.TP +.B \-XX:+UseMontgomerySquareIntrinsic +Enables intrinsification of \f[CB]BigInteger.montgomerySquare()\f[R]. +Enabled by default on platforms that support it. +Flags that control intrinsics now require the option +\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. +.RS .RE .TP .B \f[CB]\-XX:+UseCMoveUnconditionally\f[R] @@ -2650,13 +2787,31 @@ It should be used only on machines with multiple sockets, where it increases the performance of Java applications that rely on concurrent operations. -Only the Java HotSpot Server VM supports this option. .RS .RE .TP .B \f[CB]\-XX:+UseCountedLoopSafepoints\f[R] Keeps safepoints in counted loops. -Its default value is false.\ +Its default value depends on whether the selected garbage collector +requires low latency safepoints. +.RS +.RE +.TP +.B \f[CB]\-XX:LoopStripMiningIter=\f[R]\f[I]number_of_iterations\f[R] +Controls the number of iterations in the inner strip mined loop. +Strip mining transforms counted loops into two level nested loops. +Safepoints are kept in the outer loop while the inner loop can execute +at full speed. +This option controls the maximum number of iterations in the inner loop. +The default value is 1,000. +.RS +.RE +.TP +.B \f[CB]\-XX:LoopStripMiningIterShortLoop\f[R]=\f[I]number_of_iterations\f[R] +Controls loop strip mining optimization. +Loops with the number of iterations less than specified will not have +safepoints in them. +Default value is 1/10th of \f[CB]\-XX:LoopStripMiningIter\f[R]. .RS .RE .TP @@ -2687,8 +2842,8 @@ inflated locks, with the normal locking mechanism as the fallback handler. This option is disabled by default. -Options related to RTM are available only for the Java HotSpot Server VM -on x86 CPUs that support Transactional Synchronization Extensions (TSX). +Options related to RTM are available only on x86 CPUs that support +Transactional Synchronization Extensions (TSX). .RS .PP RTM is part of Intel\[aq]s TSX, which is an x86 instruction set @@ -2731,51 +2886,6 @@ their cache. .RE .TP -.B \f[CB]\-XX:+UseSHA\f[R] -Enables hardware\-based intrinsics for SHA crypto hash functions for -SPARC hardware. -The \f[CB]UseSHA\f[R] option is used in conjunction with the -\f[CB]UseSHA1Intrinsics\f[R], \f[CB]UseSHA256Intrinsics\f[R], and -\f[CB]UseSHA512Intrinsics\f[R] options. -.RS -.PP -The \f[CB]UseSHA\f[R] and \f[CB]UseSHA*Intrinsics\f[R] flags are enabled by -default, and are supported only for Java HotSpot Server VM 64\-bit on -SPARC T4 and newer. -.PP -This feature is applicable only when using the -\f[CB]sun.security.provider.Sun\f[R] provider for SHA operations. -Flags that control intrinsics now require the option -\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. -.PP -To disable all hardware\-based SHA intrinsics, specify the -\f[CB]\-XX:\-UseSHA\f[R]. -To disable only a particular SHA intrinsic, use the appropriate -corresponding option. -For example: \f[CB]\-XX:\-UseSHA256Intrinsics\f[R]. -.RE -.TP -.B \f[CB]\-XX:+UseSHA1Intrinsics\f[R] -Enables intrinsics for SHA\-1 crypto hash function. -Flags that control intrinsics now require the option -\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. -.RS -.RE -.TP -.B \f[CB]\-XX:+UseSHA256Intrinsics\f[R] -Enables intrinsics for SHA\-224 and SHA\-256 crypto hash functions. -Flags that control intrinsics now require the option -\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. -.RS -.RE -.TP -.B \f[CB]\-XX:+UseSHA512Intrinsics\f[R] -Enables intrinsics for SHA\-384 and SHA\-512 crypto hash functions. -Flags that control intrinsics now require the option -\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]. -.RS -.RE -.TP .B \f[CB]\-XX:+UseSuperWord\f[R] Enables the transformation of scalar operations into superword operations. @@ -2783,7 +2893,6 @@ This option is enabled by default. To disable the transformation of scalar operations into superword operations, specify \f[CB]\-XX:\-UseSuperWord\f[R]. -Only the Java HotSpot Server VM supports this option. .RS .RE .SH ADVANCED SERVICEABILITY OPTIONS FOR JAVA @@ -2975,7 +3084,6 @@ application uses the heap space. .RS .RE -.RE .TP .B \f[CB]\-XX:ConcGCThreads=\f[R]\f[I]threads\f[R] Sets the number of threads used for concurrent GC. @@ -3707,14 +3815,6 @@ automatically enabled, unless you explicitly disable it. .RE .TP -.B \f[CB]\-XX:+UseParallelOldGC\f[R] -Enables the use of the parallel garbage collector for full GCs. -By default, this option is disabled. -Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R] -option. -.RS -.RE -.TP .B \f[CB]\-XX:+UseSerialGC\f[R] Enables the use of the serial garbage collector. This is generally the best choice for small and simple applications that @@ -3799,15 +3899,6 @@ \f[CB]\-Xlog:gc:garbage\-collection.log\f[R] .RE .TP -.B \f[CB]\-XX:+FailOverToOldVerifier\f[R] -Enables automatic failover to the old verifier when the new type checker -fails. -By default, this option is disabled and it\[aq]s ignored (that is, -treated as disabled) for classes with a recent bytecode version. -You can enable it only for classes with older versions of the bytecode. -.RS -.RE -.TP .B \f[CB]\-XX:+FlightRecorder\f[R] Enables the use of Java Flight Recorder (JFR) during the runtime of the application. @@ -3902,6 +3993,27 @@ See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R]. .RE .TP +.B \f[CB]\-XX:+UseParallelOldGC\f[R] +Enables the use of the parallel garbage collector for full GCs. +By default, this option is disabled. +Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R] +option. +.RS +.RE +.SH OBSOLETE JAVA OPTIONS +.PP +These \f[CB]java\f[R] options are still accepted but ignored, and a +warning is issued when they\[aq]re used. +.TP +.B \f[CB]\-XX:+FailOverToOldVerifier\f[R] +Enables automatic failover to the old verifier when the new type checker +fails. +By default, this option is disabled and it\[aq]s ignored (that is, +treated as disabled) for classes with a recent bytecode version. +You can enable it only for classes with older versions of the bytecode. +.RS +.RE +.TP .B \f[CB]\-XX:+UseMembar\f[R] Enabled issuing membars on thread\-state transitions. This option was disabled by default on all platforms except ARM servers, @@ -3925,23 +4037,14 @@ .RE .SH REMOVED JAVA OPTIONS .PP -These \f[CB]java\f[R] options have been removed in JDK 13 and using them -results in an error of: -.RS -.PP -\f[CB]Unrecognized\ VM\ option\f[R] \f[I]option\-name\f[R] -.RE -.TP -.B \f[CB]\-XX:+AggressiveOpts\f[R] -Enabled the use of aggressive performance optimization features. -By default, this option was disabled and experimental performance -features were not used. -.RS -.RE +No documented \f[CB]java\f[R] options have been removed in JDK 14. .PP For the lists and descriptions of options removed in previous releases see the \f[I]Removed Java Options\f[R] section in: .IP \[bu] 2 +\f[B]Java Platform, Standard Edition Tools Reference, Release 13\f[R] +[https://docs.oracle.com/en/java/javase/13/docs/specs/man/java.html] +.IP \[bu] 2 \f[B]Java Platform, Standard Edition Tools Reference, Release 12\f[R] [https://docs.oracle.com/en/java/javase/12/tools/java.html#GUID\-3B1CE181\-CD30\-4178\-9602\-230B800D4FAE] .IP \[bu] 2 @@ -4012,7 +4115,6 @@ A string within quotation marks may contain the characters \f[CB]\\n\f[R], \f[CB]\\r\f[R], \f[CB]\\t\f[R], and \f[CB]\\f\f[R]. They are converted to their respective ASCII codes. -\ .IP \[bu] 2 If a file name contains embedded spaces, then put the whole file name in double quotation marks. @@ -4032,11 +4134,11 @@ Lines may be continued using the continuation character (\f[CB]\\\f[R]) at the end\-of\-line. The two lines are concatenated with the leading white spaces trimmed. -To prevent trimming the \ leading white spaces, a continuation character +To prevent trimming the leading white spaces, a continuation character (\f[CB]\\\f[R]) may be placed at the first column. .IP \[bu] 2 -Because backslash (\\) is an escape character, a backslash -character\ must be escaped with another backslash character. +Because backslash (\\) is an escape character, a backslash character +must be escaped with another backslash character. .IP \[bu] 2 Partial quote is allowed and is closed by an end\-of\-file. .IP \[bu] 2 @@ -4067,7 +4169,7 @@ .PP \f[CB]\-cp\ lib/cool/app/jars\f[R] .RE -.SS Example of a Backslash Character\ Escaped with Another Backslash +.SS Example of a Backslash Character Escaped with Another Backslash Character in an Argument File .PP To output the following: @@ -4079,7 +4181,7 @@ The backslash character must be specified in the argument file as: .RS .PP -\f[CB]\-cp\ \ "c:\\\\Program\ Files\ (x86)\\\\Java\\\\jre\\\\lib\\\\ext;c:\\\\Program\ Files\\\\Java\\\\jre9\\\\lib\\\\ext"\f[R] +\f[CB]\-cp\ "c:\\\\Program\ Files\ (x86)\\\\Java\\\\jre\\\\lib\\\\ext;c:\\\\Program\ Files\\\\Java\\\\jre9\\\\lib\\\\ext"\f[R] .RE .SS Example of an EOL Escape Used to Force Concatenation of Lines in an Argument File @@ -4105,7 +4207,7 @@ .nf \f[CB] \-cp\ "/lib/cool\\ -\\app/jars” +\\app/jars??? \f[R] .fi .PP @@ -4894,10 +4996,10 @@ .IP .nf \f[CB] -java\ \-XX:AllocatePrefetchStyle=5\ \-version\ \ \ -intx\ AllocatePrefetchStyle=5\ is\ outside\ the\ allowed\ range\ [\ 0\ ...\ 3\ ]\ \ \ -Improperly\ specified\ VM\ option\ \[aq]AllocatePrefetchStyle=5\[aq]\ \ \ -Error:\ Could\ not\ create\ the\ Java\ Virtual\ Machine.\ \ +java\ \-XX:AllocatePrefetchStyle=5\ \-version +intx\ AllocatePrefetchStyle=5\ is\ outside\ the\ allowed\ range\ [\ 0\ ...\ 3\ ] +Improperly\ specified\ VM\ option\ \[aq]AllocatePrefetchStyle=5\[aq] +Error:\ Could\ not\ create\ the\ Java\ Virtual\ Machine. Error:\ A\ fatal\ exception\ has\ occurred.\ Program\ will\ exit. \f[R] .fi @@ -5571,18 +5673,19 @@ \f[CB]\-XX:SharedArchiveConfigFile=\f[R]\f[I]shared_config_file\f[R] .RE .PP -JDK 9 and later supports adding both symbols and\ string objects to an -archive for memory sharing\ when you have multiple JVM processes running +JDK 9 and later supports adding both symbols and string objects to an +archive for memory sharing when you have multiple JVM processes running on the same host. An example of this is having multiple JVM processes that use the same set of Java EE classes. When these common classes are loaded and used, new symbols and strings may be created and added to the JVM\[aq]s internal "symbol" and "string" -tables.\ At runtime, the symbols or string objects mapped from the -archive file can be shared across multiple JVM processes, resulting in a -reduction of overall memory usage.\ In addition, archiving strings also -provides added performance benefits in both startup time and runtime -execution. +tables. +At runtime, the symbols or string objects mapped from the archive file +can be shared across multiple JVM processes, resulting in a reduction of +overall memory usage. +In addition, archiving strings also provides added performance benefits +in both startup time and runtime execution. .PP In JDK 10 and later, CONSTANT_String entries in archived classes are resolved to interned String objects at dump time, and all interned @@ -5597,7 +5700,7 @@ See \f[B]jcmd\f[R]. .PP The following is an example of the symbol dumping command in -\f[CB]jcmd\f[R]:\ +\f[CB]jcmd\f[R]: .RS .PP \f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]VM.symboltable\ \-verbose\f[R] --- old/src/java.base/share/man/jfr.1 2020-01-14 13:13:48.759018778 -0800 +++ new/src/java.base/share/man/jfr.1 2020-01-14 13:13:48.455005373 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JFR" "1" "2019" "JDK 13" "JDK Commands" +.TH "JFR" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/java.base/share/man/keytool.1 2020-01-14 13:13:49.519052292 -0800 +++ new/src/java.base/share/man/keytool.1 2020-01-14 13:13:49.215038887 -0800 @@ -8,7 +8,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -22,7 +22,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "KEYTOOL" "1" "2019" "JDK 13" "JDK Commands" +.TH "KEYTOOL" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -325,10 +325,10 @@ .IP .nf \f[CB] -keytool\ \-alias\ ca\ \-dname\ CN=CA\ \-genkeypair -keytool\ \-alias\ ca1\ \-dname\ CN=CA\ \-genkeypair -keytool\ \-alias\ ca2\ \-dname\ CN=CA\ \-genkeypair -keytool\ \-alias\ e1\ \-dname\ CN=E1\ \-genkeypair +keytool\ \-alias\ ca\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa +keytool\ \-alias\ ca1\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa +keytool\ \-alias\ ca2\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa +keytool\ \-alias\ e1\ \-dname\ CN=E1\ \-genkeypair\ \-keyalg\ rsa \f[R] .fi .PP @@ -365,7 +365,7 @@ .IP \[bu] 2 {\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process .IP \[bu] 2 -{\f[CB]\-keyalg\f[R] \f[I]alg\f[R]}: Key algorithm name +\f[CB]\-keyalg\f[R] \f[I]alg\f[R]: Key algorithm name .IP \[bu] 2 {\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size .IP \[bu] 2 @@ -379,7 +379,7 @@ {\f[CB]\-startdate\f[R] \f[I]date\f[R]}: Certificate validity start date and time .IP \[bu] 2 -[\f[CB]\-ext\f[R] \f[I]value\f[R]}*: X.509 extension +{\f[CB]\-ext\f[R] \f[I]value\f[R]}*: X.509 extension .IP \[bu] 2 {\f[CB]\-validity\f[R] \f[I]days\f[R]}: Validity number of days .IP \[bu] 2 @@ -503,7 +503,7 @@ .IP \[bu] 2 [\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password .IP \[bu] 2 -{\f[CB]\-keyalg\f[R] \f[I]alg\f[R]}: Key algorithm name +\f[CB]\-keyalg\f[R] \f[I]alg\f[R]: Key algorithm name .IP \[bu] 2 {\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size .IP \[bu] 2 @@ -675,7 +675,7 @@ \f[CB]\-importkeystore\f[R] command: .RS .IP \[bu] 2 -{\f[CB]\-srckeystore\f[R] \f[I]keystore\f[R]}: Source keystore name +\f[CB]\-srckeystore\f[R] \f[I]keystore\f[R]: Source keystore name .IP \[bu] 2 {\f[CB]\-destkeystore\f[R] \f[I]keystore\f[R]}: Destination keystore name .IP \[bu] 2 @@ -1028,7 +1028,7 @@ command: .RS .IP \[bu] 2 -\f[CB]\-file\ crl\f[R]: Input file name +{\f[CB]\-file\ crl\f[R]}: Input file name .IP \[bu] 2 {\f[CB]\-v\f[R]}: Verbose output .PP @@ -1470,10 +1470,6 @@ \f[CB] \-alias\ "mykey" -\-keyalg -\ \ \ \ "DSA"\ (when\ using\ \-genkeypair) -\ \ \ \ "DES"\ (when\ using\ \-genseckey) - \-keysize \ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA") \ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "DSA") @@ -1523,7 +1519,7 @@ SHA256withDSA T} T{ -RSA \ \ \ +RSA T}@T{ <= 3072 T}@T{ @@ -1778,7 +1774,7 @@ You can enter the command as a single line such as the following: .RS .PP -\f[CB]keytool\ \-genkeypair\ \-dname\ "cn=myname,\ ou=mygroup,\ o=mycompany,\ c=mycountry"\ \-alias\ business\ \-keypass\f[R] +\f[CB]keytool\ \-genkeypair\ \-dname\ "cn=myname,\ ou=mygroup,\ o=mycompany,\ c=mycountry"\ \-alias\ business\ \-keyalg\ rsa\ \-keypass\f[R] \f[I]password\f[R] \f[CB]\-keystore\ /working/mykeystore\ \-storepass\ password\ \-validity\ 180\f[R] .RE @@ -1790,10 +1786,10 @@ 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 default DSA key generation algorithm to create the keys; -both are 2048 bits +It uses the RSA key generation algorithm to create the keys; both are +2048 bits .PP -The command uses the default SHA256withDSA signature algorithm to create +The command uses the default SHA256withRSA 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 @@ -1804,13 +1800,13 @@ .PP The command is significantly shorter when the option defaults are accepted. -In this case, no options are required, and the defaults are used for -unspecified options that have default values. +In this case, only \f[CB]\-keyalg\f[R] is required, and the defaults are +used for unspecified options that have default values. You are prompted for any required values. You could have the following: .RS .PP -\f[CB]keytool\ \-genkeypair\f[R] +\f[CB]keytool\ \-genkeypair\ \-keyalg\ rsa\f[R] .RE .PP In this case, a keystore entry with the alias \f[CB]mykey\f[R] is created, @@ -1824,10 +1820,9 @@ .PP \f[B]Note:\f[R] .PP -The rest of the examples assume that you executed the -\f[CB]\-genkeypair\f[R] command without specifying options, and that you -responded to the prompts with values equal to those specified in the -first \f[CB]\-genkeypair\f[R] command. +The rest of the examples assume that you responded to the prompts with +values equal to those specified in the first \f[CB]\-genkeypair\f[R] +command. For example, a distinguished name of \f[CB]cn=\f[R]\f[I]myname\f[R]\f[CB],\ ou=\f[R]\f[I]mygroup\f[R]\f[CB],\ o=\f[R]\f[I]mycompany\f[R]\f[CB],\ c=\f[R]\f[I]mycountry\f[R]). .SH REQUESTING A SIGNED CERTIFICATE FROM A CA @@ -2042,13 +2037,12 @@ SSL server (\f[CB]server\f[R]) .PP Ensure that you store all the certificates in the same keystore. -In the following examples, RSA is the recommended the key algorithm. .IP .nf \f[CB] -keytool\ \-genkeypair\ \-keystore\ root.jks\ \-alias\ root\ \-ext\ bc:c -keytool\ \-genkeypair\ \-keystore\ ca.jks\ \-alias\ ca\ \-ext\ bc:c -keytool\ \-genkeypair\ \-keystore\ server.jks\ \-alias\ server +keytool\ \-genkeypair\ \-keystore\ root.jks\ \-alias\ root\ \-ext\ bc:c\ \-keyalg\ rsa +keytool\ \-genkeypair\ \-keystore\ ca.jks\ \-alias\ ca\ \-ext\ bc:c\ \-keyalg\ rsa +keytool\ \-genkeypair\ \-keystore\ server.jks\ \-alias\ server\ \-keyalg\ rsa keytool\ \-keystore\ root.jks\ \-alias\ root\ \-exportcert\ \-rfc\ >\ root.pem @@ -2117,7 +2111,8 @@ See \f[B]Certificate Chains\f[R]. .RS .PP -\f[CB]keytool\ \-genkeypair\ \-alias\ duke\ \-keypass\f[R] \f[I]passwd\f[R] +\f[CB]keytool\ \-genkeypair\ \-alias\ duke\ \-keyalg\ rsa\ \-keypass\f[R] +\f[I]passwd\f[R] .RE .PP This example specifies an initial \f[I]passwd\f[R] required by subsequent @@ -2615,7 +2610,7 @@ A sample command using such a string is: .RS .PP -\f[CB]keytool\ \-genkeypair\ \-dname\ "CN=Mark\ Smith,\ OU=Java,\ O=Oracle,\ L=Cupertino,\ S=California,\ C=US"\ \-alias\ mark\f[R] +\f[CB]keytool\ \-genkeypair\ \-dname\ "CN=Mark\ Smith,\ OU=Java,\ O=Oracle,\ L=Cupertino,\ S=California,\ C=US"\ \-alias\ mark\ \-keyalg\ rsa\f[R] .RE .PP Case doesn\[aq]t matter for the keyword abbreviations. --- old/src/java.rmi/share/man/rmid.1 2020-01-14 13:13:50.355089157 -0800 +++ new/src/java.rmi/share/man/rmid.1 2020-01-14 13:13:50.047075575 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "RMID" "1" "2018" "JDK 13" "JDK Commands" +.TH "RMID" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/java.rmi/share/man/rmiregistry.1 2020-01-14 13:13:51.111122494 -0800 +++ new/src/java.rmi/share/man/rmiregistry.1 2020-01-14 13:13:50.807109089 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "RMIREGISTRY" "1" "2018" "JDK 13" "JDK Commands" +.TH "RMIREGISTRY" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/java.scripting/share/man/jrunscript.1 2020-01-14 13:13:51.871156007 -0800 +++ new/src/java.scripting/share/man/jrunscript.1 2020-01-14 13:13:51.567142602 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JRUNSCRIPT" "1" "2018" "JDK 13" "JDK Commands" +.TH "JRUNSCRIPT" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -31,7 +31,7 @@ .PP \f[B]Note:\f[R] .PP -This tool is \f[B]experimental\f[R]\ and unsupported. +This tool is \f[B]experimental\f[R] and unsupported. .PP \f[CB]jrunscript\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]] .TP --- old/src/jdk.aot/share/man/jaotc.1 2020-01-14 13:13:52.639189874 -0800 +++ new/src/jdk.aot/share/man/jaotc.1 2020-01-14 13:13:52.331176292 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JAOTC" "1" "2019" "JDK 13" "JDK Commands" +.TH "JAOTC" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -204,6 +204,6 @@ .IP .nf \f[CB] -java\ \-XX:AOTLibrary=./libHelloWorld.so\ HelloWorld +java\ \-XX:+UnlockExperimentalVMOptions\ \-XX:AOTLibrary=./libHelloWorld.so\ HelloWorld \f[R] .fi --- old/src/jdk.compiler/share/man/javac.1 2020-01-14 13:13:53.395223210 -0800 +++ new/src/jdk.compiler/share/man/javac.1 2020-01-14 13:13:53.091209804 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JAVAC" "1" "2019" "JDK 13" "JDK Commands" +.TH "JAVAC" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -65,8 +65,8 @@ command line. .IP \[bu] 2 For a large number of source files, you can use the -\f[CB]\@\f[R]\f[I]filename\f[R] option on the command line to specify an -\f[I]argument file\f[R] that lists their file names. +\f[B]\f[BC]\@\f[B]\f[BI]filename\f[B]\f[R] option on the command line to +specify an \f[I]argument file\f[R] that lists their file names. See \f[B]Standard Options\f[R] for a description of the option and \f[B]Command\-Line Argument Files\f[R] for a description of \f[CB]javac\f[R] argument files. @@ -100,7 +100,7 @@ By default, \f[CB]javac\f[R] compiles each source file to a class file in the same directory as the source file. However, it is recommended to specify a separate destination directory -with the \f[CB]\-d\f[R] option described in \f[B]Standard Options\f[R]. +with the \f[B]\f[BC]\-d\f[B]\f[R] option. .PP Command\-line \f[B]options\f[R] and \f[B]environment variables\f[R] also control how \f[CB]javac\f[R] performs various tasks: @@ -160,7 +160,7 @@ Reads options and file names from a file. To shorten or simplify the \f[CB]javac\f[R] command, you can specify one or more files that contain arguments to the \f[CB]javac\f[R] command -(except \f[CB]\-J\f[R] options). +(except \f[B]\f[BC]\-J\f[B]\f[R] options). This lets you to create \f[CB]javac\f[R] commands of any length on any operating system. See \f[B]Command\-Line Argument Files\f[R]. @@ -179,7 +179,7 @@ .B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R]\f[CB],\f[R]\f[I]module\f[R] Specifies root modules to resolve in addition to the initial modules, or all modules on the module path if \f[I]module\f[R] is -\f[CB]ALL\-MODULE\-PATH.\f[R] +\f[CB]ALL\-MODULE\-PATH\f[R]. .RS .RE .TP @@ -189,9 +189,10 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. -For JDK 9 or later, see \f[CB]\-\-system\f[R]. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. +For JDK 9 or later, see \f[B]\f[BC]\-\-system\f[B]\f[R]. .RE .TP .B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R] @@ -205,12 +206,12 @@ \f[CB]CLASSPATH\f[R] environment variable, if that is set, or else the current directory. .IP \[bu] 2 -If not compiling code for modules, if the \f[CB]\-\-source\-path\f[R] or -\-sourcepath` option is not specified, then the user class path is also -searched for source files. +If not compiling code for modules, if the +\f[B]\f[BC]\-\-source\-path\f[B]\f[R] or \-sourcepath` option is not +specified, then the user class path is also searched for source files. .IP \[bu] 2 -If the \f[CB]\-processorpath\f[R] option is not specified, then the class -path is also searched for annotation processors. +If the \f[B]\f[BC]\-processorpath\f[B]\f[R] option is not specified, then +the class path is also searched for annotation processors. .RE .TP .B \f[CB]\-d\f[R] \f[I]directory\f[R] @@ -257,8 +258,8 @@ .TP .B \f[CB]\-\-enable\-preview\f[R] Enables preview language features. -Used in conjunction with either \f[CB]\-source\f[R] or -\f[CB]\-\-release\f[R]. +Used in conjunction with either \f[B]\f[BC]\-source\f[B]\f[R] or +\f[B]\f[BC]\-\-release\f[B]\f[R]. .RS .RE .TP @@ -276,8 +277,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-extdirs\f[R] \f[I]directories\f[R] @@ -295,8 +297,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-g\f[R] @@ -468,8 +471,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-\-release\f[R] \f[I]release\f[R] @@ -495,8 +499,8 @@ that release. .PP \f[B]Note:\f[R] When using \f[CB]\-\-release\f[R], you cannot also use the -\f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or -\f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options. +\f[B]\f[BC]\-\-source\f[B]\f[R]/\f[CB]\-source\f[R] or +\f[B]\f[BC]\-\-target\f[B]\f[R]/\f[CB]\-target\f[R] options. .PP \f[B]Note:\f[R] When using \f[CB]\-\-release\f[R] to specify a release that supports the Java Platform Module System, the \f[CB]\-\-add\-exports\f[R] @@ -560,7 +564,7 @@ .PP \f[B]Note:\f[R] The target release must be equal to or higher than the source release. -(See \f[CB]\-\-source\f[R].) +(See \f[B]\f[BC]\-\-source\f[B]\f[R].) .RE .TP .B \f[CB]\-\-upgrade\-module\-path\f[R] \f[I]path\f[R] @@ -611,8 +615,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-Djava.ext.dirs=\f[R]\f[I]dirs\f[R] @@ -621,8 +626,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-\-doclint\-format\f[R] [\f[CB]html4\f[R]|\f[CB]html5\f[R]] @@ -642,8 +648,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-Xbootclasspath/a:\f[R]\f[I]path\f[R] @@ -652,8 +659,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-Xbootclasspath/p:\f[R]\f[I]path\f[R] @@ -662,8 +670,9 @@ .PP \f[B]Note:\f[R] This can only be used when compiling for releases prior to JDK 9. -As applicable, see the descriptions in \f[CB]\-\-release\f[R], -\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details. +As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R], +\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for +details. .RE .TP .B \f[CB]\-Xdiags:\f[R][\f[CB]compact\f[R], \f[CB]verbose\f[R]] @@ -929,9 +938,9 @@ .SH ENVIRONMENT VARIABLES .SS CLASSPATH .PP -If the \f[CB]\-\-class\-path\f[R] option or any of its alternate forms are -not specified, the class path will default to the value of the -\f[CB]CLASSPATH\f[R] environment variable if it is set. +If the \f[B]\f[BC]\-\-class\-path\f[B]\f[R] option or any of its +alternate forms are not specified, the class path will default to the +value of the \f[CB]CLASSPATH\f[R] environment variable if it is set. However, it is recommended that this environment variable should \f[I]not\f[R] be set, and that the \f[CB]\-\-class\-path\f[R] option should be used to provide an explicit value for the class path when one is @@ -1181,12 +1190,12 @@ around those limits, you can use \f[B]argument files\f[R]. .PP When compiling code for modules, you can also specify source files -indirectly, by using the \f[CB]\-\-module\f[R] or \f[CB]\-m\f[R] option; see -\f[B]Standard Options\f[R]. +indirectly, by using the \f[B]\f[BC]\-\-module\f[B]\f[R] or \f[CB]\-m\f[R] +option. .SS Output Directory .IP \[bu] 2 -Use the \f[CB]\-d\f[R] option to specify an output directory in which to -put the compiled class files. +Use the \f[B]\f[BC]\-d\f[B]\f[R] option to specify an output directory in +which to put the compiled class files. .PP This will normally be organized in a \f[B]package hierarchy\f[R], unless you are compiling source code from multiple modules, in which case it @@ -1204,15 +1213,15 @@ If the library code is not in a module, place it on the class path; if it is in a module, place it on the module path. .IP \[bu] 2 -Use the \f[CB]\-\-class\-path\f[R] option to specify libraries to be -placed on the class path. +Use the \f[B]\f[BC]\-\-class\-path\f[B]\f[R] option to specify libraries +to be placed on the class path. Locations on the class path should be organized in a \f[B]package hierarchy\f[R]. You can also use alternate forms of the option: \f[CB]\-classpath\f[R] or \f[CB]\-cp\f[R]. .IP \[bu] 2 -Use the \f[CB]\-\-module\-path\f[R] option to specify libraries to be -placed on the module path. +Use the \f[B]\f[BC]\-\-module\-path\f[B]\f[R] option to specify libraries +to be placed on the module path. Locations on the module path should either be modules or directories of modules. You can also use an alternate form of the option: \f[CB]\-p\f[R]. @@ -1236,23 +1245,24 @@ the source path; if you are compiling code for multiple modules, use the module source path. .IP \[bu] 2 -Use the \f[CB]\-\-source\-path\f[R] option to specify the locations of -additional source files that may be read by javac. +Use the \f[B]\f[BC]\-\-source\-path\f[B]\f[R] option to specify the +locations of additional source files that may be read by javac. Locations on the source path should be organized in a \f[B]package hierarchy\f[R]. You can also use an alternate form of the option: \f[CB]\-sourcepath\f[R]. .IP \[bu] 2 -Use the \f[CB]\-\-module\-source\-path\f[R] option one or more times to -specify the location of additional source files in different modules -that may be read by javac, or when compiling source files in multiple -modules. +Use the \f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] option one or more +times to specify the location of additional source files in different +modules that may be read by javac, or when compiling source files in +multiple modules. You can either specify the locations for each module \f[B]individually\f[R], or you can organize the source files so that you can specify the locations all \f[B]together\f[R]. For more details, see \f[B]The Module Source Path Option\f[R]. .PP If you want to be able to refer to types in additional source files but -do not want them to be compiled, use the \f[CB]\-implicit\f[R] option. +do not want them to be compiled, use the \f[B]\f[BC]\-implicit\f[B]\f[R] +option. .PP \f[B]Note\f[R]: if you are compiling code for multiple modules, you must always specify a module source path, and all source files specified on @@ -1371,30 +1381,30 @@ .SH CONFIGURING THE MODULE SYSTEM .PP If you want to include additional modules in your compilation, use the -\f[CB]\-\-add\-modules\f[R] option. +\f[B]\f[BC]\-\-add\-modules\f[B]\f[R] option. This may be necessary when you are compiling code that is not in a module, or which is in an automatic module, and the code refers to API in the additional modules. .PP If you want to restrict the set of modules in your compilation, use the -\f[CB]\-\-limit\-modules\f[R] option. +\f[B]\f[BC]\-\-limit\-modules\f[B]\f[R] option. This may be useful if you want to ensure that the code you are compiling is capable of running on a system with a limited set of modules installed. .PP If you want to break encapsulation and specify that additional packages should be considered as exported from a module, use the -\f[CB]\-\-add\-exports\f[R] option. +\f[B]\f[BC]\-\-add\-exports\f[B]\f[R] option. This may be useful when performing white\-box testing; relying on access to internal API in production code is strongly discouraged. .PP If you want to specify that additional packages should be considered as -required by a module, use the \f[CB]\-\-add\-reads\f[R] option. +required by a module, use the \f[B]\f[BC]\-\-add\-reads\f[B]\f[R] option. This may be useful when performing white\-box testing; relying on access to internal API in production code is strongly discouraged. .PP You can patch additional content into any module using the -\f[CB]\-\-patch\-module\f[R] option. +\f[B]\f[BC]\-\-patch\-module\f[B]\f[R] option. See [Patching a Module] for more details. .SH SEARCHING FOR MODULE, PACKAGE AND TYPE DECLARATIONS .PP @@ -1416,24 +1426,23 @@ available the declaration of that module. .PP A successful search may produce a class file, a source file, or both. -If both are found, then you can use the \f[CB]\-Xprefer\f[R] option to -instruct the compiler which to use; see \f[B]Extra Options\f[R]. +If both are found, then you can use the \f[B]\f[BC]\-Xprefer\f[B]\f[R] +option to instruct the compiler which to use. .PP If a search finds and uses a source file, then by default \f[CB]javac\f[R] compiles that source file. -This behavior can be altered with \f[CB]\-implicit\f[R]; see \f[B]Standard -Options\f[R]. +This behavior can be altered with \f[B]\f[BC]\-implicit\f[B]\f[R]. .PP The compiler might not discover the need for some type information until after annotation processing completes. When the type information is found in a source file and no -\f[CB]\-implicit\f[R] option is specified, the compiler gives a warning -that the file is being compiled without being subject to annotation -processing. +\f[B]\f[BC]\-implicit\f[B]\f[R] option is specified, the compiler gives a +warning that the file is being compiled without being subject to +annotation processing. To disable the warning, either specify the file on the command line (so that it will be subject to annotation processing) or use the -\f[CB]\-implicit\f[R] option to specify whether or not class files should -be generated for such source files. +\f[B]\f[BC]\-implicit\f[B]\f[R] option to specify whether or not class +files should be generated for such source files. .PP The way that \f[CB]javac\f[R] locates the declarations of those types depends on whether the reference exists within code for a module or not. @@ -1459,15 +1468,16 @@ \f[CB]javac\f[R] will lazily scan the following paths and locations to determine the modules that will be used in the compilation. .IP \[bu] 2 -The module source path (see the \f[CB]\-\-module\-source\-path\f[R] -option) +The module source path (see the +\f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] option) .IP \[bu] 2 The path for upgradeable modules (see the -\f[CB]\-\-upgrade\-module\-path\f[R] option) +\f[B]\f[BC]\-\-upgrade\-module\-path\f[B]\f[R] option) .IP \[bu] 2 -The system modules (see the \f[CB]\-\-system\f[R] option) +The system modules (see the \f[B]\f[BC]\-\-system\f[B]\f[R] option) .IP \[bu] 2 -The user module path ( see the \f[CB]\-\-module\-path\f[R] option) +The user module path ( see the \f[B]\f[BC]\-\-module\-path\f[B]\f[R] +option) .PP For any module, the first occurrence of the module during the scan completely shadows (hides) any subsequent appearance of a like\-named @@ -1524,8 +1534,8 @@ modified file will be used by default. If the source file is newer, it will be compiled and will may override any previously compiled version of the file. -You can use the \f[CB]\-Xprefer\f[R] option to override the default -behavior. +You can use the \f[B]\f[BC]\-Xprefer\f[B]\f[R] option to override the +default behavior. .SS Searching for the Declaration of a Type When the Reference is in a Module .PP @@ -1570,11 +1580,12 @@ .PP The location of these hierarchies are specified to \f[CB]javac\f[R] with command\-line options, whose names typically end in "path", like -\f[CB]\-\-source\-path\f[R] or \f[CB]\-\-class\-path\f[R]. +\f[B]\f[BC]\-\-source\-path\f[B]\f[R] or +\f[B]\f[BC]\-\-class\-path\f[B]\f[R]. Also as a general rule, path options whose name includes the word -\f[CB]module\f[R], like \f[CB]\-\-module\-path\f[R], are used to specify -module hierarchies, although some module\-related path options allow a -package hierarchy to be specified on a per\-module basis. +\f[CB]module\f[R], like \f[B]\f[BC]\-\-module\-path\f[B]\f[R], are used to +specify module hierarchies, although some module\-related path options +allow a package hierarchy to be specified on a per\-module basis. All other path options are used to specify package hierarchies. .SS Package Hierarchy .PP @@ -1618,7 +1629,7 @@ \f[I]my.library/src/main/java/com/example/MyClass.java\f[R]. .SH THE MODULE SOURCE PATH OPTION .PP -The \f[CB]\-\-module\-source\-path\f[R] option has two forms: a +The \f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] option has two forms: a \f[I]module\-specific form\f[R], in which a package path is given for each module containing code to be compiled, and a \f[I]module\-pattern\f[R] form, in which the source path for each module @@ -1653,7 +1664,7 @@ otherwise. .PP \f[B]Note:\f[R] this is similar to the form used for the -\f[CB]\-\-patch\-module\f[R] option. +\f[B]\f[BC]\-\-patch\-module\f[B]\f[R] option. .SS Module\-pattern form .PP The module\-pattern form allows a concise specification of the module @@ -1710,7 +1721,8 @@ .SH PATCHING MODULES .PP javac allows any content, whether in source or compiled form, to be -patched into any module using the \f[CB]\-\-patch\-module\f[R] option. +patched into any module using the \f[B]\f[BC]\-\-patch\-module\f[B]\f[R] +option. You may want to do this to compile alternative implementations of a class to be patched at runtime into a JVM, or to inject additional classes into the module, such as when testing. @@ -1731,9 +1743,9 @@ path and in the patched module. .PP When patching source code into more than one module, the -\f[CB]\-\-module\-source\-path\f[R] must also be used, so that the output -directory is organized in a module hierarchy, and capable of holding the -compiled class files for the modules being compiled. +\f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] must also be used, so that +the output directory is organized in a module hierarchy, and capable of +holding the compiled class files for the modules being compiled. .SH ANNOTATION PROCESSING .PP The \f[CB]javac\f[R] command provides direct support for annotation @@ -1744,11 +1756,11 @@ packages and subpackages. .SS How Annotation Processing Works .PP -Unless annotation processing is disabled with the \f[CB]\-proc:none\f[R] -option, the compiler searches for any annotation processors that are -available. -The search path can be specified with the \f[CB]\-processorpath\f[R] -option. +Unless annotation processing is disabled with the +\f[B]\f[BC]\-proc:none\f[B]\f[R] option, the compiler searches for any +annotation processors that are available. +The search path can be specified with the +\f[B]\f[BC]\-processorpath\f[B]\f[R] option. If no path is specified, then the user class path is used. Processors are located by means of service provider\-configuration files named \f[CB]META\-INF/services/javax.annotation.processing\f[R]. @@ -1756,7 +1768,7 @@ Such files should contain the names of any annotation processors to be used, listed one per line. Alternatively, processors can be specified explicitly, using the -\f[CB]\-processor\f[R] option. +\f[B]\f[BC]\-processor\f[B]\f[R] option. .PP After scanning the source files and classes on the command line to determine what annotations are present, the compiler queries the @@ -1777,15 +1789,15 @@ After a round occurs where no new source files are generated, the annotation processors are called one last time, to give them a chance to complete any remaining work. -Finally, unless the \f[CB]\-proc:only\f[R] option is used, the compiler -compiles the original and all generated source files. +Finally, unless the \f[B]\f[BC]\-proc:only\f[B]\f[R] option is used, the +compiler compiles the original and all generated source files. .PP If you use an annotation processor that generates additional source files to be included in the compilation, you can specify a default module to be used for the newly generated files, for use when a module declaration is not also generated. -In this case, use the \f[CB]\-\-default\-module\-for\-created\-files\f[R] -option. +In this case, use the +\f[B]\f[BC]\-\-default\-module\-for\-created\-files\f[B]\f[R] option. .SS Compilation Environment and Runtime Environment. .PP The declarations in source files and previously compiled class files are @@ -1807,18 +1819,17 @@ If an annotation processor has dependencies on libraries that are not in modules, the libraries can be placed, along with the annotation processor itself, on the processor path. -(See the \f[CB]\-\-processor\-path\f[R] option.) If the annotation -processor and its dependencies are in modules, you should use the -processor module path instead. -(See the \f[CB]\-\-processor\-module\-path\f[R] option.) When those are -insufficient, it may be necessary to provide further configuration of -the runtime environment. +(See the \f[B]\f[BC]\-\-processor\-path\f[B]\f[R] option.) If the +annotation processor and its dependencies are in modules, you should use +the processor module path instead. +(See the \f[B]\f[BC]\-\-processor\-module\-path\f[B]\f[R] option.) When +those are insufficient, it may be necessary to provide further +configuration of the runtime environment. This can be done in two ways: .IP "1." 3 If \f[CB]javac\f[R] is invoked from the command line, options can be passed to the underlying runtime by prefixing the option with -\f[CB]\-J\f[R]. -(See the \f[CB]\-J\f[R] option.) +\f[B]\f[BC]\-J\f[B]\f[R]. .IP "2." 3 You can start an instance of a Java Virtual Machine directly and use command line options and API to configure an environment in which @@ -1826,10 +1837,10 @@ .SH COMPILING FOR EARLIER RELEASES OF THE PLATFORM .PP \f[CB]javac\f[R] can compile code that is to be used on other releases of -the platform, using either the \f[CB]\-\-release\f[R] option, or the -\f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] and -\f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options, together with additional -options to specify the platform classes. +the platform, using either the \f[B]\f[BC]\-\-release\f[B]\f[R] option, +or the \f[B]\f[BC]\-\-source\f[B]\f[R]/\f[CB]\-source\f[R] and +\f[B]\f[BC]\-\-target\f[B]\f[R]/\f[CB]\-target\f[R] options, together with +additional options to specify the platform classes. .PP Depending on the desired platform release, there are some restrictions on some of the options that can be used. @@ -1839,11 +1850,14 @@ This includes all of the following options: .RS 2 .IP \[bu] 2 -\f[CB]\-\-module\-source\-path\f[R], \f[CB]\-\-upgrade\-module\-path\f[R], -\f[CB]\-\-system\f[R], \f[CB]\-\-module\-path\f[R], -\f[CB]\-\-add\-modules\f[R], \f[CB]\-\-add\-exports\f[R], -\f[CB]\-\-add\-opens\f[R], \f[CB]\-\-add\-reads\f[R], -\f[CB]\-\-limit\-modules\f[R], \f[CB]\-\-patch\-module\f[R] +\f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R], +\f[B]\f[BC]\-\-upgrade\-module\-path\f[B]\f[R], +\f[B]\f[BC]\-\-system\f[B]\f[R], \f[B]\f[BC]\-\-module\-path\f[B]\f[R], +\f[B]\f[BC]\-\-add\-modules\f[B]\f[R], +\f[B]\f[BC]\-\-add\-exports\f[B]\f[R], \f[CB]\-\-add\-opens\f[R], +\f[B]\f[BC]\-\-add\-reads\f[B]\f[R], +\f[B]\f[BC]\-\-limit\-modules\f[B]\f[R], +\f[B]\f[BC]\-\-patch\-module\f[B]\f[R] .PP If you use the \f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or \f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options, you should also set the @@ -1856,10 +1870,13 @@ This includes all of the following options: .RS 2 .IP \[bu] 2 -\f[CB]\-Xbootclasspath/p:\f[R], \f[CB]\-Xbootclasspath\f[R], -\f[CB]\-Xbootclasspath/a:\f[R], \f[CB]\-endorseddirs\f[R], -\f[CB]\-Djava.endorsed.dirs\f[R], \f[CB]\-extdirs\f[R], -\f[CB]\-Djava.ext.dirs\f[R], \f[CB]\-profile\f[R] +\f[B]\f[BC]\-Xbootclasspath/p:\f[B]\f[R], +\f[B]\f[BC]\-Xbootclasspath\f[B]\f[R], +\f[B]\f[BC]\-Xbootclasspath/a:\f[B]\f[R], +\f[B]\f[BC]\-endorseddirs\f[B]\f[R], +\f[B]\f[BC]\-Djava.endorsed.dirs\f[B]\f[R], +\f[B]\f[BC]\-extdirs\f[B]\f[R], \f[B]\f[BC]\-Djava.ext.dirs\f[B]\f[R], +\f[B]\f[BC]\-profile\f[B]\f[R] .PP If you use the \f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or \f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options, you should also set the --- old/src/jdk.compiler/share/man/serialver.1 2020-01-14 13:13:54.235260251 -0800 +++ new/src/jdk.compiler/share/man/serialver.1 2020-01-14 13:13:53.931246846 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "SERIALVER" "1" "2018" "JDK 13" "JDK Commands" +.TH "SERIALVER" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.hotspot.agent/share/man/jhsdb.1 2020-01-14 13:13:55.003294117 -0800 +++ new/src/jdk.hotspot.agent/share/man/jhsdb.1 2020-01-14 13:13:54.699280713 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JHSDB" "1" "2018" "JDK 13" "JDK Commands" +.TH "JHSDB" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -34,28 +34,33 @@ \f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]] .PP -\f[CB]jhsdb\f[R] \f[CB]debugd\f[R] [\f[I]options\f[R]] (\f[I]pid\f[R] | -\f[I]executable\f[R] \f[I]coredump\f[R]) [\f[I]server\-id\f[R]] -.PP \f[CB]jhsdb\f[R] \f[CB]hsdb\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | \f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]] .PP -\f[CB]jhsdb\f[R] \f[CB]jstack\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | -\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] -\f[I]coredump\f[R]] [\f[I]options\f[R]] -.PP -\f[CB]jhsdb\f[R] \f[CB]jmap\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | -\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] -\f[I]coredump\f[R]] [\f[I]options\f[R]] -.PP -\f[CB]jhsdb\f[R] \f[CB]jinfo\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | +\f[CB]jhsdb\f[R] \f[CB]debugd\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | \f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] -\f[I]coredump\f[R]] [\f[I]options\f[R]] +\f[I]coredump\f[R]) [\f[I]options\f[R]] .PP -\f[CB]jhsdb\f[R] \f[CB]jsnap\f[R] [\f[I]options\f[R]] [\f[CB]\-\-pid\f[R] -\f[I]pid\f[R] | \f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] -\f[I]coredump\f[R]] +\f[CB]jhsdb\f[R] \f[CB]jstack\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | +\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R] +| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R]) +[\f[I]options\f[R]] +.PP +\f[CB]jhsdb\f[R] \f[CB]jmap\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | +\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R] +| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R]) +[\f[I]options\f[R]] +.PP +\f[CB]jhsdb\f[R] \f[CB]jinfo\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | +\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R] +| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R]) +[\f[I]options\f[R]] +.PP +\f[CB]jhsdb\f[R] \f[CB]jsnap\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] | +\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R] +| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R]) +[\f[I]options\f[R]] .TP .B \f[I]pid\f[R] The process ID to which the \f[CB]jhsdb\f[R] tool should attach. @@ -74,12 +79,6 @@ the PID of the JVM. .RE .TP -.B \f[I]server\-id\f[R] -An optional unique ID to use when multiple debug servers are running on -the same remote host. -.RS -.RE -.TP .B \f[I]executable\f[R] The Java executable file from which the core dump was produced. .RS @@ -90,19 +89,26 @@ .RS .RE .TP +.B \f[I][server\-id\@]debugd\-host\f[R] +An optional server ID and the address of the remote debug server +(debugd). +.RS +.RE +.TP .B \f[I]options\f[R] The command\-line options for a \f[CB]jhsdb\f[R] mode. -See \f[B]Common Options for jhsdb Modes\f[R], \f[B]Options for the debugd -Mode\f[R], \f[B]Options for the jinfo Mode\f[R], \f[B]Options for the jmap -Mode\f[R], \f[B]Options for the jmap Mode\f[R], \f[B]Options for the -jstack Mode\f[R], and \f[B]Options for the jsnap Mode\f[R]. +See \f[B]Options for the debugd Mode\f[R], \f[B]Options for the jstack +Mode\f[R], \f[B]Options for the jmap Mode\f[R], \f[B]Options for the jinfo +Mode\f[R], and \f[B]Options for the jsnap Mode\f[R]. .RS .RE .PP \f[B]Note:\f[R] .PP Either the \f[I]pid\f[R] or the pair of \f[I]executable\f[R] and -\f[I]core\f[R] files must be provided. +\f[I]core\f[R] files or the \f[I][server\-id\@]debugd\-host\f[R] must be +provided for \f[CB]debugd\f[R], \f[CB]jstack\f[R], \f[CB]jmap\f[R], +\f[CB]jinfo\f[R] and \f[CB]jsnap\f[R] modes. .SH DESCRIPTION .PP You can use the \f[CB]jhsdb\f[R] tool to attach to a Java process or to @@ -124,13 +130,13 @@ .RS .RE .TP -.B \f[CB]jhsdb\ debugd\f[R] -Starts the remote debug server. +.B \f[CB]jhsdb\ hsdb\f[R] +Starts the interactive GUI debugger. .RS .RE .TP -.B \f[CB]jhsdb\ hsdb\f[R] -Starts the interactive GUI debugger. +.B \f[CB]jhsdb\ debugd\f[R] +Starts the remote debug server. .RS .RE .TP @@ -153,44 +159,19 @@ Prints performance counter information. .RS .RE -.SH COMMON OPTIONS FOR JHSDB MODES -.PP -In addition to any required \f[CB]jstack\f[R], \f[CB]jmap\f[R], -\f[CB]jinfo\f[R] or \f[CB]jsnap\f[R] mode specific options, the -\f[CB]pid\f[R], \f[CB]exe\f[R], or \f[CB]core\f[R] options must be provided -for all modes. -The following options are available for all modes. .TP -.B \f[CB]\-\-pid\f[R] -The process ID of the hanging process. -.RS -.RE -.TP -.B \f[CB]\-\-exe\f[R] -The executable file name. -.RS -.RE -.TP -.B \f[CB]\-\-core\f[R] -The core dump file name. -.RS -.RE -.TP -.B \f[CB]\-\-help\f[R] -Displays the options available for the command. +.B \f[CB]jhsdb\f[R] \f[I]command\f[R] \f[CB]\-\-help\f[R] +Displays the options available for the \f[I]command\f[R]. .RS .RE .SH OPTIONS FOR THE DEBUGD MODE .TP -.B \f[I]server\-id\f[R] +.B \f[CB]\-\-serverid\f[R] \f[I]server\-id\f[R] An optional unique ID for this debug server. This is required if multiple debug servers are run on the same machine. .RS .RE .SH OPTIONS FOR THE JINFO MODE -.PP -Without specified options, the \f[CB]jhsdb\ jinfo\f[R] prints both flags -and properties. .TP .B \f[CB]\-\-flags\f[R] Prints the VM flags. @@ -207,10 +188,6 @@ .RS .RE .SH OPTIONS FOR THE JMAP MODE -.PP -In addition to the following mode specific options, the \f[CB]pid\f[R], -\f[CB]exe\f[R], or \f[CB]core\f[R] options described in \f[B]Common Options -for jhsdb Modes\f[R] must be provided. .TP .B no option Prints the same information as Solaris \f[CB]pmap\f[R]. @@ -227,8 +204,8 @@ .RS .RE .TP -.B \f[CB]\-\-dumpfile\f[R] -Prints the name of the dumpfile. +.B \f[CB]\-\-dumpfile\f[R] \f[I]name\f[R] +The name of the dumpfile. .RS .RE .TP @@ -247,10 +224,6 @@ .RS .RE .SH OPTIONS FOR THE JSTACK MODE -.PP -In addition to the following mode specific options, the \f[CB]pid\f[R], -\f[CB]exe\f[R], or \f[CB]core\f[R] options described in \f[B]Common Options -for jhsdb Modes\f[R] must be provided. .TP .B \f[CB]\-\-locks\f[R] Prints the \f[CB]java.util.concurrent\f[R] locks information. @@ -263,10 +236,6 @@ .RS .RE .SH OPTIONS FOR THE JSNAP MODE -.PP -In addition to the following mode specific option, the \f[CB]pid\f[R], -\f[CB]exe\f[R], or \f[CB]core\f[R] options described in \f[B]Common Options -for jhsdb Modes\f[R] must be provided. .TP .B \f[CB]\-\-all\f[R] Prints all performance counters. --- old/src/jdk.jartool/share/man/jar.1 2020-01-14 13:13:55.711325338 -0800 +++ new/src/jdk.jartool/share/man/jar.1 2020-01-14 13:13:55.407311933 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JAR" "1" "2018" "JDK 13" "JDK Commands" +.TH "JAR" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jartool/share/man/jarsigner.1 2020-01-14 13:13:56.467358675 -0800 +++ new/src/jdk.jartool/share/man/jarsigner.1 2020-01-14 13:13:56.163345269 -0800 @@ -8,7 +8,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -22,7 +22,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JARSIGNER" "1" "2019" "JDK 13" "JDK Commands" +.TH "JARSIGNER" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -309,7 +309,7 @@ SHA256withDSA T} T{ -RSA \ \ \ +RSA T}@T{ <= 3072 T}@T{ --- old/src/jdk.javadoc/share/man/javadoc.1 2020-01-14 13:13:57.243392895 -0800 +++ new/src/jdk.javadoc/share/man/javadoc.1 2020-01-14 13:13:56.935379313 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JAVADOC" "1" "2018" "JDK 13" "JDK Commands" +.TH "JAVADOC" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -173,7 +173,8 @@ question mark, or exclamation point followed by a space when the next word starts with a capital letter. This is meant to handle most abbreviations (such as "The serial no. -is valid", but will not handle "Mr.\ Smith"). +is valid", but will not handle "Mr. +Smith"). The \f[CB]\-breakiterator\f[R] option doesn\[aq]t stop at HTML tags or sentences that begin with numbers or symbols. The algorithm stops at the last period in \f[CB]\&../filename\f[R], even --- old/src/jdk.jcmd/share/man/jcmd.1 2020-01-14 13:13:58.011426761 -0800 +++ new/src/jdk.jcmd/share/man/jcmd.1 2020-01-14 13:13:57.707413355 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JCMD" "1" "2018" "JDK 13" "JDK Commands" +.TH "JCMD" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -89,7 +89,7 @@ .RE .TP .B \f[CB]\-h\f[R] -Displays the\f[CB]jcmd\f[R] utility\[aq]s command\-line help. +Displays the \f[CB]jcmd\f[R] utility\[aq]s command\-line help. .RS .RE .SH DESCRIPTION @@ -249,7 +249,7 @@ .RE .TP .B \f[CB]GC.class_stats\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]] -Provide statistics about Java class meta data. +(Deprecated) Provide statistics about Java class meta data. .RS .PP Impact: High \-\-\- depends on Java heap size and content. @@ -357,38 +357,286 @@ .RE .TP .B \f[CB]JFR.check\f[R] [\f[I]options\f[R]] -See \f[B]JFR.check\f[R] -[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-DA391CC1\-B5D8\-44F1\-AEDD\-9A534C8DD009] -in the Java Flight Recorder Command Reference. +Show information about a running flight recording .RS +.PP +Impact: Low +.PP +\f[B]Note:\f[R] +.PP +The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or +\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax. +If no parameters are entered, information for all active recordings is +shown. +.PP +\f[I]options\f[R]: +.IP \[bu] 2 +\f[CB]name\f[R]: (Optional) Name of the flight recording. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]verbose\f[R]: (Optional) Flag for printing the event settings for +the recording (BOOLEAN, false) .RE .TP .B \f[CB]JFR.configure\f[R] [\f[I]options\f[R]] -See \f[B]JFR.configure\f[R] -[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-737D234E\-FD69\-4E8E\-A9F7\-06AE073648DD] -in the Java Flight Recorder Command Reference. +Set the parameters for a flight recording .RS +.PP +Impact: Low +.PP +\f[B]Note:\f[R] +.PP +The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or +\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax. +If no parameters are entered, the current settings are displayed. +.PP +\f[I]options\f[R]: +.IP \[bu] 2 +\f[CB]globalbuffercount\f[R]: (Optional) Number of global buffers. +This option is a legacy option: change the \f[CB]memorysize\f[R] parameter +to alter the number of global buffers. +This value cannot be changed once JFR has been initalized. +(STRING, default determined by the value for \f[CB]memorysize\f[R]) +.IP \[bu] 2 +\f[CB]globalbuffersize\f[R]: (Optional) Size of the global buffers, in +bytes. +This option is a legacy option: change the \f[CB]memorysize\f[R] parameter +to alter the size of the global buffers. +This value cannot be changed once JFR has been initalized. +(STRING, default determined by the value for \f[CB]memorysize\f[R]) +.IP \[bu] 2 +\f[CB]maxchunksize\f[R]: (Optional) Maximum size of an individual data +chunk in bytes if one of the following suffixes is not used: \[aq]m\[aq] +or \[aq]M\[aq] for megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for +gigabytes. +This value cannot be changed once JFR has been initialized. +(STRING, 12M) +.IP \[bu] 2 +\f[CB]memorysize\f[R]: (Optional) Overall memory size, in bytes if one of +the following suffixes is not used: \[aq]m\[aq] or \[aq]M\[aq] for +megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for gigabytes. +This value cannot be changed once JFR has been initialized. +(STRING, 10M) +.IP \[bu] 2 +\f[CB]repositorypath\f[R]: (Optional) Path to the location where +recordings are stored until they are written to a permanent file. +(STRING, The default location is the temporary directory for the +operating system. +On Linux operating systems, the temporary directory is \f[CB]/tmp\f[R]. +On Windwows, the temporary directory is specified by the \f[CB]TMP\f[R] +environment variable.) +.IP \[bu] 2 +\f[CB]stackdepth\f[R]: (Optional) Stack depth for stack traces. +Setting this value greater than the default of 64 may cause a +performance degradation. +This value cannot be changed once JFR has been initialized. +(LONG, 64) +.IP \[bu] 2 +\f[CB]thread_buffer_size\f[R]: (Optional) Local buffer size for each +thread in bytes if one of the following suffixes is not used: +\[aq]k\[aq] or \[aq]K\[aq] for kilobytes or \[aq]m\[aq] or \[aq]M\[aq] +for megabytes. +Overriding this parameter could reduce performance and is not +recommended. +This value cannot be changed once JFR has been initialized. +(STRING, 8k) +.IP \[bu] 2 +\f[CB]samplethreads\f[R]: (Optional) Flag for activating thread sampling. +(BOOLEAN, true) .RE .TP .B \f[CB]JFR.dump\f[R] [\f[I]options\f[R]] -See \f[B]JFR.dump\f[R] -[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-6EB11926\-4DAF\-4B99\-AF20\-7FCD284EE6C1] -in the Java Flight Recorder Command Reference. +Write data to a file while a flight recording is running .RS +.PP +Impact: Low +.PP +\f[B]Note:\f[R] +.PP +The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or +\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax. +No options are required. +The recording continues to run after the data is written. +.PP +\f[I]options\f[R]: +.IP \[bu] 2 +\f[CB]begin\f[R]: (Optional) Specify the time from which recording data +will be included in the dump file. +The format is specified as local time. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]end\f[R]: (Optional) Specify the time to which recording data will +be included in the dump file. +The format is specified as local time. +(STRING, no default value) +.RS 2 +.PP +\f[B]Note:\f[R] For both \f[CB]begin\f[R] and \f[CB]end\f[R], the time must +be in a format that can be read by java.time.LocalTime::parse(STRING), +java.time.LocalDateTime::parse(STRING) or +java.time.Instant::parse(STRING). +For example, "13:20:15", "2020\-03\-17T09:00:00" or +"2020\-03\-17T09:00:00Z". +.PP +\f[B]Note:\f[R] \f[CB]begin\f[R] and \f[CB]end\f[R] times correspond to the +timestamps found within the recorded information in the flight recording +data. +.PP +Another option is to use a time relative to the current time that is +specified by a negative integer followed by "s", "m" or "h". +For example, "\-12h", "\-15m" or "\-30s" +.RE +.IP \[bu] 2 +\f[CB]filename\f[R]: (Optional) Name of the file to which the flight +recording data is dumped. +If no filename is given, a filename is generated from the PID and the +current date. +The filename may also be a directory in which case, the filename is +generated from the PID and the current date in the specified directory. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]maxage\f[R]: (Optional) Length of time for dumping the flight +recording data to a file. +(INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for minutes or +\[aq]h\[aq] for hours, no default value) +.IP \[bu] 2 +\f[CB]maxsize\f[R]: (Optional) Maximum size for the amount of data to dump +from a flight recording in bytes if one of the following suffixes is not +used: \[aq]m\[aq] or \[aq]M\[aq] for megabytes OR \[aq]g\[aq] or +\[aq]G\[aq] for gigabytes. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]name\f[R]: (Optional) Name of the recording. +If no name is given, data from all recordings is dumped. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]path\-to\-gc\-root\f[R]: (Optional) Flag for saving the path to +garbage collection (GC) roots at the time the recording data is dumped. +The path information is useful for finding memory leaks but collecting +it can cause the application to pause for a short period of time. +Turn on this flag only when you have an application that you suspect has +a memory leak. +(BOOLEAN, false) .RE .TP .B \f[CB]JFR.start\f[R] [\f[I]options\f[R]] -See \f[B]JFR.start\f[R] -[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-8DC13618\-1515\-4479\-B0FC\-9F4394BE5455] -in the Java Flight Recorder Command Reference. +Start a flight recording .RS +.PP +Impact: Low +.PP +\f[B]Note:\f[R] +.PP +The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or +\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax. +If no parameters are entered, then a recording is started with default +values. +.PP +\f[I]options\f[R]: +.IP \[bu] 2 +\f[CB]delay\f[R]: (Optional) Length of time to wait before starting to +record (INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for +minutes or \[aq]h\[aq] for hours, 0s) +.IP \[bu] 2 +\f[CB]disk\f[R]: (Optional) Flag for also writing the data to disk while +recording (BOOLEAN, true) +.IP \[bu] 2 +\f[CB]dumponexit\f[R]: (Optional) Flag for writing the recording to disk +when the Java Virtual Machine (JVM) shuts down. +If set to \[aq]true\[aq] and no value is given for \f[CB]filename\f[R], +the recording is written to a file in the directory where the process +was started. +The file name is a system\-generated name that contains the process ID, +the recording ID and the current time stamp. +(For example: \f[CB]id\-1\-2019_12_12_10_41.jfr\f[R]) (BOOLEAN, false) +.IP \[bu] 2 +\f[CB]duration\f[R]: (Optional) Length of time to record. +Note that \f[CB]0s\f[R] means forever (INTEGER followed by \[aq]s\[aq] for +seconds \[aq]m\[aq] for minutes or \[aq]h\[aq] for hours, 0s) +.IP \[bu] 2 +\f[CB]filename\f[R]: (Optional) Name of the file to which the flight +recording data is written when the recording is stopped. +If no filename is given, a filename is generated from the PID and the +current date and is placed in the directory where the process was +started. +The filename may also be a directory in which case, the filename is +generated from the PID and the current date in the specified directory. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]maxage\f[R]: (Optional) Maximum time to keep the recorded data on +disk. +This parameter is valid only when the \f[CB]disk\f[R] parameter is set to +\f[CB]true\f[R]. +Note \f[CB]0s\f[R] means forever. +(INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for minutes or +\[aq]h\[aq] for hours, 0s) +.IP \[bu] 2 +\f[CB]maxsize\f[R]: (Optional) Maximum size of the data to keep on disk in +bytes if one of the following suffixes is not used: \[aq]m\[aq] or +\[aq]M\[aq] for megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for gigabytes. +This parameter is valid only when the \f[CB]disk\f[R] parameter is set to +\[aq]true\[aq]. +The value must not be less than the value for the \f[CB]maxchunksize\f[R] +parameter set with the \f[CB]JFR.configure\f[R] command. +(STRING, 0 (no maximum size)) +.IP \[bu] 2 +\f[CB]name\f[R]: (Optional) Name of the recording. +If no name is provided, a name is generated. +Make note of the generated name that is shown in the response to the +command so that you can use it with other commands. +(STRING, system\-generated default name) +.IP \[bu] 2 +\f[CB]path\-to\-gc\-root\f[R]: (Optional) Flag for saving the path to +garbage collection (GC) roots at the end of a recording. +The path information is useful for finding memory leaks but collecting +it is time consuming. +Turn on this flag only when you have an application that you suspect has +a memory leak. +If the \f[CB]settings\f[R] parameter is set to \[aq]profile\[aq], then the +information collected includes the stack trace from where the potential +leaking object was allocated. +(BOOLEAN, false) +.IP \[bu] 2 +\f[CB]settings\f[R]: (Optional) Name of the settings file that identifies +which events to record. +To specify more than one file, separate the names with a comma +(\[aq],\[aq]). +Include the path if the file is not in \f[CB]JAVA\-HOME\f[R]/lib/jfr. +The following profiles are included with the JDK in the +\f[CB]JAVA\-HOME\f[R]/lib/jfr directory: \[aq]default.jfc\[aq]: collects a +predefined set of information with low overhead, so it has minimal +impact on performance and can be used with recordings that run +continuously; \[aq]profile.jfc\[aq]: Provides more data than the +\[aq]default.jfc\[aq] profile, but with more overhead and impact on +performance. +Use this configuration for short periods of time when more information +is needed. +Use \f[CB]none\f[R] to start a recording without a predefined +configuration file. +(STRING, \f[CB]JAVA\-HOME\f[R]/lib/jfr/default.jfc) .RE .TP .B \f[CB]JFR.stop\f[R] [\f[I]options\f[R]] -See \f[B]JFR.stop\f[R] -[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-66CC94C8\-8EDF\-4BB6\-8E7A\-49973025D4D9] -in the Java Flight Recorder Command Reference. +Stop a flight recording .RS +.PP +Impact: Low +.PP +\f[B]Note:\f[R] +.PP +The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or +\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax. +If no parameters are entered, then no recording is stopped. +.PP +\f[I]options\f[R]: +.IP \[bu] 2 +\f[CB]filename\f[R]: (Optional) Name of the file to which the recording is +written when the recording is stopped. +If no path is provided, the data from the recording is discarded. +(STRING, no default value) +.IP \[bu] 2 +\f[CB]name\f[R]: (Optional) Name of the recording (STRING, no default +value) .RE .TP .B \f[CB]JVMTI.agent_load\f[R] [\f[I]arguments\f[R]] --- old/src/jdk.jcmd/share/man/jinfo.1 2020-01-14 13:13:58.799461509 -0800 +++ new/src/jdk.jcmd/share/man/jinfo.1 2020-01-14 13:13:58.495448103 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JINFO" "1" "2018" "JDK 13" "JDK Commands" +.TH "JINFO" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -29,7 +29,7 @@ process .SH SYNOPSIS .PP -\f[B]Note:\f[R] This command is experimental\ and unsupported. +\f[B]Note:\f[R] This command is experimental and unsupported. .PP \f[CB]jinfo\f[R] [\f[I]option\f[R]] \f[I]pid\f[R] .TP --- old/src/jdk.jcmd/share/man/jmap.1 2020-01-14 13:13:59.563495199 -0800 +++ new/src/jdk.jcmd/share/man/jmap.1 2020-01-14 13:13:59.259481793 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,14 +21,14 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JMAP" "1" "2018" "JDK 13" "JDK Commands" +.TH "JMAP" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP jmap \- print details of a specified process .SH SYNOPSIS .PP -\f[B]Note:\f[R] This command is experimental\ and unsupported. +\f[B]Note:\f[R] This command is experimental and unsupported. .PP \f[CB]jmap\f[R] [\f[I]options\f[R]] \f[I]pid\f[R] .TP --- old/src/jdk.jcmd/share/man/jps.1 2020-01-14 13:14:00.311528182 -0800 +++ new/src/jdk.jcmd/share/man/jps.1 2020-01-14 13:14:00.007514778 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,14 +21,14 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JPS" "1" "2018" "JDK 13" "JDK Commands" +.TH "JPS" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP jps \- list the instrumented JVMs on the target system .SH SYNOPSIS .PP -\f[B]Note:\f[R] This command is experimental\ and unsupported. +\f[B]Note:\f[R] This command is experimental and unsupported. .PP \f[CB]jps\f[R] [\f[CB]\-q\f[R]] [\f[CB]\-mlvV\f[R]] [\f[I]hostid\f[R]] .PP --- old/src/jdk.jcmd/share/man/jstack.1 2020-01-14 13:14:01.071561696 -0800 +++ new/src/jdk.jcmd/share/man/jstack.1 2020-01-14 13:14:00.771548468 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JSTACK" "1" "2018" "JDK 13" "JDK Commands" +.TH "JSTACK" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -29,7 +29,7 @@ process .SH SYNOPSIS .PP -\f[B]Note:\f[R] This command is experimental\ and unsupported. +\f[B]Note:\f[R] This command is experimental and unsupported. .PP \f[CB]jstack\f[R] [\f[I]options\f[R]] \f[I]pid\f[R] .TP --- old/src/jdk.jcmd/share/man/jstat.1 2020-01-14 13:14:01.831595209 -0800 +++ new/src/jdk.jcmd/share/man/jstat.1 2020-01-14 13:14:01.527581804 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,14 +21,14 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JSTAT" "1" "2018" "JDK 13" "JDK Commands" +.TH "JSTAT" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP jstat \- monitor JVM statistics .SH SYNOPSIS .PP -\f[B]Note:\f[R] This command is experimental\ and unsupported. +\f[B]Note:\f[R] This command is experimental and unsupported. .PP \f[CB]jstat\f[R] \f[I]generalOptions\f[R] .PP --- old/src/jdk.jconsole/share/man/jconsole.1 2020-01-14 13:14:02.603629252 -0800 +++ new/src/jdk.jconsole/share/man/jconsole.1 2020-01-14 13:14:02.299615847 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JCONSOLE" "1" "2018" "JDK 13" "JDK Commands" +.TH "JCONSOLE" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jdeps/share/man/javap.1 2020-01-14 13:14:03.363662765 -0800 +++ new/src/jdk.jdeps/share/man/javap.1 2020-01-14 13:14:03.063649537 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JAVAP" "1" "2018" "JDK 13" "JDK Commands" +.TH "JAVAP" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jdeps/share/man/jdeprscan.1 2020-01-14 13:14:04.127696456 -0800 +++ new/src/jdk.jdeps/share/man/jdeprscan.1 2020-01-14 13:14:03.819682874 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JDEPRSCAN" "1" "2018" "JDK 13" "JDK Commands" +.TH "JDEPRSCAN" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jdeps/share/man/jdeps.1 2020-01-14 13:14:04.875729440 -0800 +++ new/src/jdk.jdeps/share/man/jdeps.1 2020-01-14 13:14:04.571716034 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JDEPS" "1" "2018" "JDK 13" "JDK Commands" +.TH "JDEPS" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jdi/share/man/jdb.1 2020-01-14 13:14:05.635762953 -0800 +++ new/src/jdk.jdi/share/man/jdb.1 2020-01-14 13:14:05.327749372 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JDB" "1" "2018" "JDK 13" "JDK Commands" +.TH "JDB" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jlink/share/man/jlink.1 2020-01-14 13:14:06.387796113 -0800 +++ new/src/jdk.jlink/share/man/jlink.1 2020-01-14 13:14:06.087782885 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JLINK" "1" "2018" "JDK 13" "JDK Commands" +.TH "JLINK" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jlink/share/man/jmod.1 2020-01-14 13:14:07.143829451 -0800 +++ new/src/jdk.jlink/share/man/jmod.1 2020-01-14 13:14:06.835815869 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JMOD" "1" "2018" "JDK 13" "JDK Commands" +.TH "JMOD" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jshell/share/man/jshell.1 2020-01-14 13:14:07.903862964 -0800 +++ new/src/jdk.jshell/share/man/jshell.1 2020-01-14 13:14:07.595849382 -0800 @@ -8,7 +8,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -22,7 +22,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JSHELL" "1" "2018" "JDK 13" "JDK Commands" +.TH "JSHELL" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.jstatd/share/man/jstatd.1 2020-01-14 13:14:08.691897713 -0800 +++ new/src/jdk.jstatd/share/man/jstatd.1 2020-01-14 13:14:08.387884307 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JSTATD" "1" "2018" "JDK 13" "JDK Commands" +.TH "JSTATD" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP @@ -29,7 +29,7 @@ HotSpot VMs .SH SYNOPSIS .PP -\f[B]Note:\f[R] This command is experimental\ and unsupported. +\f[B]Note:\f[R] This command is experimental and unsupported. .PP \f[CB]jstatd\f[R] [\f[I]options\f[R]] .TP --- old/src/jdk.rmic/share/man/rmic.1 2020-01-14 13:14:09.431930344 -0800 +++ new/src/jdk.rmic/share/man/rmic.1 2020-01-14 13:14:09.127916938 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "RMIC" "1" "2018" "JDK 13" "JDK Commands" +.TH "RMIC" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- old/src/jdk.scripting.nashorn.shell/share/man/jjs.1 2020-01-14 13:14:10.183963505 -0800 +++ new/src/jdk.scripting.nashorn.shell/share/man/jjs.1 2020-01-14 13:14:09.875949923 -0800 @@ -7,7 +7,7 @@ .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" @@ -21,7 +21,7 @@ .\" .\" Automatically generated by Pandoc 2.3.1 .\" -.TH "JJS" "1" "2018" "JDK 13" "JDK Commands" +.TH "JJS" "1" "2020" "JDK 14" "JDK Commands" .hy .SH NAME .PP --- /dev/null 2019-11-20 10:47:51.674104495 -0800 +++ new/src/jdk.accessibility/share/man/jabswitch.1 2020-01-14 13:14:10.643983789 -0800 @@ -0,0 +1,63 @@ +.\" Copyright (c) 1994, 2019, 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 +.\" under the terms of the GNU General Public License version 2 only, as +.\" published by the Free Software Foundation. +.\" +.\" This code is distributed in the hope that it will be useful, but WITHOUT +.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" version 2 for more details (a copy is included in the LICENSE file that +.\" accompanied this code). +.\" +.\" You should have received a copy of the GNU General Public License version +.\" 2 along with this work; if not, write to the Free Software Foundation, +.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. +.\" +.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA +.\" or visit www.oracle.com if you need additional information or have any +.\" questions. +.\" +.\" Automatically generated by Pandoc 2.3.1 +.\" +.TH "JABSWITCH" "1" "2020" "JDK 14" "JDK Commands" +.hy +.SH NAME +.PP +jabswitch \- enable or disable the Java Access Bridge +.SH SYNOPSIS +.PP +\f[CB]jabswitch\f[R] [ \-enable|/enable | \-disable|/disable | +\-version|/version | \-?|/? +] +.SH OPTIONS +.PP +\f[CB]\-enable\f[R] or \f[CB]/enable\f[R] : Enables the Java Access Bridge +.PP +\f[CB]\-disable\f[R] or \f[CB]/disable\f[R] : Disables the Java Access +Bridge +.PP +\f[CB]\-version\f[R] or \f[CB]/version\f[R] : Displays version information +for the \f[CB]jabswitch\f[R] command. +.PP +\f[CB]\-?\f[R] or \f[CB]/?\f[R] : Displays usage information for the +\f[CB]jabswitch\f[R] command. +.SH DESCRIPTION +.PP +The \f[CB]jabswitch\f[R] command is a utility program that enables the +Java Access Bridge to be loaded by the JDK on Windows platforms. +The Java Access Bridge is used by Assistive Technologies to interact +with Java Accessibility APIs of the Java SE platform. +To have any effect, the assistive technology must support the Java +Access Bridge. +.PP +This command creates or updates a file named +\f[CB]\&.accessibility.properties\f[R], in the user\[aq]s home directory. +When selecting the \f[CB]\-enable\f[R] option, the file is populated with +the information needed to load the Java Access Bridge. +This file is then read and used in accordance with the specification of +the Java SE \f[B]\f[BC]java.awt.Toolkit.getDefaultToolkit()\f[B]\f[R] +API, on initialization. +.PP +Note: This command is only provided with JDK for Windows. --- /dev/null 2019-11-20 10:47:51.674104495 -0800 +++ new/src/jdk.incubator.jpackage/share/man/jpackage.1 2020-01-14 13:14:11.408017479 -0800 @@ -0,0 +1,483 @@ +.\" Copyright (c) 1994, 2019, 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 +.\" under the terms of the GNU General Public License version 2 only, as +.\" published by the Free Software Foundation. +.\" +.\" This code is distributed in the hope that it will be useful, but WITHOUT +.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" version 2 for more details (a copy is included in the LICENSE file that +.\" accompanied this code). +.\" +.\" You should have received a copy of the GNU General Public License version +.\" 2 along with this work; if not, write to the Free Software Foundation, +.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. +.\" +.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA +.\" or visit www.oracle.com if you need additional information or have any +.\" questions. +.\" +.\" Automatically generated by Pandoc 2.3.1 +.\" +.TH "JPACKAGE" "1" "2019" "JDK 14" "JDK Commands" +.hy +.SH NAME +.PP +jpackage \- tool for packaging self\-contained Java applications. +.SH SYNOPSIS +.PP +\f[CB]jpackage\f[R] [\f[I]options\f[R]] +.TP +.B \f[I]options\f[R] +Command\-line options separated by spaces. +See \f[B]jpackage Options\f[R]. +.RS +.RE +.SH DESCRIPTION +.PP +The \f[CB]jpackage\f[R] tool will take as input a Java application and a +Java run\-time image, and produce a Java application image that includes +all the necessary dependencies. +It will be able to produce a native package in a platform\-specific +format, such as an exe on Windows or a dmg on macOS. +Each format must be built on the platform it runs on, there is no +cross\-platform support. +The tool will have options that allow packaged applications to be +customized in various ways. +.SH JPACKAGE OPTIONS +.SS Generic Options: +.TP +.B \f[CB]\@\f[R]\f[I]filename\f[R] +Read options and/or mode from a file. +.RS +.PP +This option can be used multiple times. +.RE +.TP +.B \f[CB]\-\-type\f[R] or \f[CB]\-t\f[R] \f[I]type string\f[R] +The type of package to create +.RS +.PP +Valid values are: {"app\-image", "exe", "msi", "rpm", "deb", "pkg", +"dmg"} +.PP +If this option is not specified a platform dependent default type will +be created. +.RE +.TP +.B \f[CB]\-\-app\-version\f[R] \f[I]version\f[R] +Version of the application and/or package` +.RS +.RE +.TP +.B \f[CB]\-\-copyright\f[R] \f[I]copyright string\f[R] +Copyright for the application. +.RS +.RE +.TP +.B \f[CB]\-\-description\f[R] \f[I]description string\f[R] +Description of the application. +.RS +.RE +.TP +.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R] +Print the usage text with a list and description of each valid option +for the current platform to the output stream, and exit. +.RS +.RE +.TP +.B \f[CB]\-\-name\f[R] or \f[CB]\-n\f[R] \f[I]name\f[R] +Name of the application and/or package. +.RS +.RE +.TP +.B \f[CB]\-\-dest\f[R] or \f[CB]\-d\f[R] \f[I]output path\f[R] +Path where generated output file is placed +.RS +.PP +Defaults to the current working directory. +(absolute path or relative to the current directory). +.RE +.TP +.B \f[CB]\-\-temp\f[R] \f[I]file path\f[R] +Path of a new or empty directory used to create temporary files +(absolute path or relative to the current directory). +.RS +.PP +If specified, the temp dir will not be removed upon the task completion +and must be removed manually. +.PP +If not specified, a temporary directory will be created and removed upon +the task completion. +.RE +.TP +.B \f[CB]\-\-vendor\f[R] \f[I]vendor string\f[R] +Vendor of the application. +.RS +.RE +.TP +.B \f[CB]\-\-verbose\f[R] +Enables verbose output. +.RS +.RE +.TP +.B \f[CB]\-\-version\f[R] +Print the product version to the output stream and exit. +.RS +.RE +.SS Options for creating the runtime image: +.TP +.B \f[CB]\-\-add\-modules\f[R] \f[I]module name\f[R] [\f[CB],\f[R]\f[I]module name\f[R]...] +A comma (",") separated list of modules to add. +.RS +.PP +This module list, along with the main module (if specified) will be +passed to jlink as the \-\-add\-module argument. +If not specified, either just the main module (if \-\-module is +specified), or the default set of modules (if \-\-main\-jar is +specified) are used. +.PP +This option can be used multiple times. +.RE +.TP +.B \f[CB]\-\-module\-path\f[R] or \f[CB]\-p\f[R] \f[I]module path\f[R]... +A File.pathSeparator separated list of paths. +.RS +.PP +Each path is either a directory of modules or the path to a modular jar, +and is absolute or relative to the current directory. +.PP +This option can be used multiple times. +.RE +.TP +.B \f[CB]\-\-bind\-services\f[R] +Pass on \-\-bind\-services option to jlink (which will link in service +provider modules and their dependences). +.RS +.RE +.TP +.B \f[CB]\-\-runtime\-image\f[R] \f[I]file path\f[R] +Path of the predefined runtime image that will be copied into the +application image (absolute path or relative to the current directory). +.RS +.PP +If \-\-runtime\-image is not specified, jpackage will run jlink to +create the runtime image using options: \-\-strip\-debug, +\-\-no\-header\-files, \-\-no\-man\-pages, and +\-\-strip\-native\-commands. +.RE +.SS Options for creating the application image: +.TP +.B \f[CB]\-\-icon\f[R] \f[I]icon file path\f[R] +Path of the icon of the application bundle (absolute path or relative to +the current directory). +.RS +.RE +.TP +.B \f[CB]\-\-input\f[R] or \f[CB]\-i\f[R] \f[I]input path\f[R] +Path of the input directory that contains the files to be packaged +(absolute path or relative to the current directory). +.RS +.PP +All files in the input directory will be packaged into the application +image. +.RE +.SS Options for creating the application launcher(s): +.TP +.B \f[CB]\-\-add\-launcher\f[R] \f[I]launcher name\f[R]=\f[I]file path\f[R] +Name of launcher, and a path to a Properties file that contains a list +of key, value pairs (absolute path or relative to the current +directory). +.RS +.PP +The keys "module", "add\-modules", "main\-jar", "main\-class", +"arguments", "java\-options", "app\-version", "icon", and "win\-console" +can be used. +.PP +These options are added to, or used to overwrite, the original command +line options to build an additional alternative launcher. +The main application launcher will be built from the command line +options. +Additional alternative launchers can be built using this option, and +this option can be used multiple times to build multiple additional +launchers. +.RE +.TP +.B \f[CB]\-\-arguments\f[R] \f[I]main class arguments\f[R] +Command line arguments to pass to the main class if no command line +arguments are given to the launcher. +.RS +.PP +This option can be used multiple times. +.RE +.TP +.B \f[CB]\-\-java\-options\f[R] \f[I]java options\f[R] +Options to pass to the Java runtime. +.RS +.PP +This option can be used multiple times. +.RE +.TP +.B \f[CB]\-\-main\-class\f[R] \f[I]class name\f[R] +Qualified name of the application main class to execute. +.RS +.PP +This option can only be used if \-\-main\-jar is specified. +.RE +.TP +.B \f[CB]\-\-main\-jar\f[R] \f[I]main jar file\f[R] +The main JAR of the application; containing the main class (specified as +a path relative to the input path). +.RS +.PP +Either \-\-module or \-\-main\-jar option can be specified but not both. +.RE +.TP +.B \f[CB]\-\-module\f[R] or \f[CB]\-m\f[R] \f[I]module name\f[R]/\f[I]main class\f[R]] +The main module (and optionally main class) of the application This +module must be located on the module path. +.RS +.PP +When this option is specified, the main module will be linked in the +Java runtime image. +Either \-\-module or \-\-main\-jar option can be specified but not both. +.RE +.SS Platform dependent option for creating the application launcher: +.SS Windows platform options (available only when running on Windows): +.TP +.B \f[CB]\-\-win\-console\f[R] +Creates a console launcher for the application, should be specified for +application which requires console interactions +.RS +.RE +.SS macOS platform options (available only when running on macOS): +.TP +.B \f[CB]\-\-mac\-package\-identifier\f[R] \f[I]ID string\f[R] +An identifier that uniquely identifies the application for macOSX. +.RS +.PP +Defaults to the the main class name. +.PP +May only use alphanumeric (A\-Z,a\-z,0\-9), hyphen (\-), and period (.) +characters. +.RE +.TP +.B \f[CB]\-\-mac\-package\-name\f[R] \f[I]name string\f[R] +Name of the application as it appears in the Menu Bar. +.RS +.PP +This can be different from the application name. +.PP +This name must be less than 16 characters long and be suitable for +displaying in the menu bar and the application Info window. +Defaults to the application name. +.RE +.TP +.B \f[CB]\-\-mac\-bundle\-signing\-prefix\f[R] \f[I]prefix string\f[R] +When signing the application bundle, this value is prefixed to all +components that need to be signed that don\[aq]t have an existing bundle +identifier. +.RS +.RE +.TP +.B \f[CB]\-\-mac\-sign\f[R] +Request that the bundle be signed. +.RS +.RE +.TP +.B \f[CB]\-\-mac\-signing\-keychain\f[R] \f[I]file path\f[R] +Path of the keychain to search for the signing identity (absolute path +or relative to the current directory). +.RS +.PP +If not specified, the standard keychains are used. +.RE +.TP +.B \f[CB]\-\-mac\-signing\-key\-user\-name\f[R] \f[I]team name\f[R] +Team name portion in Apple signing identities\[aq] names. +.RS +.PP +For example "Developer ID Application: " +.RE +.SS Options for creating the application package: +.TP +.B \f[CB]\-\-app\-image\f[R] \f[I]file path\f[R] +Location of the predefined application image that is used to build an +installable package (absolute path or relative to the current +directory). +.RS +.PP +See create\-app\-image mode options to create the application image. +.RE +.TP +.B \f[CB]\-\-file\-associations\f[R] \f[I]file path\f[R] +Path to a Properties file that contains list of key, value pairs +(absolute path or relative to the current directory). +.RS +.PP +The keys "extension", "mime\-type", "icon", and "description" can be +used to describe the association. +.PP +This option can be used multiple times. +.RE +.TP +.B \f[CB]\-\-install\-dir\f[R] \f[I]file path\f[R] +Absolute path of the installation directory of the application on OS X +or Linux. +Relative sub\-path of the installation location of the application such +as "Program Files" or "AppData" on Windows. +.RS +.RE +.TP +.B \f[CB]\-\-license\-file\f[R] \f[I]file path\f[R] +Path to the license file (absolute path or relative to the current +directory). +.RS +.RE +.TP +.B \f[CB]\-\-resource\-dir\f[R] \f[I]path\f[R] +Path to override jpackage resources (absolute path or relative to the +current directory). +.RS +.PP +Icons, template files, and other resources of jpackage can be +over\-ridden by adding replacement resources to this directory. +.RE +.TP +.B \f[CB]\-\-runtime\-image\f[R] \f[I]file\-path\f[R] +Path of the predefined runtime image to install (absolute path or +relative to the current directory). +.RS +.PP +Option is required when creating a runtime installer. +.RE +.SS Platform dependent options for creating the application package: +.SS Windows platform options (available only when running on Windows): +.TP +.B \f[CB]\-\-win\-dir\-chooser\f[R] +Adds a dialog to enable the user to choose a directory in which the +product is installed. +.RS +.RE +.TP +.B \f[CB]\-\-win\-menu\f[R] +Adds the application to the system menu. +.RS +.RE +.TP +.B \f[CB]\-\-win\-menu\-group\f[R] \f[I]menu group name\f[R] +Start Menu group this application is placed in. +.RS +.RE +.TP +.B \f[CB]\-\-win\-per\-user\-install\f[R] +Request to perform an install on a per\-user basis. +.RS +.RE +.TP +.B \f[CB]\-\-win\-shortcut\f[R] +Creates a desktop shortcut for the application. +.RS +.RE +.TP +.B \f[CB]\-\-win\-upgrade\-uuid\f[R] \f[I]id string\f[R] +UUID associated with upgrades for this package. +.RS +.RE +.SS Linux platform options (available only when running on Linux): +.TP +.B \f[CB]\-\-linux\-package\-name\f[R] \f[I]package name\f[R] +Name for Linux package, defaults to the application name. +.RS +.RE +.TP +.B \f[CB]\-\-linux\-deb\-maintainer\f[R] \f[I]email address\f[R] +Maintainer for .deb bundle. +.RS +.RE +.TP +.B \f[CB]\-\-linux\-menu\-group\f[R] \f[I]menu\-group\-name\f[R] +Menu group this application is placed in. +.RS +.RE +.TP +.B \f[CB]\-\-linux\-package\-deps\f[R] +Required packages or capabilities for the application +.RS +.RE +.TP +.B \f[CB]\-\-linux\-rpm\-license\-type\f[R] \f[I]type string\f[R] +Type of the license ("License: " of the RPM .spec). +.RS +.RE +.TP +.B \f[CB]\-\-linux\-app\-release\f[R] \f[I]release string\f[R] +Release value of the RPM .spec file or Debian revision value of the DEB +control file. +.RS +.RE +.TP +.B \f[CB]\-\-linux\-app\-category\f[R] \f[I]category string\f[R] +Group value of the RPM .spec file or Section value of DEB control file. +.RS +.RE +.TP +.B \f[CB]\-\-linux\-shortcut\f[R] +Creates a shortcut for the application +.RS +.RE +.SH JPACKAGE EXAMPLES +.IP +.nf +\f[CB] +Generate\ an\ application\ package\ suitable\ for\ the\ host\ system: +\f[R] +.fi +.IP +.nf +\f[CB] +For\ a\ modular\ application: +\ \ \ \ jpackage\ \-n\ name\ \-p\ modulePath\ \-m\ moduleName/className +For\ a\ non\-modular\ application: +\ \ \ \ jpackage\ \-i\ inputDir\ \-n\ name\ \\ +\ \ \ \ \ \ \ \ \-\-main\-class\ className\ \-\-main\-jar\ myJar.jar +From\ a\ pre\-built\ application\ image: +\ \ \ \ jpackage\ \-n\ name\ \-\-app\-image\ appImageDir +\f[R] +.fi +.IP +.nf +\f[CB] +Generate\ an\ application\ image: +\f[R] +.fi +.IP +.nf +\f[CB] +For\ a\ modular\ application: +\ \ \ \ jpackage\ \-\-type\ app\-image\ \-n\ name\ \-p\ modulePath\ \\ +\ \ \ \ \ \ \ \ \-m\ moduleName/className +For\ a\ non\-modular\ application: +\ \ \ \ jpackage\ \-\-type\ app\-image\ \-i\ inputDir\ \-n\ name\ \\ +\ \ \ \ \ \ \ \ \-\-main\-class\ className\ \-\-main\-jar\ myJar.jar +To\ provide\ your\ own\ options\ to\ jlink,\ run\ jlink\ separately: +\ \ \ \ jlink\ \-\-output\ appRuntimeImage\ \-p\ modulePath\ \-m\ moduleName\ \\ +\ \ \ \ \ \ \ \ \-\-no\-header\-files\ [...] +\ \ \ \ jpackage\ \-\-type\ app\-image\ \-n\ name\ \\ +\ \ \ \ \ \ \ \ \-m\ moduleName/className\ \-\-runtime\-image\ appRuntimeImage +\f[R] +.fi +.IP +.nf +\f[CB] +Generate\ a\ Java\ runtime\ package: +\f[R] +.fi +.IP +.nf +\f[CB] +jpackage\ \-n\ name\ \-\-runtime\-image\ +\f[R] +.fi