[jfx20] RFR: 8293587: Fix mistakes in FX API docs [v5]

[Nir Lisker]

> Fixes and cleanup in the areas in the linked issue.

Nir Lisker has updated the pull request incrementally with one additional commit since the last revision:

  Addressed review comments

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

Changes:
  - all: https://git.openjdk.org/jfx/pull/1025/files
  - new: https://git.openjdk.org/jfx/pull/1025/files/a5632000..328bdebc

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jfx&pr=1025&range=04
 - incr: https://webrevs.openjdk.org/?repo=jfx&pr=1025&range=03-04

  Stats: 5 lines in 2 files changed: 4 ins; 0 del; 1 mod
  Patch: https://git.openjdk.org/jfx/pull/1025.diff
  Fetch: git fetch https://git.openjdk.org/jfx pull/1025/head:pull/1025

PR: https://git.openjdk.org/jfx/pull/1025