On Fri, 27 Feb 2026 21:58:56 GMT, Justin Lu <[email protected]> wrote:
> Locale APIs which accept BCP 47 tags use hyphen for multiple variant subtags. > Locale APIs that accept multiple (non BCP 47 subtag) variants use > underscores. For example, > > `Locale.of` supports multiple variants separated by underscore. > `Locale.forLanguageTag` supports multiple variants separated by hyphen. > `Locale.Builder.setLanguageTag` supports multiple variants separated by > hyphen. > `Locale.Builder.setVariant` supports multiple variants separated by either > underscore or hyphen. > > The current wording is not detailed enough and implies both formats are > interchangeable within `Locale`. This PR updates the wording to make this > more apparent. Note that I left the constructor behavior out in the new > wording as to not call attention to it. This pull request has now been integrated. Changeset: 86800eb2 Author: Justin Lu <[email protected]> URL: https://git.openjdk.org/jdk/commit/86800eb2b34bd6ea7a77e7a9ac2f7dbce89c11fb Stats: 5 lines in 1 file changed: 3 ins; 0 del; 2 mod 8378723: Locale variant delimiter is unclear Reviewed-by: naoto ------------- PR: https://git.openjdk.org/jdk/pull/29970
