--- old/modules/graphics/src/main/java/javafx/scene/SubScene.java	2013-12-05 16:40:11.385185800 -0800
+++ new/modules/graphics/src/main/java/javafx/scene/SubScene.java	2013-12-05 16:40:10.921159200 -0800
@@ -62,6 +62,11 @@
 /**
  * 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 {