diff options
author | Benjamin Peterson <benjamin@python.org> | 2017-02-09 22:35:38 -0800 |
---|---|---|
committer | Benjamin Peterson <benjamin@python.org> | 2017-02-09 22:35:38 -0800 |
commit | 2328d19475109a50de26fa42832a5286824b0391 (patch) | |
tree | 57b6e2b32c0dd431acd5e804c14c726e5d03e81c | |
parent | 9a86ff08b5e9595a0801045ba3a6738a0bd3783f (diff) | |
parent | 68aff055c847d6f8cfbf75e413f514d98573d43d (diff) | |
download | cpython-2328d19475109a50de26fa42832a5286824b0391.tar.gz |
merge 3.6
-rw-r--r-- | Doc/using/cmdline.rst | 12 |
1 files changed, 7 insertions, 5 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index c0e64d66f2..195f63f0a3 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -396,21 +396,23 @@ Miscellaneous options defines the following possible values: * ``-X faulthandler`` to enable :mod:`faulthandler`; - * ``-X showrefcount`` to enable the output of the total reference count - and memory blocks (only works on debug builds); + * ``-X showrefcount`` to output the total reference count and number of used + memory blocks when the program finishes or after each statement in the + interactive interpreter. This only works on debug builds. * ``-X tracemalloc`` to start tracing Python memory allocations using the :mod:`tracemalloc` module. By default, only the most recent frame is stored in a traceback of a trace. Use ``-X tracemalloc=NFRAME`` to start tracing with a traceback limit of *NFRAME* frames. See the :func:`tracemalloc.start` for more information. - * ``-X showalloccount`` to enable the output of the total count of allocated - objects for each type (only works when built with ``COUNT_ALLOCS`` defined); + * ``-X showalloccount`` to output the total count of allocated objects for + each type when the program finishes. This only works when Python was built with + ``COUNT_ALLOCS`` defined. It also allows passing arbitrary values and retrieving them through the :data:`sys._xoptions` dictionary. .. versionchanged:: 3.2 - It is now allowed to pass :option:`-X` with CPython. + The :option:`-X` option was added. .. versionadded:: 3.3 The ``-X faulthandler`` option. |