 [SkinState("closed")]
 
 /**
- *  The SkinnablePopUpContainer class is a SkinnableContainer that also acts as a pop-up.
- *
- *  The SkinnablePopUpContainer is initially in its "closed" state and when it's opened
- *  it will add itself as a pop-up to the PopUpManager and transition to its "normal" state.
- *
- *  <p>When using SkinnablePopUpContainer the pop-up is defined in mxml as
- *  a SkinnablePopUpContainer component.  To show the component create an instance and
- *  call the <code>open()</code> method. The developers are responsible for the sizing and positioning
- *  of the component.  To close the component call the <code>close()</code>
- *  method.  If the pop-up needs to pass data back to a handler, you can add a listener for 
- *  the <code>PopUp.CLOSE</code> event and specify the data in the <code>close()</code> method.</p>
- *
- *  To define open and close animations, use a custom skin with transitions between the "closed"
- *  and "normal" states.
+ *  The SkinnablePopUpContainer class is a SkinnableContainer that functions as a pop-up.
+ *  One typical use for a SkinnablePopUpContainer container is to open a simple window 
+ *  in an application, such as an alert window, to indicate that the user must perform some action.
+ *
+ *  <p>You do not create a SkinnablePopUpContainer container as part of the normal layout 
+ *  of its parent container. 
+ *  Instead, it appears as a pop-up window on top of its parent. 
+ *  Therefore, you do not create it directly in the MXML code of your application.</p>
+ *
+ *  <p>Instead, you create is as an MXML component, often in a separate MXML file. 
+ *  To show the component create an instance of the MXML component, and
+ *  then call the <code>open()</code> method. 
+ *  You can also set the size and position of the component when you open it.</p>  
+ *
+ *  <p>To close the component, call the <code>close()</code> method.  
+ *  If the pop-up needs to return data to a handler, you can add an event listener for 
+ *  the <code>PopUp.CLOSE</code> event, and specify the returned data in 
+ *  the <code>close()</code> method.</p>
+ *
+ *  <p>The SkinnablePopUpContainer is initially in its <code>closed</code> skin state. 
+ *  When it opens, it adds itself as a pop-up to the PopUpManager, 
+ *  and transition to the <code>normal</code> skin state.
+ *  To define open and close animations, use a custom skin with transitions between 
+ *  the <code>closed</code> and <code>normal</code> skin states.</p>
+ * 
+ *  <p>The SkinnablePopUpContainer container has the following default characteristics:</p>
+ *     <table class="innertable">
+ *     <tr><th>Characteristic</th><th>Description</th></tr>
+ *     <tr><td>Default size</td><td>Large enough to display its children</td></tr>
+ *     <tr><td>Minimum size</td><td>0 pixels</td></tr>
+ *     <tr><td>Maximum size</td><td>10000 pixels wide and 10000 pixels high</td></tr>
+ *     <tr><td>Default skin class</td><td>spark.skins.spark.SkinnablePopUpContainerSkin</td></tr>
+ *     </table>
+ *
+ *  @mxml <p>The <code>&lt;s:SkinnablePopUpContainer&gt;</code> tag inherits all of the tag 
+ *  attributes of its superclass and adds the following tag attributes:</p>
+ *
+ *  <pre>
+ *  &lt;s:SkinnablePopUpContainer 
+ *    <strong>Events</strong>
+ *    close="<i>No default</i>"
+ *    open="<i>No default</i>"
+ *  /&gt;
+ *  </pre>
  *
  *  @see spark.skins.spark.SkinnablePopUpContainerSkin
  *

    [Inspectable(category="General", defaultValue="false")]

    /**
     *  True when the container is open and is currently showing as a pop-up.  
     *
     *  @see #open
     *  @see #close 

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

/**
 *  The closed state.
 * 
 *  @langversion 3.0
 *  @playerversion Flash 10
