RFR: JDK-8312058: Documentation improvements for subscription based listeners

Fri Jul 14 13:19:08 UTC 2023

On Thu, 13 Jul 2023 21:13:06 GMT, John Hendrikx <jhendrikx at openjdk.org> wrote:

> Incorporates documentation review comments from #1069.
> 
> This PR should be kept minimal so it can be backported to JFX21; it should only contain documentation changes.

These changes look good to me, pending the addition of the `@implSpec` as noted by @nlisker 

If we decide to move the Subscription class to `javafx.util`, additional changes would be done as part of that fix (which would need a CSR).

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

PR Review: https://git.openjdk.org/jfx/pull/1177#pullrequestreview-1530290673