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