Update Hierarchical container JavaDocs to match code (#5864)

Change-Id: I7a8520ef61ddc4dff66c326d61acbf7ccf0e76cd

diff --git a/server/src/main/java/com/vaadin/data/Container.java b/server/src/main/java/com/vaadin/data/Container.java
index 6832a57b061f2a4f0fbe2ff9de25f75cd1a9c1a9..42c51ab41ed6b18b4aa70327956dd5da04b46782 100644 (file)
--- a/server/src/main/java/com/vaadin/data/Container.java
+++ b/server/src/main/java/com/vaadin/data/Container.java
@@ -665,7 +665,8 @@ public interface Container extends Serializable {
          *            ID of the Item whose children the caller is interested in
          * @return An unmodifiable {@link java.util.Collection collection}
          *         containing the IDs of all other Items that are children in
-         *         the container hierarchy
+         *         the container hierarchy; {@code null} if item does not have
+         *         any children.
          */
         public Collection<?> getChildren(Object itemId);
 
@@ -760,9 +761,8 @@ public interface Container extends Serializable {
         /**
          * Tests if the Item specified with <code>itemId</code> is a root Item.
          * The hierarchical container can have more than one root and must have
-         * at least one unless it is empty. The
-         * {@link #getParent(Object itemId)} method always returns
-         * <code>null</code> for root Items.
+         * at least one unless it is empty. The {@link #getParent(Object itemId)}
+         * method always returns <code>null</code> for root Items.
          *
          * @param itemId
          *            ID of the Item whose root status is to be tested
@@ -1249,7 +1249,6 @@ public interface Container extends Serializable {
          *             {@link #removePropertySetChangeListener(PropertySetChangeListener)}
          **/
         @Deprecated
-        public void removeListener(
-                Container.PropertySetChangeListener listener);
+        public void removeListener(Container.PropertySetChangeListener listener);
     }
 }