[3.11] Backport docstring improvement from 3.12 (#98288)

Backport docstring improvement from 3.12

diff --git a/Lib/random.py b/Lib/random.py
index 1f3530e880fce2faa338376673790c7733cc6a27..f94616e048c554a5c0f92d543386b159d6f76a1b 100644 (file)
--- a/Lib/random.py
+++ b/Lib/random.py
@@ -282,10 +282,10 @@ class Random(_random.Random):
     ## -------------------- integer methods  -------------------
 
     def randrange(self, start, stop=None, step=_ONE):
-        """Choose a random item from range(start, stop[, step]).
+        """Choose a random item from range(stop) or range(start, stop[, step]).
 
-        This fixes the problem with randint() which includes the
-        endpoint; in Python this is usually not what you want.
+        Roughly equivalent to ``choice(range(start, stop, step))`` but
+        supports arbitrarily large ranges and is optimized for common cases.
 
         """