@@ -320,82 +320,105 @@ a regular expression on the warning message.
320320.TP
321321.BI " \- X " option
322322Set implementation-specific option. The following options are available:
323-
324- \fB \- X cpu_count= \fI N \fR : override the return value of \fI os.cpu_count() \fR ;
325- \fB \- X cpu_count=default \fR cancels overriding; also \fB PYTHON_CPU_COUNT \fI
326-
327- \fB \- X dev \fR : enable CPython's "development mode", introducing additional
328- runtime checks which are too expensive to be enabled by default. It
329- will not be more verbose than the default if the code is correct: new
330- warnings are only emitted when an issue is detected. Effect of the
331- developer mode:
332- * Add default warning filter, as \fB \- W default \fR
333- * Install debug hooks on memory allocators: see the
334- PyMem_SetupDebugHooks() C function
335- * Enable the faulthandler module to dump the Python traceback on a
336- crash
337- * Enable asyncio debug mode
338- * Set the dev_mode attribute of sys.flags to True
339- * io.IOBase destructor logs close() exceptions
340-
341- \fB \- X importtime \fR : show how long each import takes. It shows module name,
342- cumulative time (including nested imports) and self time (excluding
343- nested imports). Note that its output may be broken in multi-threaded
344- application. Typical usage is
345- \fB python3 \- X importtime \- c 'import asyncio' \fR
346-
347- \fB \- X importtime=2 \fR enables additional output that indicates when an
348- imported module has already been loaded. In such cases, the string
349- \fB cached \fR will be printed in both time columns.
350-
351- \fB \- X faulthandler \fR : enable faulthandler
352-
353- \fB \- X frozen_modules= \fR [\fB on \fR |\fB off \fR ]: whether or not frozen modules
354- should be used.
355- The default is "on" (or "off" if you are running a local build).
356-
357- \fB \- X gil= \fR [\fB 0 \fR |\fB 1 \fR ]: enable (1) or disable (0) the GIL; also
358- \fB PYTHON_GIL \fR
359- Only available in builds configured with \fB \-\- disable \- gil \fR .
360-
361- \fB \- X int_max_str_digits= \fI number \fR : limit the size of int<->str conversions.
362- This helps avoid denial of service attacks when parsing untrusted data.
363- The default is sys.int_info.default_max_str_digits. 0 disables.
364-
365- \fB \- X no_debug_ranges \fR : disable the inclusion of the tables mapping extra
366- location information (end line, start column offset and end column
367- offset) to every instruction in code objects. This is useful when
368- smaller code objects and pyc files are desired as well as suppressing
369- the extra visual location indicators when the interpreter displays
370- tracebacks.
371-
372- \fB \- X perf \fR : support the Linux "perf" profiler; also \fB PYTHONPERFSUPPORT=1 \fR
373-
374- \fB \- X perf_jit \fR : support the Linux "perf" profiler with DWARF support;
375- also \fB PYTHON_PERF_JIT_SUPPORT=1 \fR
376-
377- \fB \- X presite= \fI MOD \fR : import this module before site; also \fB PYTHON_PRESITE \fR
378- This only works on debug builds.
379-
380- \fB \- X pycache_prefix= \fI PATH \fR : enable writing .pyc files to a parallel
381- tree rooted at the given directory instead of to the code tree.
382-
383- \fB \- X showrefcount \fR : output the total reference count and number of used
384- memory blocks when the program finishes or after each statement in the
385- interactive interpreter. This only works on debug builds
386-
387- \fB \- X tracemalloc \fR : start tracing Python memory allocations using the
388- tracemalloc module. By default, only the most recent frame is stored in a
389- traceback of a trace. Use \- X tracemalloc=NFRAME to start tracing with a
390- traceback limit of NFRAME frames
391-
392- \fB \- X utf8 \fR : enable UTF-8 mode for operating system interfaces,
393- overriding the default locale-aware mode. \fB \- X utf8=0 \fR explicitly
394- disables UTF-8 mode (even when it would otherwise activate
395- automatically). See \fB PYTHONUTF8 \fR for more details
396-
397- \fB \- X warn_default_encoding \fR : enable opt-in EncodingWarning for 'encoding=None'
398-
323+ .RS
324+ .TP
325+ \fB \- X cpu_count= \fI N \fR
326+ Override the return value of \fI os.cpu_count() \fR .
327+ \fB \- X cpu_count=default \fR cancels overriding.
328+ See also \fB PYTHON_CPU_COUNT \fR .
329+ .TP
330+ \fB \- X dev \fR
331+ Enable CPython's "development mode", introducing additional
332+ runtime checks which are too expensive to be enabled by default. It
333+ will not be more verbose than the default if the code is correct: new
334+ warnings are only emitted when an issue is detected. Effect of the
335+ developer mode:
336+ .RS
337+ .IP \(bu 2
338+ Add default warning filter, as \fB \- W default \fR .
339+ .IP \(bu 2
340+ Install debug hooks on memory allocators: see the
341+ PyMem_SetupDebugHooks() C function.
342+ .IP \(bu 2
343+ Enable the faulthandler module to dump the Python traceback on a crash.
344+ .IP \(bu 2
345+ Enable asyncio debug mode.
346+ .IP \(bu 2
347+ Set the dev_mode attribute of sys.flags to True.
348+ .IP \(bu 2
349+ io.IOBase destructor logs close() exceptions.
350+ .RE
351+ .TP
352+ \fB \- X importtime \fR
353+ Show how long each import takes. It shows module name,
354+ cumulative time (including nested imports) and self time (excluding
355+ nested imports). Note that its output may be broken in multi-threaded
356+ application. Typical usage is
357+ \fB python3 \- X importtime \- c 'import asyncio' \fR .
358+ .IP
359+ \fB \- X importtime=2 \fR enables additional output that indicates when an
360+ imported module has already been loaded. In such cases, the string
361+ \fB cached \fR will be printed in both time columns.
362+ .TP
363+ \fB \- X faulthandler \fR
364+ Enable faulthandler.
365+ .TP
366+ \fB \- X frozen_modules= \fR [\fB on \fR |\fB off \fR ]
367+ Whether or not frozen modules should be used.
368+ The default is "on" (or "off" if you are running a local build).
369+ .TP
370+ \fB \- X gil= \fR [\fB 0 \fR |\fB 1 \fR ]
371+ Enable (1) or disable (0) the GIL. See also \fB PYTHON_GIL \fR .
372+ Only available in builds configured with \fB \-\- disable \- gil \fR .
373+ .TP
374+ \fB \- X int_max_str_digits= \fI number \fR
375+ Limit the size of int<->str conversions.
376+ This helps avoid denial of service attacks when parsing untrusted data.
377+ The default is sys.int_info.default_max_str_digits. 0 disables.
378+ .TP
379+ \fB \- X no_debug_ranges \fR
380+ Disable the inclusion of the tables mapping extra
381+ location information (end line, start column offset and end column
382+ offset) to every instruction in code objects. This is useful when
383+ smaller code objects and pyc files are desired as well as suppressing
384+ the extra visual location indicators when the interpreter displays
385+ tracebacks.
386+ .TP
387+ \fB \- X perf \fR
388+ Support the Linux "perf" profiler. See also \fB PYTHONPERFSUPPORT=1 \fR .
389+ .TP
390+ \fB \- X perf_jit \fR
391+ Support the Linux "perf" profiler with DWARF support.
392+ See also \fB PYTHON_PERF_JIT_SUPPORT=1 \fR .
393+ .TP
394+ \fB \- X presite= \fI MOD \fR
395+ Import this module before site. See also \fB PYTHON_PRESITE \fR .
396+ This only works on debug builds.
397+ .TP
398+ \fB \- X pycache_prefix= \fI PATH \fR
399+ Enable writing .pyc files to a parallel
400+ tree rooted at the given directory instead of to the code tree.
401+ .TP
402+ \fB \- X showrefcount \fR
403+ Output the total reference count and number of used
404+ memory blocks when the program finishes or after each statement in the
405+ interactive interpreter. This only works on debug builds.
406+ .TP
407+ \fB \- X tracemalloc \fR
408+ Start tracing Python memory allocations using the
409+ tracemalloc module. By default, only the most recent frame is stored in a
410+ traceback of a trace. Use \fB \- X tracemalloc= \fI NFRAME \fR to start tracing with a
411+ traceback limit of NFRAME frames.
412+ .TP
413+ \fB \- X utf8 \fR
414+ Enable UTF-8 mode for operating system interfaces,
415+ overriding the default locale-aware mode. \fB \- X utf8=0 \fR explicitly
416+ disables UTF-8 mode (even when it would otherwise activate
417+ automatically). See \fB PYTHONUTF8 \fR for more details.
418+ .TP
419+ \fB \- X warn_default_encoding \fR
420+ Enable opt-in EncodingWarning for 'encoding=None'.
421+ .RE
399422.TP
400423.B \- x
401424Skip the first line of the source. This is intended for a DOS
0 commit comments