From: Raymond Hettinger <rhettinger@users.noreply.github.com>
Date: Sat, 15 Oct 2022 18:11:04 +0000 (-0500)
Subject: [3.11] Backport docstring improvement from 3.12 (#98288)
X-Git-Tag: v3.11.1~283
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=099620b0ce964ffe85fc52a7595ece13a55ca81c;p=thirdparty%2FPython%2Fcpython.git

[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 1f3530e880fc..f94616e048c5 100644
--- 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.
 
         """