DOC: Improve docstrings

Small docstring improvements with specifics for seed size

Author: bashtage

doc/source/mrg32k3a.rst

@@ -16,7 +16,13 @@ Random generator
    get_state
    set_state
 
+Parallel generation
+===================
+.. autosummary::
+   :toctree: generated/
 
+   jump
+   
 Simple random data
 ==================
 .. autosummary::

randomstate/shims/mlfg-1279-861/mlfg-1279-861.pxi

@@ -81,7 +81,7 @@ seed : {None, int}, optional
     Can be an integer in [0, 2**64] or ``None`` (the default).
     If ``seed`` is ``None``, then ``mlfg_1279_861.RandomState`` will try to
     read entropy from ``/dev/urandom`` (or the Windows analogue) if available
-    to produce a 64-bit seed. If unavailable, the a 64-bit hash of the time
+    to produce a 64-bit seed. If unavailable, a 64-bit hash of the time
     and process ID is used.
 
 Notes

randomstate/shims/mrg32k3a/mrg32k3a.pxi

@@ -87,11 +87,11 @@ cdef void jump_state(aug_state* state):
 DEF CLASS_DOCSTRING = """
 RandomState(seed=None)
 
-Container for L\'Ecuyer MRG32K3A pseudo random number generator.
+Container for L'Ecuyer MRG32K3A pseudo random number generator.
 
 MRG32K3A is a 32-bit implementation of L'Ecuyer's combined multiple
-recursive generator ([1]_, [2]_). MRG32K3A has a period of 2**191 and
-supports multiple streams (NOT IMPLEMENTED YET).
+recursive generator [1]_, [2]_. MRG32K3A has a period of :math:`2^{191}`,
+supports jumping ahead and is suitable for parallel applications.
 
 ``mrg32k3a.RandomState`` exposes a number of methods for generating random
 numbers drawn from a variety of probability distributions. In addition to the
@@ -116,8 +116,8 @@ seed : {None, int}, optional
     Random seed initializing the pseudo-random number generator.
     Can be an integer in [0, 2**64] or ``None`` (the default).
     If `seed` is ``None``, then ``mrg32k3a.RandomState`` will try to read data
-    from ``/dev/urandom`` (or the Windows analogue) if available or seed from
-    the clock otherwise.
+    from ``/dev/urandom`` (or the Windows analogue) if available. If
+    unavailable, a 64-bit hash of the time and process ID is used.
 
 Notes
 -----

randomstate/shims/pcg-32/pcg-32.pxi

@@ -67,8 +67,8 @@ seed : {None, long}, optional
     Random seed initializing the pseudo-random number generator.
     Can be an integer in [0, 2**64] or ``None`` (the default).
     If `seed` is ``None``, then ``pcg32.RandomState`` will try to read data
-    from ``/dev/urandom`` (or the Windows analogue) if available or seed from
-    the clock otherwise.  
+    from ``/dev/urandom`` (or the Windows analogue) if available. If
+    unavailable, a 64-bit hash of the time and process ID is used.
 inc : {None, int}, optional
     Stream to return.  
     Can be an integer in [0, 2**64] or ``None`` (the default).  If `inc` is 

randomstate/shims/pcg-64/pcg-64-docstring.pxi

@@ -30,8 +30,8 @@ seed : {None, long}, optional
     Random seed initializing the pseudo-random number generator.
     Can be an integer in [0, 2**128] or ``None`` (the default).
     If `seed` is ``None``, then ``pcg64.RandomState`` will try to read data
-    from ``/dev/urandom`` (or the Windows analogue) if available or seed from
-    the clock otherwise.
+    from ``/dev/urandom`` (or the Windows analogue) if available. If
+    unavailable, a 64-bit hash of the time and process ID is used.
 inc : {None, int}, optional
     Stream to return.
     Can be an integer in [0, 2**128] or ``None`` (the default).  If `inc` is

randomstate/shims/xorshift1024/xorshift1024.pxi

@@ -75,10 +75,10 @@ Parameters
 ----------
 seed : {None, int}, optional
     Random seed initializing the pseudo-random number generator.
-    Can be an integer or ``None`` (the default).
-    If `seed` is ``None``, then ``xorshift1024.RandomState`` will try to read data
-    from ``/dev/urandom`` (or the Windows analogue) if available or seed from
-    the clock otherwise.
+    Can be an integer in [0, 2**64] or ``None`` (the default).
+    If `seed` is ``None``, then ``xorshift1024.RandomState`` will try to read
+    data from ``/dev/urandom`` (or the Windows analogue) if available.  If
+    unavailable, a 64-bit hash of the time and process ID is used.
 
 Notes
 -----

randomstate/shims/xorshift128/xorshift128.pxi

@@ -70,10 +70,10 @@ Parameters
 ----------
 seed : {None, int}, optional
     Random seed initializing the pseudo-random number generator.
-    Can be an integer or ``None`` (the default).
-    If `seed` is ``None``, then ``xorshift128.RandomState`` will try to read data
-    from ``/dev/urandom`` (or the Windows analogue) if available or seed from
-    the clock otherwise.
+    Can be an integer in [0, 2**64] or ``None`` (the default).
+    If `seed` is ``None``, then ``xorshift128.RandomState`` will try to read
+    data from ``/dev/urandom`` (or the Windows analogue) if available.  If
+    unavailable, a 64-bit hash of the time and process ID is used.
 
 Notes
 -----