diff --git a/reference/exec/functions/escapeshellcmd.xml b/reference/exec/functions/escapeshellcmd.xml
index fc2331c300..783cbb624b 100644
--- a/reference/exec/functions/escapeshellcmd.xml
+++ b/reference/exec/functions/escapeshellcmd.xml
@@ -27,8 +27,9 @@
    Following characters are preceded by a backslash:
    <literal>&amp;#;`|*?~&lt;&gt;^()[]{}$\</literal>, <literal>\x0A</literal>
    and <literal>\xFF</literal>. <literal>'</literal> and <literal>"</literal>
-   are escaped only if they are not paired. In Windows, all these characters
-   plus <literal>%</literal> and <literal>!</literal> are replaced by a space instead.
+   are escaped only if they are not paired. On Windows, all these characters
+   plus <literal>%</literal> and <literal>!</literal> are preceded by a caret
+   (<literal>^</literal>).
   </para>
  </refsect1>
 
@@ -105,6 +106,13 @@ system($escaped_command);
         Exclamation marks are replaced by spaces.
        </entry>
       </row>
+      <row>
+       <entry>5.3.0</entry>
+       <entry>
+        On Windows, the special characters are now properly escaped.
+        Previously, they have been replaced with a space character.
+       </entry>
+      </row>
      </tbody>
     </tgroup>
    </informaltable>