RFR: 8264425: Update building.md on non-English locales on Windows [v2]

[Naoto Sato]

On Fri, 17 Nov 2023 13:01:38 GMT, Magnus Ihse Bursie <ihse at openjdk.org> wrote:

>> doc/building.html line 404:
>> 
>>> 402: locale for a specific process like this in Windows. The only way is to
>>> 403: change the user locale setting to <strong>US English</strong>, which
>>> 404: will affect all applications run by the user.</p>
>> 
>> IIUC, it is not only the user locale, but also the system locale that derives the file path encoding should be set to US English (using the `UTF-8` beta option may help though)
>
> Oh, here are lots of news to me.
> 
> 1) What is the system locale? How do you check which locale is the system locale (as opposed to the user locale), and how to you change it?
> 
> 2) What is the UTF-8 beta option?

IMHO, Windows has a history of patching up locale support. They have at least System/User/UI default locales.

That said,
1) System locale is the locale of the OS that affects all users/non-Unicode ANSI applications. You can set it in the ControlPanel->Regional Settings->Administrative->"Change System Locale" button.

2) There is a check box that reads "Beta: Use Unicode UTF-8 for worldwide language support". This enables ANSI applications to use UTF-8 for wide char <-> multibyte conversion. 

So in a nutshell, these combinations of settings end up in many unexpected situations. YMMV

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16694#discussion_r1397720150