diff --git a/functions/pcre.xml b/functions/pcre.xml
index bf597f96c5..1dd045c1bd 100644
--- a/functions/pcre.xml
+++ b/functions/pcre.xml
@@ -234,12 +234,17 @@ preg_match_all ("/\(?  (\d{3})?  \)?  (?(1)  [\-\s] ) \d{3}-\d{4}/x",
       <paramdef>mixed <parameter>pattern</parameter></paramdef>
       <paramdef>mixed <parameter>replacement</parameter></paramdef>
       <paramdef>mixed <parameter>subject</parameter></paramdef>
+      <paramdef>int <parameter><optional>limit</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-     Searches <parameter>subject</parameter> for matches to <parameter>
-     pattern</parameter> and replaces them with <parameter>replacement
-     </parameter>.
+     Searches <parameter>subject</parameter> for matches to
+     <parameter> pattern</parameter> and replaces them with
+     <parameter>replacement </parameter>. If
+     <parameter>limit</parameter> is specified, then only
+     <parameter>limit</parameter> matches will be replaced; if
+     <parameter>limit</parameter> is omitted or is -1, then all
+     matches are replaced.
     </para>
     <para>
      <parameter>Replacement</parameter> may contain references of the