On Thu, 27 Mar 2025 22:19:29 GMT, Martin Fox <m...@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
