diff --git a/reference/array/functions/array-replace.xml b/reference/array/functions/array-replace.xml
index 67549459a1ec..7acf65342d3b 100644
--- a/reference/array/functions/array-replace.xml
+++ b/reference/array/functions/array-replace.xml
@@ -13,18 +13,13 @@
    <methodparam rep="repeat"><type>array</type><parameter>replacements</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>array_replace</function> replaces the values of
-   <parameter>array</parameter> with values having the same keys in each of the following
-   arrays. If a key from the first array exists in the second array, its value
-   will be replaced by the value from the second array. If the key exists in the
-   second array, and not the first, it will be created in the first array.
-   If a key only exists in the first array, it will be left as is.
-   If several arrays are passed for replacement, they will be processed
-   in order, the later arrays overwriting the previous values.
+   <function>array_replace</function> is not mutating
   </para>
   <para>
-   <function>array_replace</function> is not recursive : it will replace
-   values in the first array by whatever type is in the second array.
+   <function>array_replace</function> is not recursive
+  </para>
+  <para>
+   <function>array_replace</function> creates a new array by joining all given arrays in given order, replacing values of already existing keys.
   </para>
  </refsect1>
  <refsect1 role="parameters">