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

[Kevin Rushforth]

On Tue, 7 Feb 2023 19:31:58 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

>> I never understood when something should be logged vs. printed. And do we ever print to `out`?
>
> I wish we were using logging...

We aren't very consistent on this. Most of the places where we produce warnings, or where we provide verbose output, are done by printing. At a minimum, those should go to `System.err` rather than `System.out`. Unless there is an API whose expected result is to print something to `System.out`, a library really shouldn't print to System.out (as opposed to a test or a demo app, where it's fine). So the only places I would expect to see it in the library -- meaning source code under `modules/javafx.*/src/main/java/` -- would be in examples in javadoc comments.

We could file a second follow-up issue (RFE) to consider changing some of our print statements to use logging.

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

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