     //--------------------------------------------------------------------------
     
     /**
-     * @inheritDoc
+     *  Individual path segments notify the host Path that 
+     *  the segment has changed in some way by invoking
+     *  this method. When a segment has changed, the 
+     *  bounds of the Path are re-calculated and the Path 
+     *  will be re-renderered. 
+     * 
+     *  @param e The PathSegment that has changed 
      *  
      *  @langversion 3.0
      *  @playerversion Flash 10

            }
        }
    }
    /**
     * @inheritDoc
     *  

    private var graphicsPathChanged:Boolean = true;
    
    /**
     *  A GraphicsPath object that contains the drawing 
     *  commands to draw this Path.  
     *  
     *  The data commands expressed in a Path's <code>data</code> 
     *  property are translated into drawing commands and 
     *  coordinate parameters for those commands, and then
     *  drawn to screen. 
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
