RFR: 8276265: jcmd man page is outdated
Thomas Stuefe
stuefe at openjdk.java.net
Wed Nov 10 06:47:39 UTC 2021
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
More information about the serviceability-dev
mailing list