Fix formatting and improve documentation clarity in various files

Author: Alex-PLACET

docs/source/api/xaccessible.rst

@@ -13,4 +13,4 @@ Defined in ``xtensor/core/xaccessible.hpp``
    :members:
 
 .. doxygenclass:: xt::xaccessible
-   :members:
+   :members:

docs/source/api/xfft.rst

@@ -13,4 +13,4 @@ Defined in ``xtensor/misc/xfft.hpp``
 
 .. doxygenfunction:: xt::fft::ifft(E&&, std::ptrdiff_t)
 
-.. doxygenfunction:: xt::fft::convolve(E1&&, E2&&, std::ptrdiff_t)
+.. doxygenfunction:: xt::fft::convolve(E1&&, E2&&, std::ptrdiff_t)

include/xtensor/generators/xrandom.hpp

@@ -914,9 +914,10 @@ namespace xt
          *
          * For weighted random sampling with replacement, binary search with cumulative weights alogrithm is
          * used. For weighted random sampling without replacement, the algorithm used is the exponential sort
-         * from [Efraimidis and Spirakis](https://linkinghub.elsevier.com/retrieve/pii/S002001900500298X) (2006) with the ``weight
-         * / randexp(1)`` [trick](https://web.archive.org/web/20201021162211/https://krlmlr.github.io/wrswoR/)
-         * from Kirill Müller.
+         * from [Efraimidis and Spirakis](https://linkinghub.elsevier.com/retrieve/pii/S002001900500298X)
+         * (2006) with the ``weight / randexp(1)``
+         * [trick](https://web.archive.org/web/20201021162211/https://krlmlr.github.io/wrswoR/) from Kirill
+         * Müller.
          *
          * Note: this function makes a copy of your data, and only 1D data is accepted.
          *

include/xtensor/misc/xmanipulation.hpp

@@ -659,7 +659,7 @@ namespace xt
     template <std::size_t N, class E>
     inline auto atleast_Nd(E&& e)
     {
-        xstrided_slice_vector sv((std::max)(e.dimension(), N), all());
+        xstrided_slice_vector sv((std::max) (e.dimension(), N), all());
         if (e.dimension() < N)
         {
             std::size_t i = 0;
@@ -1099,7 +1099,7 @@ namespace xt
      * @param repeats The number of repetition of each elements.
      *     @p repeats is broadcasted to fit the shape of the given @p axis.
      * @param axis the axis along which to repeat the value
-    * @return an expression with the same shape as ``e``, except along the given ``axis``
+     * @return an expression with the same shape as ``e``, except along the given ``axis``
      */
     template <class E>
     inline auto repeat(E&& e, std::size_t repeats, std::size_t axis)
@@ -1119,7 +1119,7 @@ namespace xt
      *     The size of @p repeats must match the shape of the given @p axis.
      * @param axis the axis along which to repeat the value
      *
-    * @return an expression with the same shape as ``e``, except along the given ``axis``
+     * @return an expression with the same shape as ``e``, except along the given ``axis``
      */
     template <class E>
     inline auto repeat(E&& e, const std::vector<std::size_t>& repeats, std::size_t axis)
@@ -1135,7 +1135,7 @@ namespace xt
      * @param repeats The number of repetition of each elements.
      *     The size of @p repeats must match the shape of the given @p axis.
      * @param axis the axis along which to repeat the value
-    * @return an expression with the same shape as ``e``, except along the given ``axis``
+     * @return an expression with the same shape as ``e``, except along the given ``axis``
      */
     template <class E>
     inline auto repeat(E&& e, std::vector<std::size_t>&& repeats, std::size_t axis)

include/xtensor/views/xindex_view.hpp

@@ -505,8 +505,8 @@ namespace xt
     /**
      * Returns a reference to the element at the specified position in the xindex_view.
      * @param first iterator starting the sequence of indices
-     * @param last iterator ending the sequence of indices (not used, only for compatibility with xexpression operator())
-     * The number of indices in the sequence should be equal to or greater 1.
+     * @param last iterator ending the sequence of indices (not used, only for compatibility with xexpression
+     * operator()) The number of indices in the sequence should be equal to or greater 1.
      */
     template <class CT, class I>
     template <class It>
@@ -518,8 +518,8 @@ namespace xt
     /**
      * Returns a reference to the element at the specified position in the xindex_view.
      * @param first iterator starting the sequence of indices
-     * @param last iterator ending the sequence of indices (not used, only for compatibility with xexpression operator())
-     * The number of indices in the sequence should be equal to or greater 1.
+     * @param last iterator ending the sequence of indices (not used, only for compatibility with xexpression
+     * operator()) The number of indices in the sequence should be equal to or greater 1.
      */
     template <class CT, class I>
     template <class It>