8318186: ChoiceFormat inconsistency between applyPattern() and setChoices()

Reviewed-by: naoto

Author: Justin Lu

src/java.base/share/classes/java/text/ChoiceFormat.java

@@ -235,8 +235,9 @@ public class ChoiceFormat extends NumberFormat {
     /**
      * Apply the given pattern to this ChoiceFormat object. The syntax
      * for the ChoiceFormat pattern can be seen in the {@linkplain ##patterns
-     * Patterns} section.
-     *
+     * Patterns} section. Unlike {@link #setChoices(double[], String[])} this
+     * method will throw an {@code IllegalArgumentException} if the {@code
+     * limits} are not in ascending order.
      * @param newPattern a pattern string
      * @throws    NullPointerException if {@code newPattern}
      *            is {@code null}