RFR: 8293040: Argfile documentation for java launcher tool is confusing regarding usage of wildcards

[Jaikiran Pai]

On Mon, 18 Nov 2024 15:22:59 GMT, Christian Stein <cstein at openjdk.org> wrote:

> Please review this improvement to the manual page covering the usage of wildcards in `java`'s argfiles.

Hello Christian, one part of the confusion noted in that linked issue https://bugs.openjdk.org/browse/JDK-8293040 is:

>  Wildcards (*) aren't allowed in these lists (such as specifying *.java).

is noted in the section which describes the contents of the argument files for `java`. As noted in the issue, this sentence doesn't appear to be conveying the right meaning because wildcard literal like `-Xlog:gc*=info,heap*=info` I believe is allowed in those files.

I see that the changes in this PR didn't address that sentence. Was that intentional?

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

PR Comment: https://git.openjdk.org/jdk/pull/22208#issuecomment-2484700075