  *  hyperlinks, and images are represented at runtime by ActionScript
  *  objects which can be programmatically accessed and manipulated.
  *  The central object in TLF for representing rich text is a
- *  TextFlow, so you specify rich text for RichEditableText to display
+ *  TextFlow, so you specify rich text for a RichEditableText control to display
  *  by setting its <code>textFlow</code> property to a TextFlow instance.
- *  Please see the description of the <code>textFlow</code>
+ *  See the description of the <code>textFlow</code>
  *  property for information about how to create one,
  *  such as by importing TLF markup.
  *  If you don't need to display text that has multiple formats,
- *  simply set the <code>text</code> property to a "plain text" String.
+ *  you can use the <code>text</code> property to set a "plain text" String.
  *  See the description of the <code>text</code> and <code>textFlow</code>
  *  properties for information about how they interact;
  *  for example, you can set one and get the other.</p>
  *
- *  <p>At compile time, you can simply put TLF markup tags inside
- *  the RichEditableText tag, as in
+ *  <p>At compile time, you can put TLF markup tags inside
+ *  the RichEditableText tag, as the following example shows:
  *  <pre>
  *  &lt;s:RichEditableText&gt;Hello &lt;s:span fontWeight="bold"&gt;World!&lt;/s:span&gt;&lt;/s:RichEditableText&gt;
  *  </pre>

 *  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,
 *  set the <code>direction</code> style to <code>"rtl"</code>.
 *  The <code>textAlign</code> style defaults to <code>"start"</code>,
 *  which makes the text left-aligned when <code>direction</code>
 *  is <code>"ltr"</code> and right-aligned when <code>direction</code>
 *  is <code>"rtl"</code>.
 *  To get the opposite alignment,
 *  set <code>textAlign</code> to <code>"end"</code>.</p>
 *
 *  <p>Also as a result of using TLF, the RichEditableText supports
 *  unlimited undo/redo within one editing session.
 *  An editing session starts when the component gets keyboard focus
 *  and ends when it loses focus.</p>

     *  A value of <code>undefined</code> does not get applied.
     *  If you don't specify a range, the selected range is used.</p>
     *
     *  <p>The following example sets the <code>fontSize</code> and <code>color</code> of the selection:
     *  <pre>
     *  var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
     *  textLayoutFormat.fontSize = 12;
     *  textLayoutFormat.color = 0xFF0000;
     *  myRET.setFormatOfRange(textLayoutFormat);
     *  </pre>
     *  </p>
     *  
     *  @params format The TextLayoutFormat to apply to the selection.
     * 
     *  @params anchorPosition A character position, relative to the beginning of the 
     *  text String, specifying the end of the selection that stays fixed when the 
     *  selection is extended with the arrow keys.
     * 
     *  @params activePosition A character position, relative to the beginning of the 
     *  text String, specifying the end of the selection that moves when the 
     *  selection is extended with the arrow keys. 
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 1.5
