On Tue, 5 Sep 2023 19:50:20 GMT, Naoto Sato <na...@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
