Index: src/main/java/java/util/Currency.java =================================================================== --- src/main/java/java/util/Currency.java (revision 525158) +++ src/main/java/java/util/Currency.java (working copy) @@ -45,7 +45,7 @@ } /** - * Answers the currency instance for this currency code. + * Returns the Currency instance for this currency code. *
*
* @param currencyCode
@@ -81,7 +81,7 @@
}
/***************************************************************************
- * Answers the currency instance for this locale.
+ * Returns the Currency instance for the given locale.
*
* @param locale
* java.util.Locale
@@ -115,7 +115,7 @@
}
/**
- * Answers this currency's ISO 4217 currency code.
+ * Returns this currency's ISO 4217 currency code.
*
* @return this currency's ISO 4217 currency code
*/
@@ -122,14 +122,13 @@
public String getCurrencyCode() {
return currencyCode;
}
-
+
/**
- * Answers the symbol for this currency in the default locale. For instance,
- * if the default locale is the US, the symbol of the US dollar is "$". For
- * other locales it may be "US$". If no symbol can be determined, the ISO
- * 4217 currency code of the US dollar is returned.
+ * Returns the currency symbol for the default locale.
*
- * @return the symbol for this currency in the default locale
+ * Equivalent to getSymbol(Locale.getDefault())
+ *
+ * @return the currency symbol for the default locale.
*/
public String getSymbol() {
return getSymbol(Locale.getDefault());
@@ -136,7 +135,7 @@
}
/**
- * Return the symbol for this currency in the given locale.
+ * Returns the currency symbol for the given locale.
*
* * If the locale doesn't have any countries (e.g. @@ -154,9 +153,9 @@ *
* * @param locale - * java.lang.String locale - * @return symbol java.lang.String the representation of this Currency's - * symbol in this locale + * the locale + * @return symbol the representation of this Currency's symbol in this + * locale */ public String getSymbol(Locale locale) { if (locale.getCountry().equals("")) { //$NON-NLS-1$ @@ -194,10 +193,9 @@ } /** - * Answers the default number of fraction digits for this currency. For - * instance, the default number of fraction digits for the US dollar is 2. - * For the Japanese Yen the number is 0. In the case of pseudo-currencies, - * such as IMF Special Drawing Rights, -1 is returned. + * Returns the default number of fraction digits for this currency (i.e. the + * number of digits after the decimal point). For pseudo currencies this + * method returns -1. * * @return the default number of fraction digits for this currency */ @@ -206,7 +204,7 @@ } /** - * Answers this currency's ISO 4217 currency code. + * Returns this currency's ISO 4217 currency code. * * @return this currency's ISO 4217 currency code */