summaryrefslogtreecommitdiffstats
path: root/Doc/using
diff options
context:
space:
mode:
authorVictor Stinner <victor.stinner@gmail.com>2017-11-20 15:14:07 (GMT)
committerGitHub <noreply@github.com>2017-11-20 15:14:07 (GMT)
commit44862df2eeec62adea20672b0fe2a5d3e160569e (patch)
treee8f66bbbd2b7769ca42a292f553a7ecacb29da57 /Doc/using
parent04dee2720851ec39e831beaa3edc0c59f228f461 (diff)
downloadcpython-44862df2eeec62adea20672b0fe2a5d3e160569e.zip
cpython-44862df2eeec62adea20672b0fe2a5d3e160569e.tar.gz
cpython-44862df2eeec62adea20672b0fe2a5d3e160569e.tar.bz2
bpo-32047: -X dev enables asyncio debug mode (#4418)
The new -X dev command line option now also enables asyncio debug mode.
Diffstat (limited to 'Doc/using')
-rw-r--r--Doc/using/cmdline.rst10
1 files changed, 6 insertions, 4 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
index 01869d1..bf27c1e 100644
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -414,16 +414,18 @@ Miscellaneous options
application. Typical usage is ``python3 -X importtime -c 'import
asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`.
* ``-X dev`` enables the "developer mode": enable debug checks at runtime.
- In short, ``python3 -X dev ...`` behaves as ``PYTHONMALLOC=debug python3
+ In short, ``python3 -X dev ...`` behaves as ``PYTHONMALLOC=debug PYTHONASYNCIODEBUG=1 python3
-W default -X faulthandler ...``, except that the :envvar:`PYTHONMALLOC`
- environment variable is not set in practice. Developer mode:
+ and :envvar:`PYTHONASYNCIODEBUG` environment variables are not set in
+ practice. Developer mode:
* Add ``default`` warnings option. For example, display
:exc:`DeprecationWarning` and :exc:`ResourceWarning` warnings.
- * Install debug hooks on memory allocators as if :envvar:`PYTHONMALLOC`
- is set to ``debug``.
+ * Install debug hooks on memory allocators: see the
+ :c:func:`PyMem_SetupDebugHooks` C function.
* Enable the :mod:`faulthandler` module to dump the Python traceback
on a crash.
+ * Enable :ref:`asyncio debug mode <asyncio-debug-mode>`.
It also allows passing arbitrary values and retrieving them through the
:data:`sys._xoptions` dictionary.