diff -r 75285bd6991b Doc/library/os.rst
--- a/Doc/library/os.rst	Tue Oct 20 00:03:33 2015 -0700
+++ b/Doc/library/os.rst	Tue Oct 20 10:01:52 2015 +0200
@@ -3737,8 +3737,13 @@ Miscellaneous Functions
    For an easy-to-use interface to the random number generator
    provided by your platform, please see :class:`random.SystemRandom`.
 
+   On Linux, the function blocks if the entropy pool has not yet been
+   initialized.
+
    .. versionchanged:: 3.5
-      On Linux 3.17 and newer, the ``getrandom()`` syscall is now used
-      when available.  On OpenBSD 5.6 and newer, the C ``getentropy()``
-      function is now used. These functions avoid the usage of an internal file
+      On Linux 3.17 and newer, the `getrandom() syscall
+      <http://man7.org/linux/man-pages/man2/getrandom.2.html>`_ is now used
+      when available.  On OpenBSD 5.6 and newer, the C `getentropy() function
+      <http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man2/getentropy.2?query=getentropy&sec=2>`_
+      is now used. These functions avoid the usage of an internal file
       descriptor.