RFR: 8346477: Clarify the Java manpage in relation to the JVM's OnOutOfMemoryError flags [v2]

[David Holmes]

On Thu, 19 Dec 2024 07:56:05 GMT, Thomas Stuefe <stuefe at openjdk.org> wrote:

>> Thanks for taking a look @tstuefe. I realize it is not at all obvious when exceptions originate from the VM, but the intent was to make it clear(er) (and I seem to have failed :) ) that if you ever see `throw new OutOfMemoryError()` then that is definitely NOT one that comes from the VM.
>
> We don't need a 100% text. Mentioning self-thrown OOMEs and Thread creation OOMs as exceptions should cover almost all cases I know of where customers were puzzled.
> 
> "This applies only to Out-Of-Memory errors caused by Java Heap exhaustion; it does not apply to OOMEs thrown by user code, nor OOMEs caused by other types of resource exhaustion (e.g. thread creation errors)."

Okay I have revised in the manner suggested. Thanks

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

PR Review Comment: https://git.openjdk.org/jdk/pull/22802#discussion_r1893162956