Doc style fixes

Fix indentation and reword some parts to sound more natural. Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
python · encukou · May 2, 2023 · Apr 24, 2023 · Apr 25, 2023 · Apr 27, 2023
commit 525705a284913d13f6722541d183e09f97a1ae36
diff --git a/Doc/c-api/gcsupport.rst b/Doc/c-api/gcsupport.rst
@@ -69,18 +69,18 @@ rules:
    Analogous to :c:func:`PyObject_GC_New` but allocates *extra_size*
    bytes at the end of the object (at offset
    :c:member:`~PyTypeObject.tp_basicsize`).
-   The allocated memory is initialized: to zero, except for the
-   :c:type:`Python object header <PyObject>`.
+   The allocated memory is initialized to zeros,
+   except for the :c:type:`Python object header <PyObject>`.
 
    The extra data will be deallocated with the object, but otherwise it is
    not managed by Python.
 
    .. warning::
-       The function is marked as unstable because the final mechanism
-       for reserving extra data after an instance is not yet decided.
-       For allocating a variable number of fields, prefer using
-       :c:type:`PyVarObject` and :c:member:`~PyTypeObject.tp_itemsize`
-       instead.
+      The function is marked as unstable because the final mechanism
+      for reserving extra data after an instance is not yet decided.
+      For allocating a variable number of fields, prefer using
+      :c:type:`PyVarObject` and :c:member:`~PyTypeObject.tp_itemsize`
+      instead.
 
    .. versionadded:: 3.12
 

diff --git a/Misc/NEWS.d/next/C API/2023-04-24-10-31-59.gh-issue-103743.2xYA1K.rst b/Misc/NEWS.d/next/C API/2023-04-24-10-31-59.gh-issue-103743.2xYA1K.rst
@@ -1,2 +1,2 @@
-Add ``PyUnstable_Object_GC_NewWithExtraData`` function that can be used to
+Add :c:func:`PyUnstable_Object_GC_NewWithExtraData` function that can be used to
 allocate additional memory after an object for data not managed by Python.