     /**
      *  The function that compares two items during a sort of items for the
      *  associated collection. If you specify a <code>compareFunction</code>
-	 *  property in a Sort object, Flex ignores any <code>compareFunction</code>
-	 *  properties of the Sort's SortField objects.
+     *  property in an ISort object, Flex ignores any 
+     *  <code>compareFunction</code> properties of the ISort's SortField
+     *  objects.
      *  <p>The compare function must have the following signature:</p>
      *
      *  <p><code>function myCompare(a:Object, b:Object):int</code></p>
      *
      *  <p>This function must return the following values:</p>
-	 * 
-	 *   <ul>
+     *
+     *   <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>
      *  </ul>
-     *
-     *  <p>The default value is an internal compare function that can perform 
-	 *  a string, numeric, or date comparison in ascending or descending order, 
-	 *  with case-sensitive or case-insensitive string comparisons.
-     *  Specify your own function only if you need a need a custom comparison algorithm.
-     *  This is normally only the case if a calculated field is used in a display.</p>
-     *
+     * 
+     *  <p>The default value is an internal compare function that can perform
+     *  a string, numeric, or date comparison in ascending or descending order,
+     *  with case-sensitive or case-insensitive string comparisons.
+     *  Specify your own function only if you need a need a custom comparison
+     *  algorithm. This is normally only the case if a calculated field is
+     *  used in a display.</p>
      *  
+     *  Note if you need, language specific sorting then consider using the
+     *  <code>spark.collections.SortField</code> class.
+     * 
+     *  @see spark.collections.SortField
+     * 
      *  @langversion 3.0
      *  @playerversion Flash 9
      *  @playerversion AIR 1.1

     */
    private var _caseInsensitive:Boolean;

     [Inspectable(category="General")]
     [Bindable("caseInsensitiveChanged")]

    /**
     *  Specifies whether the sort for this field should be case insensitive.
     *
     *  @default false
     *  
     *  @langversion 3.0
     *  @playerversion Flash 9
     *  @playerversion AIR 1.1

import flash.events.Event;
import flash.events.EventDispatcher;
import mx.collections.errors.SortError;
import mx.managers.ISystemManager;
import mx.managers.SystemManager;
import mx.resources.IResourceManager;
import mx.resources.ResourceManager;
import mx.utils.ObjectUtil;

[ResourceBundle("collections")]

/**
 *  Provides the sorting information required to establish a sort on a field
 *  or property in a collection view.
 *  Typically the sort is defined for collections of complex items, that is
 *  items in which the sort is performed on properties of those objects.
 *  As in the following example:
 *
 *  <pre><code>
 *     var col:ICollectionView = new ArrayCollection();
 *     col.addItem({first:"Anders", last:"Dickerson"});
 *     var sort:ISort = new Sort();
 *     sort.fields = [new SortField("first", true)];
 *     col.sort = sort;
 *  </code></pre>
 *
 *  There are situations in which the collection contains simple items, like
 *  <code>String</code>, <code>Date</code>, <code>Boolean</code>, etc.
 *  In this case, sorting should be applied to the simple type directly.
 *  When constructing a sort for this situation only a single sort field is
 *  required and should not have a <code>name</code> specified.
 *  For example:
 *
 *  <pre><code>
 *     var col:ICollectionView = new ArrayCollection();
 *     col.addItem("California");
 *     col.addItem("Arizona");
 *     var sort:ISort = new Sort();
 *     sort.fields = [new SortField(null, true)];
 *     col.sort = sort;
 *  </code></pre>
 *
 *  <p>By default the comparison provided by the SortField class does
 *  not provide correct language specific
 *  sorting for strings.  For this type of sorting please see the 
 *  <code>spark.collections.Sort</code> and 
 *  <code>spark.collections.SortField</code> classes.</p>
 * 
 *  @mxml
 *
