  *  The <code>SortingCollator</code> class provides locale-sensitve string
  *  comparison capabilities with inital settings suitable for linguistic
  *  sorting purposes such as sorting a list of
- *  text strings that are displayed to an end user.
+ *  text strings that are displayed to an end-user.
  *
  *  <p>This class is a wrapper class around the
  *  <code>flash.globalization.Collator</code>.
  *  Therefore the locale-specific string comparison is provided by the
  *  <code>flash.globalization.Collator</code>.
- *  However this SortingCollator class can be used in MXML declartions, uses
+ *  However, this SortingCollator class can be used in MXML declartions, uses
  *  the locale style for the requested Locale ID name, and has methods and
  *  properties that are bindable.
- *  Additionally events are generated if there is an error or warning
+ *  Additionally, <code>LastOperationStatus</code> is set, if there is an error or warning
  *  generated by the flash.globalization class.</p>
  *
- *  <p>The flash.globalization.Collator class use the underlying operating
+ *  <p>The flash.globalization.Collator class uses the underlying operating
  *  system for the formatting functionality and to supply the locale
  *  specific data.
  *  On some operating systems, the flash.globalization classes are
- *  unsupported, this wrapper class provides a fallback functionality in
- *  this case.</p>
+ *  unsupported, this wrapper class provides a fallback functionality.</p>
+ *
+ *  @includeExample examples/SortingCollatorExample.mxml
  *
  *  @see flash.globalization.Collator
  */

     *  </p>
     *
     *  @see flash.globalization.Collator
     *  @playerversion Flash 10.1
     *  @langversion 3.0
     *  @productversion Flex 4.5
     *  @productversion Flash CS5
     */
    public function SortingCollator()
    {

     *  <code>CollatorMode.SORTING</code>.
     *  For more details and examples of this mode, please
     *  see the documentation for the
     *  <code>flash.globalization.Collator</code> class.
     *  </p>
     *
     *  <p>The locale for this class is supplied by the locale style.
     *  The locale style can be set in several ways:</p>
     *
     *  <ul>
     *      <li>Inheriting the style from a <code>UIComponent</code> by calling the
     *          UIComponent's addStyleClient method.</li>
     *      <li>By using the class in an MXML declaration and inheriting the
     *          locale from the document that contains the declaration.
     *  <listing version="3.0">
     *  Example:
     *  &lt;fx:Declarations&gt;
     *         &lt;s:SortingCollator id="sc" /&gt;
     *  &lt;/fx:Declarations&gt;
     *  </listing>
     *  </li>
     *      <li>By using an MXML declaration and specifying the locale value
     *              in the list of assignments.
     *  <listing version="3.0">
     *  Example:
     *  &lt;fx:Declarations&gt;
     *      &lt;s:SortingCollator id="sc_France" locale="fr-FR" /&gt;
     *  &lt;/fx:Declarations&gt;
     *  </listing>
     *  </li>
     *      <li>Calling the setStyle method, e.g.
     *              <code>sc.setStyle("locale", "fr-FR")</code></li>
     *  </ul>
     *
     *  <p>If the locale style is not set by one of the above techniques, the
