RFR: 8369573: Add missing compile commands help documentation for the signature part of method patterns

[Daniel Lundén]

On Wed, 15 Oct 2025 08:48:36 GMT, Anton Seoane Ampudia <aseoane at openjdk.org> wrote:

> As a side note, looking at your line splits I got curious whether we are actively enforcing an 80-char limit in some output or not (the last two "paragraphs" exceed this size, although they've been there from before)

I had closer look, and it seems we try to not exceed 80 characters, but occasionally do if it helps readability. For example, run `java` without arguments and look at the default help message.

> Thanks for doing this, Daniel! Would it be possible to use the more precise term "method descriptor" instead of "signature" in the help message?

Yes, I agree and did consider this as well after consulting the JVM spec. I let "signature" remain as that is what is used currently and also seems to be the terminology used in the code. I'll wait a bit for more comments before committing to changing it.

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

PR Comment: https://git.openjdk.org/jdk/pull/27818#issuecomment-3406988516