 /**
  *  TERMINOLOGY
  * 
- *  TBounds - bounds of an object in object's parent coordinate space, i.e.
- *            bounts of the transformed object.
+ *  <p>TBounds - bounds of an object in object's parent coordinate space, i.e.
+ *            bounds of the transformed object.</p>
  *
- *  UBounds - bounds of an object in object's own coordinate space, i.e.
- *            bounds of the untransformed object (object's dimensions).
+ *  <p>UBounds - bounds of an object in object's own coordinate space, i.e.
+ *            bounds of the untransformed object (object's dimensions).</p>
  *
- *  Example: Consider a rectangle width=3, height=1 with rotation=90
+ *  <p>Example: Consider a rectangle width=3, height=1 with rotation=90.</p>
  * 
- *  Ubounds (before transform) are (3,1):
+ *  <p>Ubounds (before transform) are (3,1):
+ *  <pre>
  *       +--------+ 
  *       |        |
  *       +--------+
- * 
- *  TBounds (after transform) are (1,3):
+ *  </pre>
+ *  </p>
+ *  
+ *  <p>TBounds (after transform) are (1,3):
+ *  <pre>
  *       +----+
  *       |    |
  *       |    |
  *       |    |
  *       +----+
+ *  </pre>
+ *  </p>
  */
 public interface ILayoutItem
 {
     /**
-     *  @return Returns a reference to the object in the layout tree
+     *  A reference to the object in the layout tree
      *  represented by this interface.
      */
     function get target():Object;

     *  <code>setActualSize</code> must preserve the item's TBounds position,
     *  which means that in some cases it will move the item in addition to
     *  changing its size.
     * 
     *  @return Returns the TBounds of the new item size.
     */

    function get includeInLayout():Boolean;
    
    /**
     *  The TBounds of the preferred
     *  item size. The preferred size is usually based on the default
     *  item size and any explicit size overrides.
     */
    function get preferredSize():Point;

    /**
     *  The TBounds of the minimum item size.
     *  <code>minSize</code> <= <code>preferredSize</code> must be true.
     */
    function get minSize():Point;

    /**
     *  The TBounds of the maximum item size.
     *  <code>preferredSize</code> <= <code>maxSize</code> must be true.
     */
    function get maxSize():Point;
    
    /**
     *  The desired item TBounds size
     *  as a percentage of parent UBounds. Could be NaN.
     */
    function get percentSize():Point; 
    
    /**
     *  The item TBounds size.
     */ 
    function get actualSize():Point;

    /**
     *  The item TBounds top left corner coordinates.
     */
    function get actualPosition():Point;

    /**
     *  Moves the item such that the item TBounds
     *  top left corner has the specified coordinates.
     */
    function setActualPosition( x:Number, y:Number ):void;
