add release date - update docs

Author: ilanschnell

CHANGE_LOG

@@ -1,4 +1,4 @@
-2025-XX-XX   3.5.1:
+2025-07-14   3.5.1:
 -------------------
   * optimize `util.random_p()` for `n < 100`
   * add [Random Bitarrays](random_p.rst) documentation

doc/changelog.rst

@@ -1,6 +1,13 @@
 Change log
 ==========
 
+**3.5.1** (2025-07-14):
+
+* optimize ``util.random_p()`` for ``n < 100``
+* add `Random Bitarrays <random_p.rst>`__ documentation
+* add `statistical tests for random functions <../examples/test_random.py>`__
+
+
 **3.5.0** (2025-07-06):
 
 * add ``util.random_p()``

doc/reference.rst

@@ -1,7 +1,7 @@
 Reference
 =========
 
-bitarray version: 3.5.0 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
+bitarray version: 3.5.1 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
 
 In the following, ``item`` and ``value`` are usually a single bit -
 an integer 0 or 1.
@@ -503,15 +503,18 @@ This sub-module was added in version 1.2.
 
 
 ``random_p(n, /, p=0.5, endian=None)`` -> bitarray
-   Return pseudo-random bitarray of length ``n``.  Each bit has probability ``p`` of
-   being 1.  Equivalent to ``bitarray((random() < p for _ in range(n)), endian)``.
-   The bitarrays are reproducible when calling Python's ``random.seed()`` with a
-   specific seed value.
+   Return (pseudo-) random bitarray of length ``n``.  Each bit has probability ``p``
+   of being one (independent of any other bits).  Mathematically equivalent
+   to ``bitarray((random() < p for _ in range(n)), endian)``, but much faster
+   for large ``n``.  The random bitarrays are reproducible when giving
+   Python's ``random.seed()`` with a specific seed value.
 
    This function requires Python 3.12 or higher, as it depends on the standard
    library function ``random.binomialvariate()``.  Raises ``NotImplementedError``
    when Python version is too low.
 
+   See also: `Random Bitarrays <https://github.com/ilanschnell/bitarray/blob/master/doc/random_p.rst>`__
+
    New in version 3.5