Javadoc - mentioned that components must notify their Root when they are

attached/detached

diff --git a/src/com/vaadin/ui/Component.java b/src/com/vaadin/ui/Component.java
index ae6fcd937816a7fba07fac7002a7ace88fd34931..c0c43fcec3d9bd7cd37d67a5ad5615e29cb73640 100644 (file)
--- a/src/com/vaadin/ui/Component.java
+++ b/src/com/vaadin/ui/Component.java
@@ -329,7 +329,6 @@ public interface Component extends ClientConnector, Paintable, VariableOwner,
      * is attached to the application, {@link #detach()} is called for the
      * component.
      * </p>
-     * 
      * <p>
      * This method is rarely called directly. The
      * {@link ComponentContainer#addComponent(Component)} method is normally
@@ -620,6 +619,11 @@ public interface Component extends ClientConnector, Paintable, VariableOwner,
      * application, the {@code attach()} is called immediately from
      * {@link #setParent(Component)}.
      * </p>
+     * <p>
+     * This method must call {@link Root#componentAttached(Component)} to let
+     * the Root know that a new Component has been attached.
+     * </p>
+     * 
      * 
      * <pre>
      * public class AttachExample extends CustomComponent {
@@ -655,6 +659,11 @@ public interface Component extends ClientConnector, Paintable, VariableOwner,
      * </p>
      * 
      * <p>
+     * This method must call {@link Root#componentDetached(Component)} to let
+     * the Root know that a new Component has been attached.
+     * </p>
+     * *
+     * <p>
      * The caller of this method is {@link #setParent(Component)} if the parent
      * is in the application. When the parent is detached from the application
      * it is its response to call {@link #detach()} for all the children and to