  *  In this example, the MXML compiler sets the TextArea <code>content</code>
  *  property, causing a TextFlow object to be created from the FlowElements that you specify.</p>
  *
+ *  <p>The TextArea control does not include any user interface for changing
+ *  the formatting of the text but contains 
+ *  APIs that you can use to programmatically format text.
+ *  For example, you can create a 
+ *  a button that, when clicked, makes the selected text bold.</p>
+ *
  *  <p>The default text formatting is determined by CSS styles
  *  such as <a href="supportClasses/SkinnableTextBase.html#style:fontFamily">fontFamily</a>
  *  and <a href="supportClasses/SkinnableTextBase.html#style:fontSize">fontSize</a>.

 *  @see #text
 *  @see #textFlow
 *  @see spark.components.TextInput
 *  @see spark.skins.spark.TextAreaSkin
 *  @see spark.components.RichText
 *  @see spark.components.RichEditableText
 *  @see spark.components.Scroller
 *  @see spark.components.Label
 *
 *  @includeExample examples/TextAreaExample.mxml
 *  

 *  which builds on the Flash Text Engine (FTE).</b>
 *  In combination, these layers provide text editing with
 *  high-quality international typography and layout.</p>
 *  
 *  <p><b>The TextArea skin for the mobile theme uses the StyleableStageText class instead 
 *  of RichEditableText.</b>  
 *  Since StyleableStageText uses native text fields it allows for better text entry and 
 *  manipulation experiences on mobile devices however there are some
 *  <a href="supportClasses/StyleableStageText.html">limitations</a> that you should consider.
 *  Because StageText is not capable of measuring text, the TextArea must be given explicit, 
 *  percent-based, or constraint-based <code>width</code> and <code>height</code>.</p>
 *
 *  <p>The soft-keyboard-specific properties, <code>autoCapitalize</code>
 *  <code>autoCorrect</code>, <code>returnKeyLabel</code> and <code>softKeyboardType</code>
 *  are keyboard 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>The most important differences between Spark TextArea and the
 *  MX TextArea control are as follows:
 *  <ul>
 *    <li>Spark TextArea offers better typography, better support
 *        for international languages, and better text layout.</li>
