  *  </p>
  *     
  *  <p><b>Limitation of StageText-based controls:</b>
- * 
+ *  <ul>
  *  <li>Native text input fields cannot be clipped by other Flex content and are rendered in a 
  *  layer above the Stage. 
- *  Because of this limitation, components that use StageText-based skin classes will always appear 
- *  to be on top of other Flex components. 
+ *  Because of this limitation, <b>components that use StageText-based skin classes will always appear 
+ *  to be on top of other Flex components</b>. 
  *  Flex popups and drop-downs will also be obscured by any visible native text fields. 
  *  Finally, native text fields' relative z-order cannot be controlled by the application.</li>
  * 
  *  <li>StageText uses a native text control both for text display and text entry. 
- *  These native controls cannot use embedded fonts directly. 
- *  Other text controls may be used as workarounds if embedded font support is a requirement.</li>
- * 
- *  <li>StageText does not support links or html markup. Only plain text is supported.</li>
- * 
- *  <li>StageText <code>text</code> is always selectable.</li>
- * 
- *  <li>StageText does not support fractional alpha values.</li>
+ *  These native controls do not support embedded fonts.</li>
  * 
  *  <li>The padding around native text controls may be different than the padding around 
  *  TextField controls.</li>
  * 
- *  <li>StageText does not support programmatic control of scroll position at this time. </li>
- * 
- *  <li>StageText does not dispatch low-level keyboard events for most keys. 
- *  Most notably, the tab key will not dispatch keyDown or keyUp events. 
- *  As a consequence, focus cannot be removed from a component using StageText with the tab key.</li>
- * 
- *  <li>StageText is currently not capable of measuring text. 
- *  Because of this, any functionality which requires determining the dimensions of text is not 
- *  supported.</li>
- * 
- *  <li>Similiar to other native applications, when you tap outside of the native text field the 
+ *  <li>StageText does not support links or html markup. Only plain text is supported.</li>
+ * 
+ *  <li>StageText <code>text</code> is always selectable.</li>
+ * 
+ *  <li>StageText does not support fractional alpha values.</li>
+ * 
+ *  <li>StageText does not dispatch keyboard events for most keys.
+ *  This means that the tab key will not dispatch keyDown or keyUp events so focus
+ *  cannot be removed from a StageText-based control with the tab key.</li>
+ * 
+ *  <li>StageText is currently not capable of measuring text.</li>
+ * 
+ *  <li>Similiar to other native applications, when you tap outside of the native text field, the 
  *  text field gives up focus and the soft keyboard goes away.  
  *  This differs from when you tap outside of a TextField and the focus stays in the TextField and 
  *  the soft keyboard remains visible.</li>
  * 
- *  <li>Scrolling form workflows do not work.
- *  In the near-term, StageText will not support an event model necessary to allow for 
+ *  <li>At this time StageText does not support programmatic control of scroll position. </li>
+ * 
+ *  <li>At this time StageText does not support an event model necessary to allow for 
  *  touch-based scrolling of forms containing native text fields.</li>
+ *  </ul>
  *  </p>
  *  
  *  @see flash.text.StageText

    //--------------------------------------------------------------------------
    
    /**
     *  Appends the specified text to the end of the text component, as if you
     *  had clicked at the end and typed.
     *
     *  <p>An insertion point is then set after the new text. If necessary, the
     *  text will scroll to ensure that the insertion point is visible.</p>
     *
     *  @param text The text to be appended.
     * 
     *  @langversion 3.0
     *  @playerversion AIR 3.0

     *  The active, or last clicked position, of the selection. If the
     *  implementation does not support selection anchor this is the last
     *  character of the selection.
     * 
     *  <p>This value can not be used as the source for data binding.</p>
     *  
     *  @langversion 3.0
     *  @playerversion AIR 3.0
