Skip to content

Commit bc9b6e2

Browse files
authored
bpo-32043: Rephrase -X dev documentation (#4478)
* should not be more verbose if the code is correct * enabled checks can be "expensive"
1 parent 25420fe commit bc9b6e2

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

Doc/using/cmdline.rst

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -411,8 +411,10 @@ Miscellaneous options
411411
nested imports). Note that its output may be broken in multi-threaded
412412
application. Typical usage is ``python3 -X importtime -c 'import
413413
asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`.
414-
* ``-X dev`` enables the "developer mode": enable debug checks at runtime.
415-
Developer mode:
414+
* ``-X dev``: enable CPython's "developer mode", introducing additional
415+
runtime checks which are too expensive to be enabled by default. It should
416+
not be more verbose than the default if the code is correct: new warnings
417+
are only emitted when an issue is detected. Effect of the developer mode:
416418

417419
* Warning filters: add a filter to display all warnings (``"default"``
418420
action), except of :exc:`BytesWarning` which still depends on the
@@ -441,8 +443,7 @@ Miscellaneous options
441443
The ``-X showalloccount`` option.
442444

443445
.. versionadded:: 3.7
444-
The ``-X importtime``, ``-X dev`` and :envvar:`PYTHONPROFILEIMPORTTIME`
445-
options.
446+
The ``-X importtime`` and ``-X dev`` options.
446447

447448

448449
Options you shouldn't use

0 commit comments

Comments
 (0)