  *  Mobile theme. It handles displaying and editing the text.
  *  (The skin also handles drawing the border and background.)
  *  This RichEditableText or StyleableStageText instance can be accessed as the <code>textDisplay</code>
- *  object.</p>
- *
- *  <p>As a result of its RichEditableText using TLF, the Spark TextInput control
- *  supports displaying left-to-right (LTR) text, such as French,
+ *  object.  For the mobile theme, if you wish to use the TextField-based skin, rather than the
+ *  StageText-based skin, set the <code>skinClass</code> property to
+ *  <code>"spark.skins.mobile.TextInputSkin"</code>.</p>
+ *
+ *  <p>For the Spark theme, as a result of its RichEditableText using TLF, 
+ *  the Spark TextInput control supports displaying left-to-right (LTR) text, such as French,
  *  right-to-left (RTL) text, such as Arabic, and bidirectional text
  *  such as a French phrase inside of an Arabic one.
  *  If the predominant text direction is right-to-left,

 *  To use this control for password input, set the
 *  <code>displayAsPassword</code> property to <code>true</code>.</p>
 *
 *  <p>The soft-keyboard-specific properties, <code>autoCapitalize</code>
 *  <code>autoCorrect</code>, <code>returnKeyLabel</code> and <code>softKeyboardType</code>
 *  are keybostf hints supported in the mobile theme. 
 *  If a soft-keyboard is present but does not support a feature represented by the 
 *  hint, the hint is ignored. 
 *  In mobile environments with only hardware keyboards, these hints are ignored. 

 *  <p>The text is formatted using CSS styles such as <code>fontFamily</code>
 *  and <code>fontSize</code>.</p>
 *
 *  <p>For the Spark theme you can specify the width of the control using the 
 *  <code>widthInChars</code> property which provides a convenient way to specify the width in a 
 *  way that scales with the font size or you can use the <code>typicalText</code> property.
 *  Note that if you use <code>typicalText</code>, the <code>widthInChars</code> property is ignored.
 *  For all themes, you can also specify an explicit width in pixels,
 *  a percent width, or use constraints such as <code>left</code>
 *  and <code>right</code>.
 *  You do not normally do anything to specify the height;
 *  the control's default height is sufficient to display
 *  one line of text.
 *  </p>
 *
 *  <p>You can use the <code>maxChars</code> property to limit the number
 *  of character that the user can enter, and the <code>restrict</code>
