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

Francois Gouget fgouget at codeweavers.com
Wed Dec 22 10:45:51 CST 2021


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 at codeweavers.com>
---
 testbot/bin/SetWinLocale | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/testbot/bin/SetWinLocale b/testbot/bin/SetWinLocale
index 6cc810226..2de673360 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";
-- 
2.30.2



More information about the wine-devel mailing list