      *
      *  </code></pre>
      *
-     *  <p>This function must return the following
+     *  <p>This function must return the following value:
      *  <ul>
-     *        <li>-1, if <code>a</code> should appear before <code>b</code> in
-     *        the sorted sequence</li>
-     *        <li>0, if <code>a</code> equals <code>b</code></li>
-     *        <li>1, if <code>a</code> should appear after <code>b</code> in the
-     *        sorted sequence</li>
+     *        <li>-1, if the <code>Object a</code> should appear before the 
+     *        <code>Object b</code> in the sorted sequence</li>
+     *        <li>0, if the <code>Object a</code> equals the 
+     *        <code>Object b</code></li>
+     *        <li>1, if the <code>Object a</code> should appear after the 
+     *        <code>Object b</code> in the sorted sequence</li>
      *  </ul></p>
-     *  <p>To return to the internal comparision function set this value to
+     *  <p>To return to the internal comparision function, set this value to
      *  <code>null</code>.</p>
      *  <p>
      *  The <code>fields</code> array specifies the object fields
      *  to compare.
      *  Typically the algorithm will compare properties until the field list is
-     *  exhausted or a non zero value can be returned.
+     *  exhausted or a non-zero value can be returned.
      *  For example:</p>
      *
      *  <pre><code>

     *  To prevent the array from being modified, create a copy
     *  use the copy in the <code>items</code> parameter.
     *
     *  <p>Flex ICollectionView implementations call the <code>sort</code>
     *  method automatically and ensure that the sort is performed on a
     *  copy of the underlying data.</p>
     *
     *  @param items Array of items to sort.
     *

    function set compareFunction(value:Function):void;

    /**
     *  An <code>Array</code> of <code>ISortField</code> objects that specifies the fields to compare.
     *  The order of the ISortField objects in the array determines
     *  field priority order when sorting.
     *  The default sort comparator checks the sort fields in array
