      *  <code>CollatorMode.SORTING</code>.
      *  For more details and examples of this mode, please
      *  see the documentation for the
-     *  <code>flash.globalization.Collator</code> class
+     *  <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 UIComponent by calling the
+     *      <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:StringTools id="st" /&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:StringTools id="st_turkish" locale="tr-TR" /&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>st.setStyle("locale", "tr-TR")</code></li>
+     *              <code>sc.setStyle("locale", "fr-FR")</code></li>
      *  </ul>
      *
      *  <p>If the locale style is not set by one of the above techniques, the

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

 *  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.
 *
 *  <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
 *  the locale style for the requested Locale ID name, and has methods and
 *  properties that are bindable.
 *  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 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.</p>
 *
 *  @includeExample examples/SortingCollatorExample.mxml
 *
 *  @see flash.globalization.Collator
 */
