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

[Thomas Schatzl]

On Thu, 28 Aug 2025 08:07:58 GMT, Jonas Norlinder <duke at openjdk.org> wrote:

>> 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. The default value is 200 milliseconds.
>>     Currently only G1 supports a maximum GC pause time target.
>> 
>> 
>> 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.
>
>> The specified value doesn't adapt to your heap size.
> 
> Should we consider putting this last as that seems like a less important implementation detail compared to which GC support it and the default value?

Actually we can leave this sentence completely out.

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

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