     
     /**
      *  Removes a visual element from the specified index position 
-     *  in the visual container.
+     *  in the container.
+     *  The index positions of any elements 
+     *  above the element in this visual container are decreased by 1.
      *
      *  @param index The index of the element to remove.
      *
-     *  @return The element removed from the visual container.
+     *  @return The element removed.
      * 
      *  @throws RangeError If the index does not exist in the child list.
      *  

    function get numElements():int;
    
    /**
     *  Returns the visual element that exists at the specified index.
     *
     *  @param index The index of the element to retrieve.
     *

    /**
     *  Returns the index position of a visual element.
     *
     *  @param element The visual element.
     *
     *  @return The index position of the element in the container.
     * 
     *  @throws ArgumentError If the element is not a child of this visual container.
     *  
