From cc20b76ad00d5932eda124a49818c0af4265d3d4 Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Fri, 29 May 1998 17:51:59 +0000
Subject: [PATCH] Add comments explaining thread unsafety of this code.

---
 Lib/whrandom.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/Lib/whrandom.py b/Lib/whrandom.py
index 95e88f3399b..7f33fd60799 100644
--- a/Lib/whrandom.py
+++ b/Lib/whrandom.py
@@ -29,6 +29,13 @@
 #	Adrian Baddeley.
 
 
+# Multi-threading note: the random number generator used here is not
+# thread-safe; it is possible that nearly simultaneous calls in
+# different theads return the same random value.  To avoid this, you
+# have to use a lock around all calls.  (I didn't want to slow this
+# down in the serial case by using a lock here.)
+
+
 class whrandom:
 	#
 	# Initialize an instance.
@@ -60,6 +67,8 @@ def seed(self, x = 0, y = 0, z = 0):
 	# Get the next random number in the range [0.0, 1.0).
 	#
 	def random(self):
+		# This part is thread-unsafe:
+		# BEGIN CRITICAL SECTION
 		x, y, z = self._seed
 		#
 		x = (171 * x) % 30269
@@ -67,6 +76,7 @@ def random(self):
 		z = (170 * z) % 30323
 		#
 		self._seed = x, y, z
+		# END CRITICAL SECTION
 		#
 		return (x/30269.0 + y/30307.0 + z/30323.0) % 1.0
 	#