Francois Gouget : testbot/SetWinLocale: Add more information to the usage message.

[Alexandre Julliard]

Module: tools
Branch: master
Commit: e6174bc97f313f9a68ff5ac732e36aa24c637d88
URL:    https://source.winehq.org/git/tools.git/?a=commit;h=e6174bc97f313f9a68ff5ac7...

Author: Francois Gouget <fgouget(a)codeweavers.com>
Date:   Wed Dec 22 17:45:51 2021 +0100

testbot/SetWinLocale: Add more information to the usage message.

Document which options require a reboot or log out + log in.
Also cross-reference the options with the Windows 10 GUI to help with
manual testing; and with the Windows APIs to help match them to the
WineTest output.

Signed-off-by: Francois Gouget <fgouget(a)codeweavers.com>
Signed-off-by: Alexandre Julliard <julliard(a)winehq.org>

---

 testbot/bin/SetWinLocale | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/testbot/bin/SetWinLocale b/testbot/bin/SetWinLocale
index c5f164d..67052f0 100755
--- a/testbot/bin/SetWinLocale
+++ b/testbot/bin/SetWinLocale
@@ -445,11 +445,27 @@ if (defined $Usage)
   print "                 ISO 639-1 language code and CC an ISO 3166-1 alpha-2 country\n";
   print "                 code.\n";
   print "  --locale USR   Specifies the user formats (see --defaults).\n";
+  print "                 . Windows 10 GUI: Time & language -> Region -> Regional\n";
+  print "                   format.\n";
+  print "                 . APIs: UserDefaultLCID(), GetThreadLocale().\n";
   print "  --system SYS   Specifies the system locale (see --defaults).\n";
+  print "                 . Only takes effect after a reboot.\n";
+  print "                 . Windows 10 GUI: Time & language -> Language ->\n";
+  print "                   Administrative Language Settings -> Change system locale.\n";
+  print "                 . APIs: GetSystemDefaultLCID().\n";
   print "  --mui MUI      Specifies the display language (see --defaults).\n";
+  print "                 . Only takes effect after a log out + log in.\n";
+  print "                 . Windows 10 GUI: Time & language -> Language -> Windows\n";
+  print "                   display language.\n";
+  print "                 . APIs: GetSystemPreferredUILanguages(),\n";
+  print "                         GetUserDefaultUILanguage(), GetThreadUILanguage().\n";
   print "  --keyboard KBD Specifies the keyboard layout (see --defaults).\n";
+  print "                 . Windows 10 GUI: Time & language -> Language -> Keyboard ->\n";
+  print "                   Override for default input method.\n";
   print "  --country CTY  Specifies the location using only the country part of the\n";
   print "                 Windows locale (see --defaults).\n";
+  print "                 . Windows 10 GUI: Time & language -> Region -> Country.\n";
+  print "                 . APIs: GetUserGeoID().\n";
   print "  --no-reboot    Do not reboot Windows. Some locale changes will only take\n";
   print "                 effect after the next reboot.\n";
   print "  --debug        Show more detailed information about progress.\n";