From 70b033c7561826fb4f90eba10c36b33c1471d399 Mon Sep 17 00:00:00 2001
From: Nikodemus Siivola
Date: Sat, 26 Jan 2013 15:33:48 +0200
Subject: [PATCH] document restrictions on GAUSSIAN-RANDOM
---
numbers.lisp | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/numbers.lisp b/numbers.lisp
index 03430cc..9ced84b 100644
--- a/numbers.lisp
+++ b/numbers.lisp
@@ -13,7 +13,11 @@ MIN and MAX if NUMBER is greater then MAX, otherwise returns NUMBER."
(defun gaussian-random (&optional min max)
"Returns two gaussian random double floats as the primary and secondary value,
optionally constrained by MIN and MAX. Gaussian random numbers form a standard
-normal distribution around 0.0d0."
+normal distribution around 0.0d0.
+
+Sufficiently positive MIN or negative MAX will cause the algorithm used to
+take a very long time. If MIN is positive it should be close to zero, and
+similarly if MAX is negative it should be close to zero."
(labels ((gauss ()
(loop
for x1 = (- (random 2.0d0) 1.0d0)
--
GitLab