gh-93103: Doc uses PyConfig rather than deprecated vars (#96070)
The C API documentation now uses the new PyConfig API, rather than
deprecated global configuration variables.
diff --git a/Doc/c-api/intro.rst b/Doc/c-api/intro.rst
index d9fcd0d..557ccfc 100644
--- a/Doc/c-api/intro.rst
+++ b/Doc/c-api/intro.rst
@@ -153,7 +153,7 @@
.. c:macro:: Py_GETENV(s)
Like ``getenv(s)``, but returns ``NULL`` if :option:`-E` was passed on the
- command line (i.e. if ``Py_IgnoreEnvironmentFlag`` is set).
+ command line (see :c:member:`PyConfig.use_environment`).
.. c:macro:: Py_MAX(x, y)
diff --git a/Doc/c-api/sys.rst b/Doc/c-api/sys.rst
index 32c2bc8..11d5e0e 100644
--- a/Doc/c-api/sys.rst
+++ b/Doc/c-api/sys.rst
@@ -167,7 +167,7 @@
.. versionchanged:: 3.8
The function now uses the UTF-8 encoding on Windows if
- :c:data:`Py_LegacyWindowsFSEncodingFlag` is zero;
+ :c:member:`PyConfig.legacy_windows_fs_encoding` is zero;
.. c:function:: char* Py_EncodeLocale(const wchar_t *text, size_t *error_pos)
@@ -209,7 +209,7 @@
.. versionchanged:: 3.8
The function now uses the UTF-8 encoding on Windows if
- :c:data:`Py_LegacyWindowsFSEncodingFlag` is zero.
+ :c:member:`PyConfig.legacy_windows_fs_encoding` is zero.
.. _systemfunctions:
diff --git a/Doc/c-api/veryhigh.rst b/Doc/c-api/veryhigh.rst
index 7bd47bb..b17818e 100644
--- a/Doc/c-api/veryhigh.rst
+++ b/Doc/c-api/veryhigh.rst
@@ -39,7 +39,7 @@
Note that if an otherwise unhandled :exc:`SystemExit` is raised, this
function will not return ``1``, but exit the process, as long as
- ``Py_InspectFlag`` is not set.
+ :c:member:`PyConfig.inspect` is zero.
.. c:function:: int Py_BytesMain(int argc, char **argv)
@@ -95,7 +95,7 @@
Note that if an otherwise unhandled :exc:`SystemExit` is raised, this
function will not return ``-1``, but exit the process, as long as
- ``Py_InspectFlag`` is not set.
+ :c:member:`PyConfig.inspect` is zero.
.. c:function:: int PyRun_SimpleFile(FILE *fp, const char *filename)
diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst
index 4757371..9546696 100644
--- a/Doc/library/ctypes.rst
+++ b/Doc/library/ctypes.rst
@@ -1068,18 +1068,16 @@
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Some shared libraries not only export functions, they also export variables. An
-example in the Python library itself is the :c:data:`Py_OptimizeFlag`, an integer
-set to 0, 1, or 2, depending on the :option:`-O` or :option:`-OO` flag given on
-startup.
+example in the Python library itself is the :c:data:`Py_Version`, Python
+runtime version number encoded in a single constant integer.
:mod:`ctypes` can access values like this with the :meth:`in_dll` class methods of
the type. *pythonapi* is a predefined symbol giving access to the Python C
api::
- >>> opt_flag = c_int.in_dll(pythonapi, "Py_OptimizeFlag")
- >>> print(opt_flag)
- c_long(0)
- >>>
+ >>> version = ctypes.c_int.in_dll(ctypes.pythonapi, "Py_Version")
+ >>> print(hex(version.value))
+ 0x30c00a0
If the interpreter would have been started with :option:`-O`, the sample would
have printed ``c_long(1)``, or ``c_long(2)`` if :option:`-OO` would have been
