Doc fixups. Don't imply that *readonly* makes the memory immutable.

python · encukou · Jan 3, 2025 · Nov 13, 2023 · Nov 13, 2023 · Jan 18, 2024
commit 0198c89b04639beca150be2797e4417968b4bbb9
diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst
@@ -2166,15 +2166,19 @@ Utility functions
 
 .. function:: memoryview_at(ptr, size, readonly=False)
 
-   This function returns a :class:`memoryview` object of length *size* that
-   references the memory starting at *void \*ptr*, .
-   If *readonly* is true then the :class:`!memoryview` object is immutable.
+   Return a :class:`memoryview` object of length *size* that references memory
+   starting at *void \*ptr*.
+
+   If *readonly* is true, the returned :class:`!memoryview` object can
+   not be used to modify the underlying memory.
+   (Changes made by other means will still be reflected in the returned
+   object.)
 
    This function is similar to :func:`string_at` with the key
    difference of not making a copy of the specified memory.
    It is a semantically equivalent (but more efficient) alternative to
    ``memoryview((c_byte * size).from_address(ptr))``.
-   (While :meth:`~_CData.from_address` only takes integer, *ptr* can also
+   (While :meth:`~_CData.from_address` only takes integers, *ptr* can also
    be given as a :class:`ctypes.POINTER` or a :func:`~ctypes.byref` object.)
 
    .. audit-event:: ctypes.memoryview_at address,size,readonly ctypes.buffer_at