  *  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>.

 *  and a Scroller control to provide scrollbars.
 *  The RichEditableText can be accessed as <code>textDisplay</code>
 *  and the Scroller as <code>scroller</code>. When used with the mobile theme, this control uses 
 *  the StyleableTextField class to display and edit text.</p>
 *
 *  <p>The Spark TextArea
 *  can display left-to-right (LTR) text, such as French,

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