Add documentation for reverse()

Author: mcol

src/functions-reference/array_operations.Rmd

@@ -7,6 +7,7 @@ cat(' * <a href="array-size-and-dimension-function.html">Array Size and Dimensio
 cat(' * <a href="array-broadcasting.html">Array Broadcasting</a>\n')
 cat(' * <a href="array-concatenation.html">Array Concatenation</a>\n')
 cat(' * <a href="sorting-functions.html">Sorting functions</a>\n')
+cat(' * <a href="reversing-functions.html">Reversing Functions</a>\n')
 }
 ```
 
@@ -334,7 +335,7 @@ Any mismatches will cause an error to be thrown.
  x3 = append_array(x1, x2);
 ```
 
-## Sorting functions {#sorting-functions}
+## Sorting Functions {#sorting-functions}
 
 Sorting can be used to sort values or the indices of those values in
 either ascending or descending order.  For example, if `v` is declared
@@ -409,3 +410,21 @@ Number of components of v less than v[s]
 `int` **`rank`**`(int[] v, int s)`<br>\newline
 Number of components of v less than v[s]
 
+## Reversing Functions {#reversing-functions}
+
+Reversing allows to create a copy of array in which elements are in reverse
+order. For example, if `v` is declared as a real array of size 3, with values
+\[ \text{v} = (1,\, -10.3,\, 20.987), \] then
+\[ \mathrm{reverse(v)} = (20.987,\, -10.3,\, 1). \]
+
+<!-- real[]; reverse; (real[] v); -->
+\index{{\tt \bfseries reverse }!{\tt (real[] v): real[]}|hyperpage}
+
+`real[]` **`reverse`**`(real[] v)`<br>\newline
+Create a copy of the array with the elements in reverse order.
+
+<!-- int[]; reverse; (int[] v); -->
+\index{{\tt \bfseries reverse }!{\tt (int[] v): int[]}|hyperpage}
+
+`int[]` **`reverse`**`(int[] v)`<br>\newline
+Create a copy of the array with the elements in reverse order.

src/functions-reference/matrix_operations.Rmd

@@ -16,6 +16,7 @@ cat(' * <a href="softmax.html">Special Matrix Functions</a>\n')
 cat(' * <a href="covariance.html">Covariance Functions</a>\n')
 cat(' * <a href="linear-algebra-functions-and-solvers.html">Linear Algebra Functions and Solvers</a>\n')
 cat(' * <a href="sort-functions.html">Sort Functions</a>\n')
+cat(' * <a href="reverse-functions.html">Reverse Functions</a>\n')
 }
 ```
 
@@ -1544,8 +1545,8 @@ The singular values of A in descending order
 
 ## Sort Functions
 
-see section [sorting functions](#sorting-functions) for examples of how the functions
-work.
+See the [sorting functions section](#sorting-functions) for examples of how
+the functions work.
 
 <!-- vector; sort_asc; (vector v); -->
 \index{{\tt \bfseries sort\_asc }!{\tt (vector v): vector}|hyperpage}
@@ -1611,3 +1612,16 @@ Number of components of v less than v[s]
 `int` **`rank`**`(row_vector v, int s)`<br>\newline
 Number of components of v less than v[s]
 
+## Reverse Functions {#reverse-functions}
+
+<!-- vector; reverse; (vector v); -->
+\index{{\tt \bfseries reverse }!{\tt (vector v): vector}|hyperpage}
+
+`vector` **`reverse`**`(vector v)`<br>\newline
+Create a copy of the vector with the elements in reverse order.
+
+<!-- row_vector; reverse; (row_vector v); -->
+\index{{\tt \bfseries reverse }!{\tt (row_vector v): row_vector}|hyperpage}
+
+`row_vector` **`reverse`**`(row_vector v)`<br>\newline
+Create a copy of the row vector with the elements in reverse order.