[Python-checkins] (merge 3.1 -> 3.2): Explicitly mention that people should not depend on immediate

[gregory.p.smith]

http://hg.python.org/cpython/rev/0c595f4bbfc8
changeset:   68352:0c595f4bbfc8
branch:      3.2
parent:      68347:6e3551d37b03
parent:      68351:d1356689e089
user:        Gregory P. Smith <greg at krypto.org>
date:        Thu Mar 10 11:32:29 2011 -0800
summary:
  Explicitly mention that people should not depend on immediate
finalization of objects.

HG Enter commit message.  Lines beginning with 'HG:' are removed.

files:
  Doc/reference/datamodel.rst

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -69,6 +69,8 @@
    containing circular references.  See the documentation of the :mod:`gc`
    module for information on controlling the collection of cyclic garbage.
    Other implementations act differently and CPython may change.
+   Do not depend on immediate finalization of objects when they become
+   unreachable (ex: always close files).
 
 Note that the use of the implementation's tracing or debugging facilities may
 keep objects alive that would normally be collectable. Also note that catching

-- 
Repository URL: http://hg.python.org/cpython