From 86a20f834ab4066950ef3688af00c08543ffb1b1 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sun, 8 Jul 2012 16:01:53 -0700 Subject: Issue 15265: document the exception raised for invalid sample sizes. --- Doc/library/random.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Doc/library/random.rst b/Doc/library/random.rst index daf7a76..a39b636 100644 --- a/Doc/library/random.rst +++ b/Doc/library/random.rst @@ -150,6 +150,9 @@ Functions for sequences: argument. This is especially fast and space efficient for sampling from a large population: ``sample(range(10000000), 60)``. + If the sample size is larger than the population size, a :exc:``ValueError`` + is raised. + The following functions generate specific real-valued distributions. Function parameters are named after the corresponding variables in the distribution's equation, as used in common mathematical practice; most of these equations can -- cgit v0.12