RFR: 8353322: Specification of ChoiceFormat#parse(String, ParsePosition) is inadequate [v3]

[Alan Bateman]

On Wed, 2 Apr 2025 19:43:29 GMT, Justin Lu <jlu at openjdk.org> wrote:

>> src/java.base/share/classes/java/text/ChoiceFormat.java line 562:
>> 
>>> 560:     /**
>>> 561:      * Parses a {@code Number} from the input text, the subtype of which is always
>>> 562:      * {@code Double}. The value returned is the {@code limit} corresponding
>> 
>> I wonder if we could improve the first sentence, e.g. "Parses the input text from the parse position as a Double" ?
>
> Right, I think we can make the sub-type wording simplification and should mention `ParsePosition`'s role in the method.

Thanks for the update, it reads much better now, no other comments from me.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/24361#discussion_r2026287478