  *  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>
+ *  
  *  <p>This control dispatches a <code>FlexEvent.ENTER</code> event
  *  when the user pressed the Enter key rather than inserting a line
  *  break, because this control does not support entering multiple
  *  lines of text. By default, this control has explicit line breaks.</p>
  *
- *  <p>This control is a skinnable control whose default skin contains a
- *  RichEditableText instance that handles displaying and editing the text.
+ *  <p>This control is a skinnable control whose default skin contains either a
+ *  RichEditableText instance for the Spark theme or a StyleableStageText instance for the
+ *  Mobile theme. It handles displaying and editing the text.
  *  (The skin also handles drawing the border and background.)
- *  This RichEditableText can be accessed as the <code>textDisplay</code>
+ *  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

 *  In combination, these layers provide text editing with
 *  high-quality international typography and layout.</p>
 * 
 *  <p><b>The TextInput skin for the mobile theme uses the StyleableTextField class instead of RichEditableText.</b>
 *  As a result, TLF-only features are not supported in the mobile theme including
 *  TextFlow, right-to-left or bidirectional text, and advanced text 
 *  styles.</p>
 *
 *  <p>You can set the text to be displayed, or get the text that the user
 *  has entered, using the <code>text</code> property.

 *  /&gt;
 *  </pre>
 *
 *  @see spark.components.Label
 *  @see spark.components.RichEditableText
 *  @see spark.skins.mobile.StageTextInputSkin
 *  @see spark.skins.mobile.TextInputSkin
 *  @see spark.skins.spark.TextInputSkin
 *  @see TextArea
 *  
 *  @langversion 3.0
