--- a/RandomGenerator.st	Tue Jul 25 18:03:50 2017 +0200
+++ b/RandomGenerator.st	Tue Jul 25 18:07:30 2017 +0200
@@ -42,12 +42,21 @@
     which uses either a OS random number generator or /dev/urandom,
     or an ST/X internal random number generator.
 
-    Warning: this generator should not be used for cryptographic work 
+    Warning: 
+        this generator should not be used for cryptographic work 
     UNLESS: 
         1) you are running on linux, solaris or osx,
         2) you have a working /dev/urandom.
         3) you can trust your /dev/urandom (I don't really know if any/all of them are good)
 
+    It is a facade one one of the other random generators,
+    and will choose (in decreasing priority) the first available generator from the following:
+
+        - OS random system call 
+        - /dev/urandom
+        - rc4-based random (if present)
+        - regular (untrusted) random as fallback
+        
     [author:]
         Stefan Vogel