     
 /**
  *  Use the SplashScreenImage class to specify different splash screen 
- *  images per device configurations like DPI, orientation, resolution.
+ *  images based on characteristics of a mobile device.
+ *  For example, you can use different images for a splashscreen based on the 
+ *  DPI, orientation, or resolution of the device.
  * 
- *  <p>Developers typically define a <code>SplashScreenImage</code> class
- *  in a separate MXML file.  The different image choices and corresponding
- *  device configutaions are defined in that MXML file as <code>SplahsScreenImageSource</code>
- *  children.  The Developers set the Application's <code>splashScreenImage</code>
- *  property to the name of the <code>SplashScreenImage</code> definition.</p> 
+ *  <p>You typically define a SplashScreenImage class
+ *  in an MXML file.  
+ *  Use the SplahsScreenImageSource class to define the different 
+ *  image choices and corresponding device configurations.  
+ *  You then set the application's <code>splashScreenImage</code>
+ *  property to the name of the <code>SplashScreenImage</code> MXML component.</p> 
+ * 
+ *  <p>The procedure for determining the best match of an SplahsScreenImageSource 
+ *  definition to a mobile device is as follows:</p>
+ *  
+ *  <ol>
+ *    <li>Determine all of the SplashScreenImageSource definitions 
+ *      that match the settings of the mobile device. 
+ *      A match occurs when: 
+ *        <ul>
+ *          <li>The SplashScreenImageSource definition does not have that setting explicitly defined. 
+ *              For example, no setting for the <code>dpi</code> property matches any device's DPI.</li>
+ *          <li>For the <code>dpi</code> or <code>aspectRatio</code> property, the property must exactly match 
+ *              the corresponding setting of the mobile device. </li>
+ *          <li>For the <code>minResolution</code> property, the property matches a setting on 
+ *              the device when the larger of the <code>Stage.stageWidth</code> and 
+ *              <code>Stage.stageHeight</code> properties is equal to or greater than <code>minResolution</code>.</li>
+ *        </ul>
+ *    </li>
+ *    <li>If there's more than one SplashScreenImageSource definition that matches the device then: 
+ *          <ul>
+ *            <li>Choose the one with largest number of explicit settings. 
+ *              For example, a SplashScreenImageSource definition that specifies both the 
+ *              <code>dpi</code> and <code>aspectRatio</code> properties is a better match 
+ *              than one that only species the <code>dpi</code> property.</li>
+ *            <li>If there is still more than one match, choose the one with highest 
+ *              <code>minResolution</code> value.</li>
+ *            <li>If there is still more than one match, choose the first one defined in the component.</li>
+ *          </ul>
+ *    </li>
+ *  </ol>
  *
- *  <p>Note, this class can't be set inline in the Application MXML, it needs
- *  to be defined in a separate MXML file and referenced from the Application's
- *  <code>splashScreenImage</code> property.</p>
+ *  <p><b>Note</b>: This class cannot be set inline in the MXML of the application.
+ *  You must define it in a separate MXML file and reference it by using the 
+ *  application's <code>splashScreenImage</code> property.</p>
  *
  *  @see spark.preloaders.SplashScreenImageSource
  *  @see spark.components.Application#splashScreenImage
+ *  
+ *  @langversion 3.0
+ *  @playerversion AIR 3
+ *  @productversion Flex 4.5.2
  */    
 public class SplashScreenImage
 {

    [ArrayElementType("spark.preloaders.SplashScreenImageSource")]

    /**
     *  The <code>SplashScreenImageSource</code> sources for this 
     *  <code>SplashScreenImage</code>.
     * 
     *  Typically developers don't use this method directly, instead they
     *  define the <code>SplashScreenImageSource</code> inline in MXML.
     */
    public function get mxmlContent():Array
    {

    
    /**
     *  Constructor.
     *  
     *  @langversion 3.0
     *  @playerversion AIR 3
     *  @productversion Flex 4.5.2
     */
    public function SplashScreenImage()
    {
