     //--------------------------------------------------------------------------
 
     /**
-     *  Returns the Class of the SplashScreenImageSource that matches best
+     *  Returns the Class of the SplashScreenImageSource that best matches 
      *  the specified device parameters.
      * 
-     *  Developers don't call this method directly, it is called internally by Flex.
+     *  <p>You do not call this method directly; it is called internally by Flex.</p>
      * 
-     *  Developers may override this method in a subclass if they want to override
-     *  the default Flex logic of picking the best matching SplashScreenImageSource.
+     *  <p>Override this method in a SplashScreenImage component if you want to override
+     *  the default Flex logic of picking the best matching SplashScreenImageSource instance.</p>
      * 
-     *  @param aspectRatio One of StageAspectRatio.PORTRAIT StageAspectRatio.LANDSCAPE.
-     *  @param dpi The dpi of the device.
-     *  @param resolution The resolution of the device's bigger dimension, in pixels.
+     *  @param aspectRatio Either <code>flash.display.StageAspectRatio.PORTRAIT</code> or 
+     *  <code>flash.display.StageAspectRatio.LANDSCAPE</code>, whichever is greater.
+     * 
+     *  @param dpi The DPI of the mobile device.
+     * 
+     *  @param resolution The resolution of the mobile device's bigger dimension, in pixels.
+     * 
      *  @return The Class for the image to be displayed as a splash screen image.
+     *
+     *  @see flash.display.StageAspectRatio
+     *  
+     *  @langversion 3.0
+     *  @playerversion AIR 3
+     *  @productversion Flex 4.5.2
      */
     public function getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class
     {

    
/**
 *  Use the SplashScreenImage class to specify different splash screen 
 *  images per device configurations like DPI, orientation, resolution.
 * 
 *  <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>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>
 *
 *  @see spark.preloaders.SplashScreenImageSource
 *  @see spark.components.Application#splashScreenImage
 */    
public class SplashScreenImage
{

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

    /**
     *  The SplashScreenImageSource sources for this 
     *  <code>SplashScreenImage</code>.
     * 
     *  Typically you do not call this method directly.
     *  Instead, you add SplashScreenImageSource definitions 
     *  inline in the MXML file of the SplashScreenImage component.
     *  
     *  @langversion 3.0
     *  @playerversion AIR 3
     *  @productversion Flex 4.5.2
     */
    public function get mxmlContent():Array
    {
