(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). https://javafx-jira.kenai.com/browse/RT-19968 -- Kevin