      *  locale style can be set in several ways:
      *  </p>
      *  <ul>
-     *  <li>         *
-     *  Inheriting the style from a UIComponent by calling the
-     *  UIComponent's addStyleClient method.
-     *  </li>
      *  <li>
-     *  By using the class in an mxml declaration and inheriting the
+     *  By using the class in an MXML declaration and inheriting the
      *  locale from the document that contains the declaration.
      *  </li>
+     *  Example:
      *  <listing version="3.0" >
-     *  &lt;fx:Declarations&gt;
-     *         &lt;s:StringTools id="st" /&gt;
+     *  &lt;fx:Declarations&gt; <br>
+     *         &lt;s:CurrencyFormatter id="cf" /&gt; <br>
      *  &lt;/fx:Declarations&gt;
      *  </listing>
      *  <li>
-     *  By using an mxml declaration and specifying the locale value
+     *  By using an MXML declaration and specifying the locale value
      *  in the list of assignments.
      *  </li>
+     *  Example:
      *  <listing version="3.0" >
-     *  &lt;fx:Declarations&gt;
-     *      &lt;s:StringTools id="st_turkish" locale="tr-TR" /&gt;
+     *  &lt;fx:Declarations&gt; <br>
+     *      &lt;s:CurrencyFormatter id="cf_Japanese" locale="ja-JP" /&gt; <br>
      *  &lt;/fx:Declarations&gt;
      *  </listing>
      *  <li>
      *  Calling the setStyle method,
-     *  e.g. <code>st.setStyle("locale", "tr-TR")</code>
+     *  e.g. <code>cf.setStyle("locale", "ja-JP")</code>
+     *  </li>
+     *  <li> 
+     *  Inheriting the style from a <code>UIComponent</code> by calling the
+     *  UIComponent's <code>addStyleClient()</code> method.
      *  </li>
      *  </ul>
      *  <p>
      *  If the locale style is not set by one of the above techniques,
      *  the methods of this class that depend on the locale
-     *  will throw an error.
-     *  </p>         *
-     *  <p>Certain properties such as the <code>currencySymbol</code>
-     *  and <code>currencyISOCode</code> properties are set
-     *  automatically based on the locale.</p>
-     *
-     *  <p><strong>NOTE: When a fallback locale is used the currency
+     *  will set lastOperationStatus to 
+     *  <code>LastOperationStatus.LOCALE_UNDEFINED_ERROR</code>
+     *  and depending on the return type the methods will return 
+     *  <code>null</code>, 0, or <code>undefined</code>.</p>
+     * 
+     *  <p>Most of the properties of 
+     *  this class are automatically set based on the locale style. If the
+     *  locale style is changed, any properties that have not been explicitly
+     *  set will also be updated based on the new locale. Note that the 
+     *  actual locale that is used is specified by the actualLocaleIDName
+     *  property.</p>
+     *
+     *  <p><strong>NOTE: When a fallback locale is used, the currency
      *  properties are set to default values,
      *  and therefore the <code>currencySymbol</code> or
      *  <code>currencyISOCode</code> properties might be given unexpected

     *  the <code>withCurrencySymbol</code> parameter set to
     *  <code>true</code>.</p>
     *
     *  <p>This property is initialized by the constructor based on
     *  the actual locale that is used. When a fallback
     *  locale is used this property reflects the preferred, default
     *  currency symbol for the fallback locale.</p>
     *
     *  @default dependent on the actual locale and operating system
     *
     *  @see #format()
     *  @see #setCurrency()
     *  @see #formattingWithCurrencySymbolIsSafe
     *  @see #currencyISOCode
     *
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2
     *  @langversion 3.0
     */
    public function get currencySymbol():String
    {


        fallbackLastOperationStatus = LastOperationStatus.NO_ERROR;

        return requestedISOCode == defaultCurrencyISOCode;
    }

    [Bindable("change")]
