summaryrefslogtreecommitdiffstats
path: root/Misc/SpecialBuilds.txt
diff options
context:
space:
mode:
authorTim Peters <tim.peters@gmail.com>2002-07-10 18:47:03 (GMT)
committerTim Peters <tim.peters@gmail.com>2002-07-10 18:47:03 (GMT)
commita788f5ef028d30f03e43932abb4650d502433c83 (patch)
tree421aa53aa2fc854db9cd4386d16d2885ddfd30c7 /Misc/SpecialBuilds.txt
parent3e2d18be3f4f309a075ee4de29ad0d340ecebfe0 (diff)
downloadcpython-a788f5ef028d30f03e43932abb4650d502433c83.zip
cpython-a788f5ef028d30f03e43932abb4650d502433c83.tar.gz
cpython-a788f5ef028d30f03e43932abb4650d502433c83.tar.bz2
Clarified sys.getobjects() pragmatics.
Diffstat (limited to 'Misc/SpecialBuilds.txt')
-rw-r--r--Misc/SpecialBuilds.txt17
1 files changed, 11 insertions, 6 deletions
diff --git a/Misc/SpecialBuilds.txt b/Misc/SpecialBuilds.txt
index 3c10f37..0551c8e 100644
--- a/Misc/SpecialBuilds.txt
+++ b/Misc/SpecialBuilds.txt
@@ -42,12 +42,17 @@ Py_TRACE_REFS implies Py_REF_DEBUG.
Special gimmicks:
sys.getobjects(max[, type])
- Return list of the most-recently allocated max objects, most recently
- allocated first in the list, least-recently allocated last in the
- list. max=0 means no limit on list length. If an optional type
- object is passed, the list is also restricted to objects of that
- type. The return list itself, and some temp objects created just
- to call sys.getobjects(), are excluded from the return list.
+ Return list of the (no more than) max most-recently allocated objects,
+ most recently allocated first in the list, least-recently allocated
+ last in the list. max=0 means no limit on list length.
+ If an optional type object is passed, the list is also restricted to
+ objects of that type.
+ The return list itself, and some temp objects created just to call
+ sys.getobjects(), are excluded from the return list. Note that the
+ list returned is just another object, though, so may appear in the
+ return list the next time you call getobjects(); note that every
+ object in the list is kept alive too, simply by virtue of being in
+ the list.
envar PYTHONDUMPREFS
If this envar exists, Py_Finalize() arranges to print a list of