5035569: Formatter should document that %a conversion unsupported for BigDecimal args
authoralanb
Fri, 01 Feb 2013 21:01:44 +0000
changeset 15524 b77777dcac17
parent 15523 cc0ee864bfb5
child 15525 0308cc37489b
5035569: Formatter should document that %a conversion unsupported for BigDecimal args Reviewed-by: darcy Contributed-by: brian.burkhalter@oracle.com
jdk/src/share/classes/java/util/Formatter.java
--- a/jdk/src/share/classes/java/util/Formatter.java	Fri Feb 01 07:25:51 2013 -0800
+++ b/jdk/src/share/classes/java/util/Formatter.java	Fri Feb 01 21:01:44 2013 +0000
@@ -351,7 +351,9 @@
  * <tr><td valign="top">{@code 'a'}, {@code 'A'}
  *     <td valign="top"> floating point
  *     <td> The result is formatted as a hexadecimal floating-point number with
- *     a significand and an exponent
+ *     a significand and an exponent. This conversion is <b>not</b> supported
+ *     for the {@code BigDecimal} type despite the latter's being in the
+ *     <i>floating point</i> argument category.
  *
  * <tr><td valign="top">{@code 't'}, {@code 'T'}
  *     <td valign="top"> date/time