Integrate suggestions from Adam Turner

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
AA-Turner · Sep 8, 2025 · Aug 1, 2025 · Aug 6, 2025 · Aug 7, 2025 · Aug 7, 2025
commit 77f7b9bd6d8390ab51e6eedc3880c96df03f2952
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
@@ -13,35 +13,34 @@ always available. Unless explicitly noted otherwise, all variables are read-only
 
 .. data:: abi_info
 
+   .. versionadded:: next
+
    An object containing information about the ABI of the currently running
    Python interpreter.
-   It should include information that affect the CPython ABI in ways that require
-   a specific build of the interpreter chosen from variants that can co-exist on
-   a single machine.  For example, it does not encode the base OS (Linux or
-   Windows), but does include pointer size since some systems support both 32-
-   and 64- builds.  The available entries are the same on all platforms; e.g.
-   pointer_size is available even on 64-bit-only architectures.
-
-   New entries should be added when needed for a supported platform, or (for
-   enabling an unsupported one) by core dev consensus.  Entries should be removed
-   following :pep:`387`.
+   It should include information that affect the CPython ABI in ways that
+   require a specific build of the interpreter chosen from variants that can
+   co-exist on a single machine.
+   For example, it does not encode the base OS (Linux or Windows), but does
+   include pointer size since some systems support both 32- and 64-bit builds.
+   The available entries are the same on all platforms;
+   e.g. *pointer_size* is available even on 64-bit-only architectures.
 
-   The following attributes are available in CPython:
+   The following attributes are available:
 
    *pointer_bits* is the width of pointers in bits, as an integer, equivalent
    to ``8 * sizeof(void *)``, i.e. usually ``32`` or ``64``.
 
-   *free_threaded* is a boolean indicating whether the interpreter was built
-   with the GIL disabled, i.e. with the :option:`--disable-gil` option,
-   aka free-threading.
+   *free_threaded* is a boolean indicating whether the interpreter supports
+   running in free-threaded mode (i.e. with the GIL disabled).
+   This reflects the presence of the :option:`--disable-gil` configure option.
 
    *debug* is a boolean indicating whether the interpreter was built in
-   :ref:`debug mode <debug-build>`, i.e. with the :option:`--with-pydebug` option.
+   :ref:`debug mode <debug-build>`.
+   This reflects the presence of the :option:`--with-pydebug` configure option.
 
    *byteorder* is a string indicating the native byte order, either ``'big'`` or
-   ``'little'``.  This is the same as the :data:`byteorder` attribute.
-
-   .. versionadded:: next
+   ``'little'``.
+   This is the same as the :data:`sys.byteorder` attribute.
 
 
 .. data:: abiflags

@@ -3643,6 +3643,9 @@ make_impl_info(PyObject *version_info)
 static PyObject *
 make_abi_info(void)
 {
+    // New entries should be added when needed for a supported platform, or (for
+    // enabling an unsupported one) by core dev consensus.  Entries should be removed
+    // following :pep:`387`.
     int res;
     PyObject *abi_info, *value, *ns;
     abi_info = PyDict_New();