The third and final doc-string sweep by Ka-Ping Yee.
The attached patches update the standard library so that all modules
have docstrings beginning with one-line summaries.
A new docstring was added to formatter. The docstring for os.py
was updated to mention nt, os2, ce in addition to posix, dos, mac.
diff --git a/Lib/random.py b/Lib/random.py
index 9e899ad..21cff89 100644
--- a/Lib/random.py
+++ b/Lib/random.py
@@ -1,23 +1,24 @@
-# R A N D O M V A R I A B L E G E N E R A T O R S
-#
-# distributions on the real line:
-# ------------------------------
-# normal (Gaussian)
-# lognormal
-# negative exponential
-# gamma
-# beta
-#
-# distributions on the circle (angles 0 to 2pi)
-# ---------------------------------------------
-# circular uniform
-# von Mises
+"""Random variable generators.
-# Translated from anonymously contributed C/C++ source.
+ distributions on the real line:
+ ------------------------------
+ normal (Gaussian)
+ lognormal
+ negative exponential
+ gamma
+ beta
-# Multi-threading note: the random number generator used here is not
-# thread-safe; it is possible that two calls return the same random
-# value. See whrandom.py for more info.
+ distributions on the circle (angles 0 to 2pi)
+ ---------------------------------------------
+ circular uniform
+ von Mises
+
+Translated from anonymously contributed C/C++ source.
+
+Multi-threading note: the random number generator used here is not
+thread-safe; it is possible that two calls return the same random
+value. See whrandom.py for more info.
+"""
import whrandom
from whrandom import random, uniform, randint, choice, randrange # For export!