 [IconFile("Panel.png")]
 
 /**
- *  The Panel class is container whose skin usually contains a title.
+ *  The Panel class defines a container that includes a title bar, 
+ *  a caption, a border, and a content area for its children.
+ *
+ *  @mxml
+ *  
+ *  <p>The <code>&lt;mx:Panel&gt;</code> tag inherits all of the tag 
+ *  attributes of its superclass and adds the following tag attributes:</p>
+ *  
+ *  <pre>
+ *  &lt;mx:Panel
+ *   <strong>Properties</strong>
+ *   title=""
+ *   &gt;
+ *      ...
+ *      <i>child tags</i>
+ *      ...
+ *  &lt;/mx:Panel&gt;
+ *  </pre>
  *
  *  @includeExample examples/PanelExample.mxml
  *
  *  @see SkinnableContainer
+ *  @see spark.skins.default.PanelSkin
  *  
  *  @langversion 3.0
  *  @playerversion Flash 10

    {
        _title = value;

		if (titleField)
			titleField.text = title;
    }

    //--------------------------------------------------------------------------

    [SkinPart(required="true")]

    /**
     *  The skin part that defines the appearance of the 
     *  title text in the container.
     *
     *  @see spark.skins.default.PanelSkin
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
