<i18n dev> RFR: 8041488: Locale-Dependent List Patterns [v12]

[Roger Riggs]

On Tue, 5 Sep 2023 19:50:20 GMT, Naoto Sato <naoto at openjdk.org> wrote:

>> src/java.base/share/classes/java/text/ListFormat.java line 46:
>> 
>>> 44:  * defined in Unicode Consortium's LDML specification for
>>> 45:  * <a href="https://www.unicode.org/reports/tr35/tr35-general.html#ListPatterns">
>>> 46:  * List Patterns</a>.
>> 
>> The main function, it seems to me, is to change the representation from one form to another. what would you think about the following:
>> 
>> The {@code ListFormat} class is a tool for converting a list of strings to a text representation and vice versa in a locale-sensitive way. It transforms strings to text in accordance with the List Patterns (link) as defined in Unicode Consortium's LDML specification. For example, it can be used to format a list of 3 weekdays, i.e. "Monday", "Wednesday", "Friday", as "Monday, Wednesday, and Friday" in an inclusive list pattern.
>
> Thanks. Will modify the wording in the next revision. I think we should stick to the wording `format`/`parse` here.

I'd stick to the general first sentence structure used by DateFormat, Format, and MessageFormat.
("tools" in OpenJDK are standalone programs.)

For example, 
"ListFormat formats and parses lists of strings."

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

PR Review Comment: https://git.openjdk.org/jdk/pull/15130#discussion_r1316343327