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

 *  <code>flash.globalization.Collator</code>.
 *  Therefore the locale-specific string comparison is provided by the
 *  <code>flash.globalization.Collator</code>.
 *  However this MatchingCollator 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
 *  generated by the flash.globalization class.</p>
 *
 *  <p>The flash.globalization.Collator class use 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>
 *
 *  @see flash.globalization.Collator
 */

     *  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:MatchingCollator id="mc" /&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:MatchingCollator id="mc_France" locale="fr-FR" /&gt;
     *  &lt;/fx:Declarations&gt;
     *  </listing>
     *  </li>
     *      <li>Calling the setStyle method, e.g.
     *              <code>mc.setStyle("locale", "fr-FR")</code></li>
     *  </ul>
     *
     *  <p>If the locale style is not set by one of the above techniques,
