      *  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 get shareIndex():int;

    /**
     *  @private 
     */
    function set shareIndex(value:int):void;
    
    //--------------------------------------------------------------------------
    //

     *  rest of the elements in the sequence this method must return <code>false</code>.
     *  Examples for such properties are rotation, scale, transform,
     *  mask, alpha, filters, color transform, 3D, layer, etc.</p>
     *
     *  When this method returns true, subsequent calls to the getter of the
     *  <code>displayObject<code> property must return the same display object.
     *
     *  <p>Note that in certain cases the <code>sharedDisplayObject</code> may be
     *  the parent <code>Group</code> itself.  In the rest of the cases the
     *  <code>DisplayObject</code> is created by the first element in the sequence.</p> 
