[jfx15] RFR: 8246343: Fix mistakes in FX API docs [v4]

[Nir Lisker]

> Fixes https://bugs.openjdk.java.net/browse/JDK-8246343 and some additional fixes in the vicinity.

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

  Addressed review comments

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

Changes:
  - all: https://git.openjdk.java.net/jfx/pull/274/files
  - new: https://git.openjdk.java.net/jfx/pull/274/files/141e78f1..7bb6ff16

Webrevs:
 - full: https://webrevs.openjdk.java.net/jfx/274/webrev.03
 - incr: https://webrevs.openjdk.java.net/jfx/274/webrev.02-03

  Stats: 6 lines in 3 files changed: 2 ins; 0 del; 4 mod
  Patch: https://git.openjdk.java.net/jfx/pull/274.diff
  Fetch: git fetch https://git.openjdk.java.net/jfx pull/274/head:pull/274

PR: https://git.openjdk.java.net/jfx/pull/274