RFR: 8351733: Crash when creating too many nested event loops [v3]

[Michael Strauß]

On Thu, 27 Mar 2025 22:19:29 GMT, Martin Fox <mfox at openjdk.org> wrote:

> The docs on `canStartNestedEventLoop` describe its behavior already. I'm not sure what further information would be useful. Would it be enough to add a see also link?

The exception being thrown is a behavior of `enterNestedEventLoop()`, and should therefore be documented with this method (`@see` is not enough). While that is done now with the `@throws` javadoc tag, I think it wouldn't hurt to be more explicit about that; much in the same way as the javadoc summary already contains an explicit description of the preconditions of calling the method.

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

PR Comment: https://git.openjdk.org/jfx/pull/1741#issuecomment-2760287067