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

[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/7bb6ff16..c74c4824

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

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 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