summaryrefslogtreecommitdiffstats
path: root/Misc/SpecialBuilds.txt
diff options
context:
space:
mode:
authorBenjamin Peterson <benjamin@python.org>2014-03-30 21:16:09 (GMT)
committerBenjamin Peterson <benjamin@python.org>2014-03-30 21:16:09 (GMT)
commitff57aefa97bf82719b893fd9ed1d2b5f4ef51d04 (patch)
treeefbb7623b1c68baf3459f3b18d1d91335179b9ae /Misc/SpecialBuilds.txt
parent3da9fbbe83c6c77c3a6db8d93b200dd81ef86a5f (diff)
downloadcpython-ff57aefa97bf82719b893fd9ed1d2b5f4ef51d04.zip
cpython-ff57aefa97bf82719b893fd9ed1d2b5f4ef51d04.tar.gz
cpython-ff57aefa97bf82719b893fd9ed1d2b5f4ef51d04.tar.bz2
update notes to talk about -X showrefcount
Diffstat (limited to 'Misc/SpecialBuilds.txt')
-rw-r--r--Misc/SpecialBuilds.txt8
1 files changed, 5 insertions, 3 deletions
diff --git a/Misc/SpecialBuilds.txt b/Misc/SpecialBuilds.txt
index 646ac23..732cb00 100644
--- a/Misc/SpecialBuilds.txt
+++ b/Misc/SpecialBuilds.txt
@@ -13,12 +13,14 @@ Py_REF_DEBUG
------------
Turn on aggregate reference counting. This arranges that extern _Py_RefTotal
-hold a count of all references, the sum of ob_refcnt across all objects. In a
-debug-mode build, this is where the "8288" comes from in
+hold a count of all references, the sum of ob_refcnt across all objects.
+Passing ``-X showrefcount`` on the command line causes the interactive
+interpreter to print the reference count total as well the number of memory
+blocks allocated after each statement:
>>> 23
23
- [8288 refs]
+ [8288 refs, 14332 blocks]
>>>
Note that if this count increases when you're not storing away new objects,