diff options
| author | Ammar Askar <ammar@ammaraskar.com> | 2021-07-07 19:07:12 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-07-07 19:07:12 (GMT) |
| commit | 4823d9a51281ebbc8e8d82a0dd3edc7d13ea8ac7 (patch) | |
| tree | b7c97af7b1d15da75321e1434997163cd8c6b9d0 /Doc/using | |
| parent | 3d3027c5fcc683c14ee55ad231d79971ba12b24d (diff) | |
| download | cpython-4823d9a51281ebbc8e8d82a0dd3edc7d13ea8ac7.zip cpython-4823d9a51281ebbc8e8d82a0dd3edc7d13ea8ac7.tar.gz cpython-4823d9a51281ebbc8e8d82a0dd3edc7d13ea8ac7.tar.bz2 | |
bpo-43950: Add option to opt-out of PEP-657 (GH-27023)
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
Co-authored-by: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>
Co-authored-by: Ammar Askar <ammar@ammaraskar.com>
Diffstat (limited to 'Doc/using')
| -rw-r--r-- | Doc/using/cmdline.rst | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index 25e05d4..98fdba2 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -474,6 +474,12 @@ Miscellaneous options * ``-X warn_default_encoding`` issues a :class:`EncodingWarning` when the locale-specific default encoding is used for opening files. See also :envvar:`PYTHONWARNDEFAULTENCODING`. + * ``-X no_debug_ranges`` disables the inclusion of the tables mapping extra + location information (end line, start column offset and end column offset) + to every instruction in code objects. This is useful when smaller code + objects and pyc files are desired as well as supressing the extra visual + location indicators when the interpreter displays tracebacks. See also + :envvar:`PYTHONNODEBUGRANGES`. It also allows passing arbitrary values and retrieving them through the :data:`sys._xoptions` dictionary. @@ -509,6 +515,9 @@ Miscellaneous options .. deprecated-removed:: 3.9 3.10 The ``-X oldparser`` option. + .. versionadded:: 3.11 + The ``-X no_debug_ranges`` option. + Options you shouldn't use ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -936,6 +945,17 @@ conflict. .. versionadded:: 3.10 +.. envvar:: PYTHONNODEBUGRANGES + + If this variable is set, it disables the inclusion of the tables mapping + extra location information (end line, start column offset and end column + offset) to every instruction in code objects. This is useful when smaller + code objects and pyc files are desired as well as supressing the extra visual + location indicators when the interpreter displays tracebacks. + + .. versionadded:: 3.11 + + Debug-mode variables ~~~~~~~~~~~~~~~~~~~~ |