Author: Armin Rigo <[email protected]>
Branch: 
Changeset: r1443:c6b154ad47ea
Date: 2013-12-08 12:28 +0100
http://bitbucket.org/cffi/cffi/changeset/c6b154ad47ea/

Log:    Simplify a bit this paragraph.

diff --git a/doc/source/index.rst b/doc/source/index.rst
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1272,13 +1272,10 @@
 the list of cdata objects made by ``new_handle()`` the one which has got
 the same ``void *`` value; and then it fetches in that cdata object the
 corresponding Python object.  The cdata object keeps the Python object
-alive, but if the cdata object *itself* is not alive any more, then it
-will crash!  (Obviously, the real
-implementation is more efficient than suggested here.)  In other words,
-the result of ``new_handle()`` has *ownership* (similarly to
-``ffi.new()`` or ``ffi.gc()``) in the sense that the association ``void
-* -> python_object`` is only valid as long as *this* exact cdata
-returned by ``new_handle()`` is alive.
+alive, similar to how ``ffi.new()`` returns a cdata object that keeps a
+piece of memory alive.  If the cdata object *itself* is not alive any
+more, then the association ``void * -> python_object`` is dead and
+``from_handle()`` will crash.
 
 .. "versionadded:: 0.7" --- inlined in the previous paragraph
 
_______________________________________________
pypy-commit mailing list
[email protected]
https://mail.python.org/mailman/listinfo/pypy-commit

Reply via email to