diff options
author | Benjamin Peterson <benjamin@python.org> | 2017-02-09 22:31:17 -0800 |
---|---|---|
committer | Benjamin Peterson <benjamin@python.org> | 2017-02-09 22:31:17 -0800 |
commit | 68aff055c847d6f8cfbf75e413f514d98573d43d (patch) | |
tree | 0ee35c8cdb8cbcbd2a77441ac5e4ef77db7a36e5 /Doc/using | |
parent | a4629c57a42d092ec150f5f90fc12bb795fc8153 (diff) | |
download | cpython-68aff055c847d6f8cfbf75e413f514d98573d43d.tar.gz |
massage English for -X descriptions a bit
Diffstat (limited to 'Doc/using')
-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. |