(note that review comments should go into the JIRA)

Hi John,

You raise a good point about possibly moving the runtime initialization section. Perhaps it's worth a follow-up JIRA for FX 8u20 or 9 to address this. One possibility is to have most of the documentation in the Application class, and then refer to it from Platform, JFXPanel, and FXCanvas.

-- Kevin

John Smith wrote:
The comments around application runtime initialization seem like they belong 
more properly in the application lifecycle javadoc for the Application class 
rather than on the Platform.runLater method specifically, though I do see how 
the runtime initialization cuts across multiple classes 
(Application/JFXPanel/FXCanvas, etc), so perhaps it is OK having the 
description where it is (lacking some better place to put it).  Useful 
information though, thanks for including it.

+ *For standard JavaFX applications that extend
+ * {@see Application}, and use either the Java launcher or one of the
+ * launch methods in the Application class to launch the application,
+ * the FX runtime is initialized by the launcher before the Application
+ * class is loaded.
+ * For Swing applications that use JFXPanel to display FX content, the FX
+ * runtime is initialized when the first JFXPanel instance is constructed.
+ * For SWT application that use FXCanvas to display FX content, the FX
+ * runtime is initialized when the first FXCanvas instance is constructed.

-----Original Message-----
From: openjfx-dev-boun...@openjdk.java.net 
[mailto:openjfx-dev-boun...@openjdk.java.net] On Behalf Of Kevin Rushforth
Sent: Monday, December 09, 2013 3:43 PM
To: Anthony Petrov
Cc: openjfx-dev@openjdk.java.net
Subject: 8 post-commit review request: RT-19968: Document that 
Platform.runLater must not be called before FX is initialized

Please review the following javadoc change (post-commit).


-- Kevin

Reply via email to