RFR: 8276265: jcmd man page is outdated

[Thomas Stuefe]

On Fri, 5 Nov 2021 06:19:56 GMT, David Holmes <dholmes at openjdk.org> wrote:

> It was noticed that a number of updates to the jcmd subcommands (some new, some modified) had not been added to the manpage. The text was supplied by @tstuefe - thanks Thomas. I applied the changes to the closed markdown sources and regenerated the nroff file. For easier review I have generated a html version that can be viewed here:

Your link did not work, I generated them and put them here for reviewer convenience: https://gist.github.com/tstuefe/8bd16a64061537d23e9ee556c7bd2965

Looks good. Most of the commands are ours (SAPs), but I had no idea that man pages existed.

> 
> There are further improvements that could be made, some mentioned in the bug report. I also noticed a general confusion between arguments and options with some subcommands, but I did not try to address that.
> 

jcmd commands in general feel a bit anarchic. Different styles etc. But I fear that cannot be changed because of backward compatibility.

Thanks, Thomas

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

Marked as reviewed by stuefe (Reviewer).

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