 /**
  *  Dispatched by the container when it's opened and ready for user interaction.
  * 
- *  This event is dispatched when the container switches from "closed" to "normal"
- *  state and the transition to that state completes.
+ *  <p>This event is dispatched when the container switches from the 
+ *  <code>closed</code> to <code>normal</code> skin state and the transition 
+ *  to that state completes.</p>
  *
  *  @eventType spark.events.PopUpEvent.OPEN
  * 

    //--------------------------------------------------------------------------
    
    /**
     *  Brings up the container as a pop-up and switches the state from "closed" to "normal",
     *  waits till any state transitions are finished playing and dispatches <code>FlexEvent.OPEN</code> event.
     *
     *  @param owner The owner of the container.
     *
     *  @param modal Whether the container should be modal.
     *
     *  @see #close 
     * 

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

    /**
     *  Contains <code>true</code> when the container is open and is currently showing as a pop-up.  
     *
     *  @see #open
     *  @see #close 
