RFR: 8246037: Shenandoah: update man pages to mention -XX:+UseShenandoahGC [v2]

[Y. Srinivas Ramakrishna]

On Mon, 25 Aug 2025 23:00:07 GMT, Rui Li <duke at openjdk.org> wrote:

>> src/java.base/share/man/java.md line 2899:
>> 
>>> 2897: 
>>> 2898:     `satb`
>>> 2899:     :   Snapshot-at-the-beginning concurrent GC (three pass mark-evac-update).
>> 
>> This is a long-standing problem with the name. It kinda implies `generational` is not `satb`. It actually is. Maybe we should rename `satb` to `single` or something. A lot of bikeshedding would ensue.
>
> Renaming the value of an existing jvm arg sounds intrusive, unless we can add an alias link from `satb` to `single`? Alternatively, we probably can add comment in generational to indicate it's also satb?

I agree. For non-experimental options, we can follow the established deprecate & rename protocol.

May be we could, in the inerim, add verbage in the description to avoid the confusion in the current naming as described by Aleksey.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/26907#discussion_r2299461882