Issue #27706: Document that random.seed() is non-deterministic when PYTHONHASHSEED...

diff --git a/Doc/library/random.rst b/Doc/library/random.rst
index 1316d2d56906837f996b8804feea3b81f8bf54cc..c569fa1c3a10cf907741aea850a76f282ec73537 100644 (file)
--- a/Doc/library/random.rst
+++ b/Doc/library/random.rst
@@ -80,6 +80,9 @@ Bookkeeping functions:
    they are used instead of the system time (see the :func:`os.urandom` function
    for details on availability).
 
+   If a :term:`hashable` object is given, deterministic results are only assured
+   when :envvar:`PYTHONHASHSEED` is disabled.
+
    .. versionchanged:: 2.4
       formerly, operating system resources were not used.