bpo-44611: Update docs for os and whatsnew 3.11 (#27314)

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index d3ca8c0476d0c561c7123227e9a6b6ae741efc11..59173d49936e8a2936148e2c386b6b539a1a9e70 100644 (file)
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -4886,7 +4886,7 @@ Random numbers
    device. If the ``/dev/urandom`` device is not available or not readable, the
    :exc:`NotImplementedError` exception is raised.
 
-   On Windows, it will use ``CryptGenRandom()``.
+   On Windows, it will use ``BCryptGenRandom()``.
 
    .. seealso::
       The :mod:`secrets` module provides higher level functions. For an
@@ -4907,6 +4907,10 @@ Random numbers
       function is now used. These functions avoid the usage of an internal file
       descriptor.
 
+   .. versionchanged:: 3.11
+      On Windows, ``BCryptGenRandom()`` is used instead of ``CryptGenRandom()``
+      which is deprecated.
+
 .. data:: GRND_NONBLOCK
 
    By  default, when reading from ``/dev/random``, :func:`getrandom` blocks if

diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst
index 190c422d2a5caf779adae04b7db49f6e564ae3bb..b29d0cbe1538d89d260468acae7ffe283a27b47f 100644 (file)
--- a/Doc/whatsnew/3.11.rst
+++ b/Doc/whatsnew/3.11.rst
@@ -201,8 +201,8 @@ math
 os
 --
 
-* On Windows, :func:`os.urandom`: uses BCryptGenRandom API instead of CryptGenRandom API
-  which is deprecated from Microsoft Windows API.
+* On Windows, :func:`os.urandom` uses ``BCryptGenRandom()`` instead of ``CryptGenRandom()``
+  which is deprecated.
   (Contributed by Dong-hee Na in :issue:`44611`.)