Issue 6261: Clarify behavior of random.uniform().

diff --git a/Doc/library/random.rst b/Doc/library/random.rst
index ecfa607e189a7be31cb2ea61da73c454cd78ad34..6c7a04dca44015a25c5e99bc9cc51d44f1438726 100644 (file)
--- a/Doc/library/random.rst
+++ b/Doc/library/random.rst
@@ -142,6 +142,8 @@ be found in any statistics text.
    Return a random floating point number *N* such that ``a <= N <= b`` for
    ``a <= b`` and ``b <= N <= a`` for ``b < a``.
 
+   The end-point value ``b`` may or may not be included in the range
+   depending on floating-point rounding in the equation ``a + (b-a) * random()``.
 
 .. function:: triangular(low, high, mode)
 

diff --git a/Lib/random.py b/Lib/random.py
index afec8a0e90060a48c33a82580dc55d965104475e..12b4e1b2a7098044042480866a75e3b1d8894a25 100644 (file)
--- a/Lib/random.py
+++ b/Lib/random.py
@@ -333,7 +333,7 @@ class Random(_random.Random):
 ## -------------------- uniform distribution -------------------
 
     def uniform(self, a, b):
-        """Get a random number in the range [a, b)."""
+        "Get a random number in the range [a, b) or [a, b] depending on rounding."
         return a + (b-a) * self.random()
 
 ## -------------------- triangular --------------------