add release date - update docs

Author: ilanschnell

CHANGE_LOG

@@ -1,4 +1,4 @@
-2025-XX-XX   3.5.0:
+2025-07-06   3.5.0:
 -------------------
   * add `util.random_p()`
   * improve sparse compression testing

README.rst

@@ -901,8 +901,9 @@ This sub-module was added in version 1.2.
    The bitarrays are reproducible when calling Python's ``random.seed()`` with a
    specific seed value.
 
-   This function is only implemented when using Python 3.12 or higher, as it
-   requires the standard library function ``random.binomialvariate()``.
+   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.
 
    New in version 3.5
 

doc/changelog.rst

@@ -1,6 +1,12 @@
 Change log
 ==========
 
+**3.5.0** (2025-07-06):
+
+* add ``util.random_p()``
+* improve sparse compression testing
+
+
 **3.4.3** (2025-06-23):
 
 * minor updates to documentation

doc/reference.rst

@@ -1,7 +1,7 @@
 Reference
 =========
 
-bitarray version: 3.4.3 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
+bitarray version: 3.5.0 -- `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.
@@ -502,6 +502,19 @@ This sub-module was added in version 1.2.
    New in version 1.8
 
 
+``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.
+
+   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.
+
+   New in version 3.5
+
+
 ``sc_decode(stream)`` -> bitarray
    Decompress binary stream (an integer iterator, or bytes-like object) of a
    sparse compressed (``sc``) bitarray, and return the decoded  bitarray.
@@ -545,8 +558,8 @@ This sub-module was added in version 1.2.
    iteration is stopped as soon as one mismatch is found.
 
 
-``urandom(length, /, endian=None)`` -> bitarray
-   Return a bitarray of ``length`` random bits (uses ``os.urandom``).
+``urandom(n, /, endian=None)`` -> bitarray
+   Return random bitarray of length ``n`` (uses ``os.urandom()``).
 
    New in version 1.7