 	private var textFlowChanged:Boolean = false;
 	
 	/**
-	 *  The TextFlow displayed by this component.
-	 * 
-	 *  <p>A TextFlow is the most important class
-	 *  in the Text Layout Framework.
-	 *  It is the root of a tree of FlowElements
-	 *  representing rich text content.</p>
-	 * 
-	 *  @default
+     *  The TextFlow representing the rich text displayed by this component.
+     * 
+     *  <p>A TextFlow is the most important class
+     *  in the Text Layout Framework (TLF).
+     *  It is the root of a tree of FlowElements
+     *  representing rich text content.</p>
+	 *
+	 *  <p>You normally create a TextFlow from TLF markup
+	 *  using the <code>TextFlowUtil.importFromString()</code>
+	 *  or <code>TextFlowUtil.importFromXML()</code> methods.
+	 *  Alternately, you can use TLF's TextConverter class
+	 *  (which can import a subset of HTML) or build a TextFlow
+	 *  using methods like <code>addChild()</code> on TextFlow.</p>
+     * 
+	 *  <p>Setting this property affects the <code>text</code> property
+     *  and vice versa.</p>
+     *
+     *  <p>If you set the <code>textFlow</code> and get the <code>text</code>,
+	 *  the text in each paragraph will be separated by a single
+     *  LF ("\n").</p>
+     *
+     *  <p>If you set the <code>text</code> to a String such as
+	 *  <code>"Hello World"</code> and get the <code>textFlow</code>,
+	 *  it will be a TextFlow containing a single ParagraphElement
+	 *  with a single SpanElement.</p>
+     *
+     *  <p>If the text contains explicit line breaks --
+     *  CR ("\r"), LF ("\n"), or CR+LF ("\r\n") --
+     *  then the content will be set to a TextFlow
+     *  which contains multiple paragraphs, each with one span.</p>
+     *
+	 *  <p>To turn a TextFlow object into TLF markup,
+	 *  use the <code>TextFlowUtil.export()</code> markup.</p>
+	 *
+	 *  @see spark.utils.TextFlowUtil#importFromString()
+	 *  @see spark.utils.TextFlowUtil#importFromXML()
+     *  @see spark.primitives.RichEditableText#text
 	 */
 	public function get textFlow():TextFlow
 	{

[IconFile("RichText.png")]

/**
 *  Defines text in FXG.
 *  
 *  <p>This class can display richly-formatted text, with multiple character and paragraph formats. 
 *  However, it is non-interactive: it doesn't support scrolling, selection, or editing.</p>
 *  
 *  <p>A RichText element defines a text box, specified in the parent Group element's coordinate space, 
 *  to contain the provided text. The text box is specified using the x/y and width/height attributes on the RichText element.</p>
 *  
 *  <p>Text is rendered as a graphic element similar to paths and shapes, but with a restricted subset of rendering options. 
 *  RichText elements are always rendered using a solid fill color, modified by any opacity, blend mode, and color transformation 
 *  defined by parent elements, and clipped to any clipping content defined on its parent elements. RichText content is only filled, 
 *  not stroked.</p>
 *  
 *  <p>RichText does not support drawing a background or border; it only renders text and inline graphics. If you want a simpler text class, 
 *  use the SimpleText class. If you want a text control with more capabilities, use the RichEditableText class.</p>
 *  
 *  <p>The RichText element automatically clips the text rendering to the bounds of the text box.</p>
 *  
 *  <p>If you do not specify the value of the <code>width</code> or <code>height</code> properties, or if the specified value
 *  of these properties is 0, the width and height are calculated based on the text content.</p>
 *  
 *  @see mx.components.RichEditableText
 *  @see mx.graphics.SimpleText
 *  
 *  @includeExample examples/RichTextExample.mxml
 *  

    private var _fontContext:IFlexModuleFactory;

    /**
     *  @inheritDoc
     */
    public function get fontContext():IFlexModuleFactory
    {
