RFR: 8366157: Clarify in man pages that only G1 supports MaxGCPauseMillis

[Thomas Schatzl]

On Tue, 26 Aug 2025 11:25:17 GMT, Jonas Norlinder <duke at openjdk.org> wrote:

> Hi all,
> 
> This patch clarifies the description of `MaxGCPauseMillis`.

src/java.base/share/man/java.md line 2507:

> 2505:     specified value doesn't adapt to your heap size. G1's default for the
> 2506:     maximum pause time target is 200 milliseconds and only G1 currently supports
> 2507:     a maximum GC pause time target.

Suggestion:

    specified value doesn't adapt to your heap size.
    Currently only G1 supports a maximum GC pause time target. The default value
    is 200 milliseconds.


Reason for this suggestion:
* it seems more important that only G1 supports this value than the default value, so put this first
* these are two separate statements, so put them into two separate sentences. The default value is also independent of the collector.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/26940#discussion_r2306431827