RFR: 8280543: Update the "java" and "jcmd" tool specification for CDS [v2]

Ioi Lam iklam at openjdk.java.net
Mon Jan 31 21:35:48 UTC 2022


> The discussion of CDS in the man pages need to be cleaned up and updated to match the latest functionalities and intended usage. 
> 
> For java.md:
> 
> - Reorganized the flow of the doc: Overview -> How to use -> How to create -> Restrictions and notes. I think this will be easier to read.
> - Added information about `jcmd VM.cds static_dump|dynamic_dump`
> - Removed a few sections that are no longer relevant or are uncommon usage (config files, sharing across two different apps)
> - Removed discussion of uncommon error conditions (such as array classes)
> - Removed detailed error messages. I think a simple note like "unsupported" will be good enough for readers of the man page.
> - Removed discussion of different version of JDK (these should have been in release note)
> 
> For jcmd.md:
> 
> - Added some more details about default file name and output directory.
> 
> For ease of reviewing, please see the pre-rendered HTML pages:
> 
> http://cr.openjdk.java.net/~iklam/jdk19/8280543-update-java-and-jcmd-manpage-for-cds2/specs/man/

Ioi Lam has updated the pull request incrementally with one additional commit since the last revision:

  Fixed copyright year for jcmd.1

-------------

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/7255/files
  - new: https://git.openjdk.java.net/jdk/pull/7255/files/edb42155..120e4f86

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=7255&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=7255&range=00-01

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk/pull/7255.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/7255/head:pull/7255

PR: https://git.openjdk.java.net/jdk/pull/7255


More information about the serviceability-dev mailing list