[3.11] gh-90300: Sort the -X options and some envvars in the Python CLI help (GH...

(cherry picked from commit 870cd901ea72e85eea825425336305296ee443cc)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
(cherry picked from commit e54bdeab9ce2958a22ba08c1f1f1431c5e8056bd)

diff --git a/Python/initconfig.c b/Python/initconfig.c
index d739cb927bc9ac0957afbd9b80abe004e51c5ea1..98860d0418a5631ddfaef3862d80e896f5dfbc73 100644 (file)
--- a/Python/initconfig.c
+++ b/Python/initconfig.c
@@ -78,19 +78,6 @@ arg ...: arguments passed to program in sys.argv[1:]\n\
 
 static const char usage_xoptions[] = "\
 The following implementation-specific options are available:\n\
--X faulthandler: enable faulthandler\n\
--X showrefcount: output the total reference count and number of used\n\
-         memory blocks when the program finishes or after each statement in\n\
-         the interactive interpreter.  This only works on debug builds\n\
--X tracemalloc: start tracing Python memory allocations using the\n\
-         tracemalloc module.  By default, only the most recent frame is stored\n\
-         in a traceback of a trace.  Use -X tracemalloc=NFRAME to start\n\
-         tracing with a traceback limit of NFRAME frames\n\
--X importtime: show how long each import takes.  It shows module name,\n\
-         cumulative time (including nested imports) and self time (excluding\n\
-         nested imports).  Note that its output may be broken in\n\
-         multi-threaded application.\n\
-         Typical usage is python3 -X importtime -c 'import asyncio'\n\
 -X dev : enable CPython's \"development mode\", introducing additional runtime\n\
          checks which are too expensive to be enabled by default.  Effect of\n\
          the developer mode:\n\
@@ -102,23 +89,41 @@ The following implementation-specific options are available:\n\
           * Enable asyncio debug mode\n\
           * Set the dev_mode attribute of sys.flags to True\n\
           * io.IOBase destructor logs close() exceptions\n\
--X utf8: enable UTF-8 mode for operating system interfaces, overriding the\n\
-         default locale-aware mode.  -X utf8=0 explicitly disables UTF-8 mode\n\
-         (even when it would otherwise activate automatically)\n\
--X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted\n\
-         at the given directory instead of to the code tree\n\
--X warn_default_encoding: enable opt-in EncodingWarning for 'encoding=None'\n\
--X no_debug_ranges: disable the inclusion of the tables mapping extra location\n\
-         information (end line, start column offset and end column offset) to\n\
-         every instruction in code objects.  This is useful when smaller code\n\
-         objects and pyc files are desired as well as suppressing the extra\n\
-         visual location indicators when the interpreter displays tracebacks.\n\
+-X faulthandler: enable faulthandler\n\
 -X frozen_modules=[on|off]: whether or not frozen modules should be used.\n\
          The default is \"on\" (or \"off\" if you are running a local build).\n\
+-X importtime: show how long each import takes.  It shows module name,\n\
+         cumulative time (including nested imports) and self time (excluding\n\
+         nested imports).  Note that its output may be broken in\n\
+         multi-threaded application.\n\
+         Typical usage is python3 -X importtime -c 'import asyncio'\n\
 -X int_max_str_digits=number: limit the size of int<->str conversions.\n\
          This helps avoid denial of service attacks when parsing untrusted\n\
          data.  The default is sys.int_info.default_max_str_digits.\n\
-         0 disables.\
+         0 disables.\n\
+-X no_debug_ranges: disable the inclusion of the tables mapping extra location\n\
+         information (end line, start column offset and end column offset) to\n\
+         every instruction in code objects.  This is useful when smaller code\n\
+         objects and pyc files are desired as well as suppressing the extra\n\
+         visual location indicators when the interpreter displays tracebacks.\n\
+-X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted\n\
+         at the given directory instead of to the code tree\n\
+"
+#ifdef Py_STATS
+"-X pystats: Enable pystats collection at startup.\n"
+#endif
+"\
+-X showrefcount: output the total reference count and number of used\n\
+         memory blocks when the program finishes or after each statement in\n\
+         the interactive interpreter.  This only works on debug builds\n\
+-X tracemalloc: start tracing Python memory allocations using the\n\
+         tracemalloc module.  By default, only the most recent frame is stored\n\
+         in a traceback of a trace.  Use -X tracemalloc=NFRAME to start\n\
+         tracing with a traceback limit of NFRAME frames\n\
+-X utf8: enable UTF-8 mode for operating system interfaces, overriding the\n\
+         default locale-aware mode.  -X utf8=0 explicitly disables UTF-8 mode\n\
+         (even when it would otherwise activate automatically)\n\
+-X warn_default_encoding: enable opt-in EncodingWarning for 'encoding=None'\
 "
 ;