Document the lifetime of PyUnicode_AsUTF8String (GH-92325)

miss-islington · godlygeek · web-flow · commit 367faf71eae9 · 2022-05-06T02:55:01.000-07:00
The current wording implied this, but didn't state it explicitly. (cherry picked from commit 740da8d) Co-authored-by: Matt Wozniski <godlygeek@gmail.com>
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
@@ -1093,7 +1093,8 @@ These are the UTF-8 codec APIs:
 
    This caches the UTF-8 representation of the string in the Unicode object, and
    subsequent calls will return a pointer to the same buffer.  The caller is not
-   responsible for deallocating the buffer.
+   responsible for deallocating the buffer. The buffer is deallocated and
+   pointers to it become invalid when the Unicode object is garbage collected.
 
    .. versionadded:: 3.3
 
