JDK-8198236 : Spec clarification: j.u.Locale.getDisplayName()
  • Type: CSR
  • Component: core-libs
  • Sub-Component: java.util:i18n
  • Priority: P3
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 11
  • Submitted: 2018-02-15
  • Updated: 2018-02-19
  • Resolved: 2018-02-16
Related Reports
CSR :  
Description
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. 


Comments
Thanks, Joe. I corrected the "fix version" to 11.
16-02-2018

Approving the change for JDK 11; it is not appropriate for an update release.
16-02-2018