From ed261b0578ec71271a40b74702c3e4d0a8ba35f5 Mon Sep 17 00:00:00 2001
From: alanb <unknown>
Date: Fri, 1 Feb 2013 21:01:44 +0000
Subject: [PATCH] 5035569: Formatter should document that %a conversion
 unsupported for BigDecimal args Reviewed-by: darcy Contributed-by:
 brian.burkhalter@oracle.com

---
 src/share/classes/java/util/Formatter.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/share/classes/java/util/Formatter.java b/src/share/classes/java/util/Formatter.java
index f5f479588..03a580049 100644
--- a/src/share/classes/java/util/Formatter.java
+++ b/src/share/classes/java/util/Formatter.java
@@ -351,7 +351,9 @@ import sun.misc.FormattedFloatingDecimal;
  * <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
-- 
GitLab