Update doc to point to PyInitConfig

Author: vstinner

Doc/whatsnew/3.16.rst

@@ -1141,74 +1141,35 @@ Deprecated C APIs
 Removed C APIs
 --------------
 
-* Remove global configuration variables:
-
-  * :c:var:`!Py_DebugFlag`:
-    Use :c:member:`PyConfig.parser_debug` or
-    :c:func:`PyConfig_Get("parser_debug") <PyConfig_Get>` instead.
-  * :c:var:`!Py_VerboseFlag`:
-    Use :c:member:`PyConfig.verbose` or
-    :c:func:`PyConfig_Get("verbose") <PyConfig_Get>` instead.
-  * :c:var:`!Py_QuietFlag`:
-    Use :c:member:`PyConfig.quiet` or
-    :c:func:`PyConfig_Get("quiet") <PyConfig_Get>` instead.
-  * :c:var:`!Py_InteractiveFlag`:
-    Use :c:member:`PyConfig.interactive` or
-    :c:func:`PyConfig_Get("interactive") <PyConfig_Get>` instead.
-  * :c:var:`!Py_InspectFlag`:
-    Use :c:member:`PyConfig.inspect` or
-    :c:func:`PyConfig_Get("inspect") <PyConfig_Get>` instead.
-  * :c:var:`!Py_OptimizeFlag`:
-    Use :c:member:`PyConfig.optimization_level` or
-    :c:func:`PyConfig_Get("optimization_level") <PyConfig_Get>` instead.
-  * :c:var:`!Py_NoSiteFlag`:
-    Use :c:member:`PyConfig.site_import` or
-    :c:func:`PyConfig_Get("site_import") <PyConfig_Get>` instead.
-  * :c:var:`!Py_BytesWarningFlag`:
-    Use :c:member:`PyConfig.bytes_warning` or
-    :c:func:`PyConfig_Get("bytes_warning") <PyConfig_Get>` instead.
-  * :c:var:`!Py_FrozenFlag`:
-    Use :c:member:`PyConfig.pathconfig_warnings` or
-    :c:func:`PyConfig_Get("pathconfig_warnings") <PyConfig_Get>` instead.
-  * :c:var:`!Py_IgnoreEnvironmentFlag`:
-    Use :c:member:`PyConfig.use_environment` or
-    :c:func:`PyConfig_Get("use_environment") <PyConfig_Get>` instead.
-  * :c:var:`!Py_DontWriteBytecodeFlag`:
-    Use :c:member:`PyConfig.write_bytecode` or
-    :c:func:`PyConfig_Get("write_bytecode") <PyConfig_Get>` instead.
-  * :c:var:`!Py_NoUserSiteDirectory`:
-    Use :c:member:`PyConfig.user_site_directory` or
-    :c:func:`PyConfig_Get("user_site_directory") <PyConfig_Get>` instead.
-  * :c:var:`!Py_UnbufferedStdioFlag`:
-    Use :c:member:`PyConfig.buffered_stdio` or
-    :c:func:`PyConfig_Get("buffered_stdio") <PyConfig_Get>` instead.
-  * :c:var:`!Py_HashRandomizationFlag`:
-    Use :c:member:`PyConfig.use_hash_seed`
-    and :c:member:`PyConfig.hash_seed` or
-    :c:func:`PyConfig_Get("hash_seed") <PyConfig_Get>` instead.
-  * :c:var:`!Py_IsolatedFlag`:
-    Use :c:member:`PyConfig.isolated` or
-    :c:func:`PyConfig_Get("isolated") <PyConfig_Get>` instead.
-  * :c:var:`!Py_LegacyWindowsFSEncodingFlag`:
-    Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` or
-    :c:func:`PyConfig_Get("legacy_windows_fs_encoding") <PyConfig_Get>` instead.
-  * :c:var:`!Py_LegacyWindowsStdioFlag`:
-    Use :c:member:`PyConfig.legacy_windows_stdio` or
-    :c:func:`PyConfig_Get("legacy_windows_stdio") <PyConfig_Get>` instead.
-  * :c:var:`!Py_FileSystemDefaultEncoding`, :c:var:`!Py_HasFileSystemDefaultEncoding`:
-    Use :c:member:`PyConfig.filesystem_encoding` or
-    :c:func:`PyConfig_Get("filesystem_encoding") <PyConfig_Get>` instead.
-  * :c:var:`!Py_FileSystemDefaultEncodeErrors`:
-    Use :c:member:`PyConfig.filesystem_errors` or
-    :c:func:`PyConfig_Get("filesystem_errors") <PyConfig_Get>` instead.
-  * :c:var:`!Py_UTF8Mode`:
-    Use :c:member:`PyPreConfig.utf8_mode` or
-    :c:func:`PyConfig_Get("utf8_mode") <PyConfig_Get>` instead.
-    (see :c:func:`Py_PreInitialize`)
-
-  The :c:func:`Py_InitializeFromConfig` API should be used with
-  :c:type:`PyConfig` to set these options. Or :c:func:`PyConfig_Get` can be
-  used to get these options at runtime.
+* Remove 21 global configuration variables, deprecated in Python 3.12.
+  To initialize Python, the :ref:`PyInitConfig C API <pyinitconfig_api>` can be
+  used instead.
+  To read these variables at runtime, :c:func:`PyConfig_Get` can be used
+  instead.
+  Removed variables with their :ref:`PyInitConfig C API <pyinitconfig_api>` and
+  :c:func:`PyConfig_Get` replacement:
+
+  * :c:var:`!Py_DebugFlag`: Use ``"parser_debug"`` instead.
+  * :c:var:`!Py_VerboseFlag`: Use ``"verbose"`` instead.
+  * :c:var:`!Py_QuietFlag`: Use ``"quiet"`` instead.
+  * :c:var:`!Py_InteractiveFlag`: Use ``"interactive"`` instead.
+  * :c:var:`!Py_InspectFlag`: Use ``"inspect"`` instead.
+  * :c:var:`!Py_OptimizeFlag`: Use ``"optimization_level"`` instead.
+  * :c:var:`!Py_NoSiteFlag`: Use ``"site_import"`` instead (opposite value).
+  * :c:var:`!Py_BytesWarningFlag`: Use ``"bytes_warning"`` instead.
+  * :c:var:`!Py_FrozenFlag`: Use ``"pathconfig_warnings"`` instead (opposite value).
+  * :c:var:`!Py_IgnoreEnvironmentFlag`: Use ``"use_environment"`` instead (opposite value).
+  * :c:var:`!Py_DontWriteBytecodeFlag`: Use ``"write_bytecode"`` instead (opposite value).
+  * :c:var:`!Py_NoUserSiteDirectory`: Use ``"user_site_directory"`` instead (opposite value).
+  * :c:var:`!Py_UnbufferedStdioFlag`: Use ``"buffered_stdio"`` instead (opposite value).
+  * :c:var:`!Py_HashRandomizationFlag`: Use ``"hash_seed"`` instead.
+  * :c:var:`!Py_IsolatedFlag`: Use ``"isolated"`` instead.
+  * :c:var:`!Py_LegacyWindowsFSEncodingFlag`: Use ``"legacy_windows_fs_encoding"`` instead.
+  * :c:var:`!Py_LegacyWindowsStdioFlag`: Use ``"legacy_windows_stdio"`` instead.
+  * :c:var:`!Py_FileSystemDefaultEncoding`, :c:var:`!Py_HasFileSystemDefaultEncoding`: Use ``"filesystem_encoding"`` instead.
+  * :c:var:`!Py_FileSystemDefaultEncodeErrors`: Use ``"filesystem_errors"`` instead.
+  * :c:var:`!Py_UTF8Mode`: Use ``"utf8_mode"`` instead.
+
   (Contributed by Victor Stinner in :gh:`158001`.)
 
 * Remove :c:func:`!PyEval_InitThreads` function which did nothing since Python