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

[Serguei Spitsyn]

On Fri, 28 Jan 2022 01:53:09 GMT, Ioi Lam <iklam at openjdk.org> wrote:

> 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/

The jcmd update looks good.
Thanks,
Serguei

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

Marked as reviewed by sspitsyn (Reviewer).

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