 [DefaultProperty("navigationStack")]
 
 /**
+ *  MobileApplication is an application class meant to provide a simple
+ *  framework for applications that employ a view-based navigation model.
+ *  When used, this class functions as the main entry point for the application
+ *  and provides support for hardware device keys, orientation detection and
+ *  application session persistence.
  * 
+ *  <p>A view=based navigation model is characterized by a user interface
+ *  where the end user navigates between a series of full screen views in
+ *  response to user interaction.  This is a paradigm commonly used by
+ *  mobile applications and is accomplished through the use of a built in
+ *  <code>ViewNavigator</code> that lives in the application's skin.</p>
+ * 
+ *  <p>The <code>firstView</code> property can be used to define
+ *  what View should be displayed first when the application is
+ *  initialized.</p>
+ * 
+ *  <p>Unlike Application, MobileApplication is not meant to accept
+ *  UIComponents has children.  Instead, all visual components should
+ *  children of the various views managed by the application.</p>
+ *
+ *  @langversion 3.0
+ *  @playerversion Flash 10.1
+ *  @playerversion AIR 2.5
+ *  @productversion Flex 4.5
  */
 public class MobileApplication extends MobileApplicationBase
 {

    //----------------------------------
    
    /**
     *  Layout for the ActionBar navigation content group.
     *
     *  @default null
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5

    //----------------------------------
    
    /**
     *  The default layout to apply to the ActionBar's action content 
     *  container when the current view does not define one.
     *
     *  @default null
     *  
     *  @see spark.components.View#actionLayout
     *  @see spark.components.ViewNavigator#actionLayout
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
