diff -r d9c98730e2e8 Doc/library/random.rst
--- a/Doc/library/random.rst	Sat Jul 07 13:34:50 2012 +1000
+++ b/Doc/library/random.rst	Sat Jul 07 12:10:47 2012 +0200
@@ -150,6 +150,9 @@
    argument.  This is especially fast and space efficient for sampling from a large
    population:  ``sample(range(10000000), 60)``.
 
+   If the number of items in the *population* list is lower than the value of the
+   sample *k*, raises :exc:`ValueError`.
+
 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