summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorAntoine Pitrou <solipsis@pitrou.net>2011-01-06 07:17:30 (GMT)
committerAntoine Pitrou <solipsis@pitrou.net>2011-01-06 07:17:30 (GMT)
commit818581c72a4f93fe0462072dad8440d57a06cd1d (patch)
tree6e733b685aeb0a20e8f9ce76e47f2c3c74a1d5b9 /Doc
parentf1b521ce0c48dc82021e0d3508a17187f456dc2b (diff)
downloadcpython-818581c72a4f93fe0462072dad8440d57a06cd1d.zip
cpython-818581c72a4f93fe0462072dad8440d57a06cd1d.tar.gz
cpython-818581c72a4f93fe0462072dad8440d57a06cd1d.tar.bz2
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. ........
Diffstat (limited to 'Doc')
-rw-r--r--Doc/c-api/arg.rst7
1 files changed, 4 insertions, 3 deletions
diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst
index b5e51f6..21cebe9 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