summaryrefslogtreecommitdiffstats
path: root/Doc/using
diff options
context:
space:
mode:
authorEzio Melotti <ezio.melotti@gmail.com>2013-03-25 23:59:56 (GMT)
committerEzio Melotti <ezio.melotti@gmail.com>2013-03-25 23:59:56 (GMT)
commit1f8898a5916b942c86ee8716c37d2db388e7bf2f (patch)
tree100c2cdc7d7628190538154de04512cf5c7fe345 /Doc/using
parent84e431648917234f8e3823b60f31d701491a988e (diff)
downloadcpython-1f8898a5916b942c86ee8716c37d2db388e7bf2f.zip
cpython-1f8898a5916b942c86ee8716c37d2db388e7bf2f.tar.gz
cpython-1f8898a5916b942c86ee8716c37d2db388e7bf2f.tar.bz2
#17323: The "[X refs, Y blocks]" printed by debug builds has been disabled by default. It can be re-enabled with the `-X showrefcount` option.
Diffstat (limited to 'Doc/using')
-rw-r--r--Doc/using/cmdline.rst14
1 files changed, 11 insertions, 3 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
index 2703684..adb3739 100644
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -358,13 +358,21 @@ Miscellaneous options
.. cmdoption:: -X
Reserved for various implementation-specific options. CPython currently
- defines just one, you can use ``-X faulthander`` to enable
- :data:`faulthandler`. It also allows to pass arbitrary values and retrieve
- them through the :data:`sys._xoptions` dictionary.
+ defines two possible values:
+
+ * ``-X faulthander`` to enable :mod:`faulthandler`;
+ * ``-X showrefcount`` to enable the output of the total reference count
+ and memory blocks (only works on debug builds);
+
+ It also allows to pass arbitrary values and retrieve them through the
+ :data:`sys._xoptions` dictionary.
.. versionchanged:: 3.2
It is now allowed to pass :option:`-X` with CPython.
+ .. versionadded:: 3.4
+ The ``-X showrefcount`` option.
+
Options you shouldn't use
~~~~~~~~~~~~~~~~~~~~~~~~~