RFR: 8323546: Clarify docs for Compiler.perfmap filename parameter, and other misc related jcmd doc cleanups [v4]

[Chris Plummer]

On Mon, 15 Jan 2024 01:31:33 GMT, David Holmes <dholmes at openjdk.org> wrote:

> > > And I still think the VM.CDS change show have its own issue (if not PR).
> > 
> > 
> > Yes, and I asked why that is the case. The VM.cds changes are very much related to the Compiler.perfmap changes. I think it's actually correct to do them together, not just easier.
> 
> And I gave an answer. At a minimum if you insist of doing these two distinct updates together then the JBS issue needs a new title and description.

Sorry I missed your response, although I still honestly don't know when/where it was. I looked throughout this PR and the CR and don't see any suggestion to update the synopsis, but certainly that is needed. I'll take care of it once we've settled the other issues in this PR.

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

PR Comment: https://git.openjdk.org/jdk/pull/17359#issuecomment-1892978142