modules/graphics/src/main/java/javafx/scene/SubScene.java

*** 60,69 ****
--- 60,74 ----
  import sun.util.logging.PlatformLogger;
  
  /**
   * The {@code SubScene} class is the container for content in a scene graph.
   *
+  * <p>
+  * A default headlight will be added to a scene that contains {@code Shape3D}
+  * but without light source. This light source is a {@code Color.WHITE}
+  * {@code PointLight} placed at the camera position.
+  *
   * @since JavaFX 8.0
   */
  public class SubScene extends Node {
  
      /**