Summary

Clarify the Locale.getDisplayName() method description regarding the separators in parentheses.

Problem

Currently, it is simply a comma character in the spec, which can actually be localized into locale specific separator character.

Solution

Add a clarifying text.

Specification

Add the following sentence to the end of the method description of Locale.getDisplayName() and Locale.getDisplayName(Locale), just before the last sentence: “If the language, script, country, and variant fields are all empty, this function returns the empty string.“

The field separator in the above parentheses, denoted as a comma character, may be localized depending on the locale.