Improve wording of the reverse functions

Author: mcol

src/functions-reference/array_operations.Rmd

@@ -412,19 +412,14 @@ 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
+Stan provides functions to create a new array by reversing the order of
+elements in an existing array. 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}
+<!-- T[]; reverse; (T[] v); -->
+\index{{\tt \bfseries reverse }!{\tt (T[] v): T[]}|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.
+`T[]` **`reverse`**`(T[] v)`<br>\newline
+Return a new array containing the elements of the argument in reverse order.

src/functions-reference/matrix_operations.Rmd

@@ -1618,10 +1618,10 @@ Number of components of v less than v[s]
 \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.
+Return a new vector containing the elements of the argument 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.
+Return a new row vector containing the elements of the argument in reverse order.