      *  To reevaluate the shared sequences, call the parent <code>Group</code>
      *  <code>graphicElementLayerChanged()</code> method.
      *
-     *  To force the <code>Group</code> to discard the element's current
-     *  <code>DisplayObject</code> call the parent <code>Group</code>
+     *  To force the <code>Group</code> to remove the element's current
+     *  <code>DisplayObject</code> from its display list and recalculate the
+     *  display object sharing, call the parent <code>Group</code>
      *  <code>discardDisplayObject()</code> method.
      *
      *  @return The display object created

     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */
    function validateSize(recursive:Boolean = false):void;
    
    /**
     *  Called by the parent <code>Group</code> to redraw this element
     *  in its <code>displayObject</code> property.
     *
     *  <p>If the element is the first in the sequence (<code>shareIndex</code>
     *  is less than or equal to zero) it must clear the <code>displayObject</code>
     *  graphics and set it up as necessary for drawing the rest of the elements.</p>
     *

     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */
    function setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean;
    
    /**
     *  Return true if this <code>IGraphicElement</code> is compatible and can
     *  share display objects with the previous <code>IGraphicElement</code>
     *  in the sequence.
     * 
     *  <p>Note that in certain cases the element may be passed offered the parent
     *  <code>Group</code> itself in a call to <code>setSharedDisplayObject</code>.
     *  In those cases, this method won't be called.</p>
     * 
     *  @param element The element that comes before this element in the sequence.
     *  @return Returns true when this element is compatible with the previous
     *  element in the sequence.
     * 
     *  @see #canShareWithNext
     *  @see #setSharedDisplayObject 
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */
    function canShareWithPrevious(element:IGraphicElement):Boolean;

    /**
     *  Return true if this <code>IGraphicElement</code> is compatible and can
     *  share display objects with the next <code>IGraphicElement</code>
     *  in the sequence.
     * 
     *  @param element The element that comes after this element in the sequence.
     *  @return Returns true when this element is compatible with the previous
     *  element in the sequence.
     * 
     *  @see #canShareWithPrevious
     *  @see #setSharedDisplayObject 
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */
    function canShareWithNext(element:IGraphicElement):Boolean;
    
    /**
     *  Called by <code>Group</code> when an <code>IGraphicElement</code>
     *  is added to or removed from a <code>Group</code>.
