 [ResourceBundle("validators")]
 
 /**
- *  The CurrencyValidator class ensures that a String represents a valid
- *  currency amount according to the conventions of a locale.
+ *  The <code>CurrencyValidator</code> class ensures that a String represents
+ *  a valid currency amount according to the conventions of a locale.
+ *
  *  This class uses the <code>locale</code> style for specifying the Locale ID.
  *
- *  <p>The validator can ensure that a currency string falls within a given range
- *  (specified by <code>minValue</code> and <code>maxValue</code> properties),
- *  is an integer (specified by <code>domain</code> property),
+ *  <p>The validator can ensure that a currency string falls within a given
+ *  range (specified by <code>minValue</code> and <code>maxValue</code>
+ *  properties), is an integer (specified by <code>domain</code> property),
  *  is non-negative (specified by <code>allowNegative</code> property),
- *  has the grouping of digits correct according to the locale conventions,
- *  has the correct way of specifying negative numbers and positive numbers,
+ *  correctly specifies negative and positive numbers,
  *  has the correct currency ISO code or currency symbol,
- *  and does not exceed the specified <code>fractionalDigits</code>. The
- *  validator sets default property values from the operating system supplied
- *  locale data but they can be customized for specific needs.</p>
+ *  and does not exceed the specified number of <code>fractionalDigits</code>.
+ *  The validator sets default property values by making use of the 
+ *  <code>flash.globalization.CurrencyFormatter</code> class and therefore the
+ *  locale specific values are supplied by the operating system.</p>
  *
- *  <p>This class internally uses the
- *  <code>flash.globalization.CurrencyFormatter</code> for acquiring
- *  locale-specific validation data and parsing functionality.</p>
- * 
- *  <p>The flash.globalization.CurrencyFormatter class uses the underlying
- *  operating system to supply the locale specific data. In case the operating
- *  system does not provide currency formatting, this class provides fallback
- *  functionality.</p>
+ *  <p>The <code>flash.globalization.CurrencyFormatter</code> class uses the
+ *  underlying operating system to supply the locale specific data. In case
+ *  the operating system does not provide currency formatting, this class
+ *  provides fallback functionality.</p>
  *
  *  @mxml
  *

     *  The three letter ISO 4217 currency code for the locale
     *  being used.
     *
     *  <p>This code is used to determine the currency symbol or string when
     *  validating currency amounts using the <code>validate()</code> method.
     *  </p>
     *
     *  <p>This property is initialized by the constructor

    //--------------------------------------------------------------------------

    /**
     *  Constructs a new <code>CurrencyValidator</code> object to validate
     *  numbers representing currency amounts according to
     *  the conventions of a given locale.
     *  <p>
     *  The locale for this class is supplied by the <code>locale</code>
     *  style property.
     *  The <code>locale</code> style can be set in several ways:
     *  </p>
     *  <ul>
     *  <li>
     *  Inheriting the style from a <code>UIComponent</code> by calling the
     *  <code>UIComponent</code>'s <code>addStyleClient</code> method.
     *  </li>
     *  <li>
     *  By using the class in an MXML declaration and inheriting the
