fix doc

RandBLAS/util.hh

@@ -333,11 +333,12 @@ void transpose_square(T* A, int64_t n, int64_t lda) {
 /// \fn weights_to_cdf(int64_t n, T* w, T error_if_below = -std::numeric_limits<T>::epsilon())
 /// @verbatim embed:rst:leading-slashes
 /// Checks if all elements of length-:math:`n` array ":math:`w`" are at no smaller than 
-/// :math:`\ttt{error_if_below}.` If this check passes, then we overwrite
+/// :math:`\ttt{error_if_below}.` If this check passes, then we (implicitly) initialize :math:`v := w`` 
+/// and overwrite :math:`w` by
 ///
 /// .. math::
 ///
-///     w_i := \max\{0, w_i\} / \textstyle\sum_{j=1}^n \max\{0, w_j\}.
+///     w_i = \frac{\textstyle\sum_{\ell=1}^{i}\max\{0, v_{\ell}\}}{\textstyle\sum_{j=1}^n \max\{0, v_j\}}.
 /// 
 /// @endverbatim
 /// On exit, \math{w} is a CDF suitable for use with sample_indices_iid.

rtd/source/api_reference/utilities.rst

@@ -16,10 +16,10 @@ Random sampling from index sets
 .. doxygenfunction:: RandBLAS::weights_to_cdf(int64_t n, T* w, T error_if_below = -std::numeric_limits<T>::epsilon())
   :project: RandBLAS
 
-.. doxygenfunction:: RandBLAS::sample_indices_iid_uniform(int64_t n, int64_t k, sint_t* samples, const state_t &state)
+.. doxygenfunction:: RandBLAS::sample_indices_iid(int64_t n, const T* cdf, int64_t k, sint_t* samples, const state_t &state)
   :project: RandBLAS
 
-.. doxygenfunction:: RandBLAS::sample_indices_iid(int64_t n, const T* cdf, int64_t k, sint_t* samples, const state_t &state)
+.. doxygenfunction:: RandBLAS::sample_indices_iid_uniform(int64_t n, int64_t k, sint_t* samples, const state_t &state)
   :project: RandBLAS
 
 .. doxygenfunction:: RandBLAS::repeated_fisher_yates(int64_t k, int64_t n, int64_t r, sint_t *samples, const state_t &state)