 import spark.layouts.supportClasses.LayoutBase;
 
 /**
- *  TileLayout arranges the layout elements in columns and rows
+ *  The TileLayout class arranges layout elements in columns and rows
  *  of equally-sized cells.
- *
- *  There are a number of properties that control orientation,
+ *  The TileLayout class uses a number of properties that control orientation,
  *  count, size, gap and justification of the columns and the rows
  *  as well as element alignment within the cells.
  *
- *  Per-element supported constraints are percentWidth, percentHeight.
- *  Element's minimum and maximum sizes will always be respected and
- *  where possible, an element's size will be limited to less then or equal
- *  of the cell size.
+ *  <p>Per-element supported constraints are 
+ *  <code>percentWidth</code> and <code>percentHeight</code>.
+ *  Element's minimum and maximum sizes are always be respected and
+ *  where possible, an element's size is limited to less then or equal
+ *  of the cell size.</p>
  *
- *  When not explicitly set, the columnWidth is calculated as the maximum
- *  preferred bounds width of all elements and the columnHeight is calculated
- *  as the maximum preferred bounds height of all elements.
+ *  <p>When not explicitly set, the <code>columnWidth</code> property 
+ *  is calculated as the maximum preferred bounds width of all elements 
+ *  and the <code>columnHeight</code> property is calculated
+ *  as the maximum preferred bounds height of all elements.</p>
  *
- *  When not explicitly set, the columnCount and rowCount are calculated from
- *  any explicit width/height settings for the layout target and columnWidth
- *  and columnHeight.  In case none is specified, the coulumnCount and rowCount
- *  values are picked so that the resulting pixel area is as square as possible.
+ *  <p>When not explicitly set, the <code>columnCount</code> and 
+ *  <code>rowCount</code> properties are calculated from
+ *  any explicit width and height settings for the layout target, 
+ *  and <code>columnWidth</code> and <code>columnHeight</code>.  
+ *  In case none is specified, the <code>columnCount</code> and <code>rowCount</code>
+ *  values are picked so that the resulting pixel area is as square as possible.</p>
  * 
- *  The measured size is calculated from the columnCount, rowCount, 
- *  columnWidth, rowHeight and the gap sizes.
+ * <p> The measured size is calculated from the <code>columnCount</code>, <code>rowCount</code>, 
+ *  <code>columnWidth</code>, <code>rowHeight</code> properties and the gap sizes.</p>
  *
- *  The default measured size, when no properties were explicitly set, is
- *  as square as possible area and is enough to fit all elements.
+ *  <p>The default measured size, when no properties were explicitly set, is
+ *  as square as possible area and is large enough to fit all elements.</p>
  *
- *  In other cases the measured size may not be big enough to fit all elements -
- *  for example when both columnCount and rowCount are explicitly set to values
- *  such that columnCount * rowCount &lt; element count.
+ *  <p>In other cases the measured size may not be big enough to fit all elements.
+ *  For example, when both <code>columnCount</code> and <code>rowCount</code> are explicitly set to values
+ *  such that <code>columnCount</code> &#42; <code>rowCount</code> &lt; element count.</p>
  *
- *  The minimum measured size is calculated the same way as the measured size but
- *  it's guaranteed to encompass enough rows/columns along the minor axis to fit
- *  all elements.
+ *  <p>The minimum measured size is calculated the same way as the measured size but
+ *  it's guaranteed to encompass enough rows and columns along the minor axis to fit
+ *  all elements.</p>
+ *
+ *  @mxml 
+ *  <p>The <code>&lt;TileLayout&gt;</code> tag inherits all of the tag 
+ *  attributes of its superclass and adds the following tag attributes:</p>
+ *
+ *  <pre>
+ *  &lt;TileLayout 
+ *    <strong>Properties</strong>
+ *    columnAlign="left"
+ *    columnWidth="NaN"
+ *    horizontalAlign="justify"
+ *    horizontalGap="6"
+ *    orientation="rows"
+ *    requestedColumnCount="-1"
+ *    requestedRowCount="-1"
+ *    rowAlign="top"
+ *    rowCount="-1"
+ *    rowHeight="NaN"
+ *    verticalAlign="justify"
+ *    verticalGap="6"
+ *  /&gt;
+ *  </pre>
  *  
  *  @langversion 3.0
  *  @playerversion Flash 10

     *  and <code>RowAlign.JUSTIFY_USING_HEIGHT</code>.
     *  MXML values can be <code>"top"</code>, <code>"justifyUsingGap"</code> and <code>"justifyUsingHeight"</code>.
     *
     *  <p>When set to <code>RowAlign.TOP</code> - turns column justification off, there may
     *  be partially visible rows or whitespace between the last row and
     *  the bottom edge of the container.  This is the default value.</p>
     *
     *  <p>When set to <code>RowAlign.JUSTIFY_USING_GAP</code> - the <code>verticalGap</code>
     *  actual value will increase so that
     *  the last fully visible row bottom edge aligns with the container's bottom edge.
     *  In case there is only a single fully visible row, the <code>verticalGap</code> actual value
     *  will increase so that it pushes any partially visible row just beyond the bottom edge
     *  of the container.  Note that explicitly setting the <code>verticalGap</code> does not turn off
     *  justification, but just determines the initial gap value, and after that justification
     *  may increases it.</p>
     *
     *  <p>When set to <code>RowAlign.JUSTIFY_USING_HEIGHT</code> - the <code>rowHeight</code>
     *  actual value will increase so that
     *  the last fully visible row bottom edge aligns with the container's bottom edge.  Note that
     *  explicitly setting the <code>rowHeight</code> does not turn off justification, but simply
     *  determines the initial row height value, and after that justification may increases it.</p>
     *
     *  @see #verticalGap
     *  @see #rowHeight

    [Inspectable(category="General")]

    /**
     *  The row height.
     *
     *  <p>If not explicitly set, the row height is 
     *  determined from the maximum of elements' height.</p>
     *
     *  If <code>rowAlign</code> is set to "justifyUsingHeight", the actual row height
     *  increases to justify the fully-visible rows to the container height.
     *
     *  @see #columnWidth
     *  @see #rowAlign
