mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 11:23:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

bpo-32043: Rephrase -X dev documentation (#4478)

Browse source 
* should not be more verbose if the code is correct
* enabled checks can be "expensive"
This commit is contained in:
Victor Stinner 2017-11-20 18:59:50 -08:00 • committed by GitHub
parent 25420fe290
commit bc9b6e29cb
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/using/cmdline.rst
View file

@ -411,8 +411,10 @@ Miscellaneous options
nested imports). Note that its output may be broken in multi-threaded nested imports). Note that its output may be broken in multi-threaded
application. Typical usage is ``python3 -X importtime -c 'import application. Typical usage is ``python3 -X importtime -c 'import
asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`. asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`.
* ``-X dev`` enables the "developer mode": enable debug checks at runtime. * ``-X dev``: enable CPython's "developer mode", introducing additional
Developer mode: runtime checks which are too expensive to be enabled by default. It should
not be more verbose than the default if the code is correct: new warnings
are only emitted when an issue is detected. Effect of the developer mode:
* Warning filters: add a filter to display all warnings (``"default"`` * Warning filters: add a filter to display all warnings (``"default"``
action), except of :exc:`BytesWarning` which still depends on the action), except of :exc:`BytesWarning` which still depends on the
@ -441,8 +443,7 @@ Miscellaneous options
The ``-X showalloccount`` option. The ``-X showalloccount`` option.
.. versionadded:: 3.7 .. versionadded:: 3.7
The ``-X importtime``, ``-X dev`` and :envvar:`PYTHONPROFILEIMPORTTIME` The ``-X importtime`` and ``-X dev`` options.
options.
Options you shouldn't use Options you shouldn't use