svn commit: r600602 - /commons/proper/lang/trunk/src/java/org/apache/commons/lang/text/ExtendedMessageFormat.java

[mb...@apache.org]

Author: mbenson
Date: Mon Dec  3 09:19:23 2007
New Revision: 600602

URL: http://svn.apache.org/viewvc?rev=600602&view=rev
Log:
add note about toPattern() differences pre JDK 1.4

Modified:
    commons/proper/lang/trunk/src/java/org/apache/commons/lang/text/ExtendedMessageFormat.java

Modified: commons/proper/lang/trunk/src/java/org/apache/commons/lang/text/ExtendedMessageFormat.java
URL: http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/java/org/apache/commons/lang/text/ExtendedMessageFormat.java?rev=600602&r1=600601&r2=600602&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/java/org/apache/commons/lang/text/ExtendedMessageFormat.java (original)
+++ commons/proper/lang/trunk/src/java/org/apache/commons/lang/text/ExtendedMessageFormat.java Mon Dec  3 09:19:23 2007
@@ -29,9 +29,16 @@
  * Extends <code>MessageFormat</code> to allow pluggable/additional formatting
  * options for embedded format elements; requires a "meta-format", i.e. a
  * <code>Format</code> capable of parsing and formatting other
- * <code>Format</code>s. One shortcoming is that recursive choice formats do
- * not inherit knowledge of the extended formatters and are limited to those
- * available with <code>java.text.MessageFormat</code> (patches welcome).
+ * <code>Format</code>s.
+ * 
+ * Limitations:
+ * <ul>
+ * <li><code>toPattern()</code> results are tailored to JDK 1.4+ output and
+ * will produce fairly drastically different results on earlier JDKs.</li>
+ * <li>Recursive choice formats do not inherit knowledge of the extended
+ * formatters and are limited to those available with
+ * <code>java.text.MessageFormat</code>.</li>
+ * </ul>
  * 
  * @author Matt Benson
  * @since 2.4