From 818581c72a4f93fe0462072dad8440d57a06cd1d Mon Sep 17 00:00:00 2001 From: Antoine Pitrou Date: Thu, 6 Jan 2011 07:17:30 +0000 Subject: [PATCH] Merged revisions 87784 via svnmerge from svn+ssh://pythondev@svn.python.org/python/branches/py3k ........ r87784 | antoine.pitrou | 2011-01-06 08:16:31 +0100 (jeu., 06 janv. 2011) | 3 lines Issue #10840: make it explicit that "s*" and friends provide contiguous memory. ........ --- Doc/c-api/arg.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst index b5e51f6fc18..21cebe90860 100644 --- a/Doc/c-api/arg.rst +++ b/Doc/c-api/arg.rst @@ -30,9 +30,10 @@ variable(s) whose address should be passed. Strings and buffers ------------------- -These formats do not expect you to provide raw storage for the returned string -or bytes. Also, you won't have to release any memory yourself, except with -the ``es``, ``es#``, ``et`` and ``et#`` formats. +These formats allow to access an object as a contiguous chunk of memory. +You don't have to provide raw storage for the returned unicode or bytes +area. Also, you won't have to release any memory yourself, except with the +``es``, ``es#``, ``et`` and ``et#`` formats. However, when a :ctype:`Py_buffer` structure gets filled, the underlying buffer is locked so that the caller can subsequently use the buffer even