[Python-checkins] cpython: Issue 15265: document the exception raised for invalid sample sizes.

[raymond.hettinger]

http://hg.python.org/cpython/rev/72174d8af3ba
changeset:   78015:72174d8af3ba
user:        Raymond Hettinger <python at rcn.com>
date:        Sun Jul 08 16:01:53 2012 -0700
summary:
  Issue 15265: document the exception raised for invalid sample sizes.

files:
  Doc/library/random.rst |  3 +++
  1 files changed, 3 insertions(+), 0 deletions(-)


diff --git a/Doc/library/random.rst b/Doc/library/random.rst
--- a/Doc/library/random.rst
+++ b/Doc/library/random.rst
@@ -150,6 +150,9 @@
    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

-- 
Repository URL: http://hg.python.org/cpython