Issue #10840: make it explicit that "s*" and friends provide contiguous memory.

diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst
index a32dd09c8ecf90f3bda2d174d14646d38280ca18..d4dda7c6939bc474a209085be29c875a7038d95c 100644 (file)
--- 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 :c:type:`Py_buffer` structure gets filled, the underlying
 buffer is locked so that the caller can subsequently use the buffer even