--- old/modules/graphics/src/main/java/javafx/scene/Scene.java	2013-12-05 16:40:04.893814500 -0800
+++ new/modules/graphics/src/main/java/javafx/scene/Scene.java	2013-12-05 16:40:04.425787700 -0800
@@ -164,6 +164,11 @@
  * size based on the preferred size of its content. If only one dimension is specified,
  * the other dimension is computed using the specified dimension, respecting content bias
  * of a root.
+ * 
+ * <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.
  *
  * <p>
  * Scene objects must be constructed and modified on the