From ffc3a8b630939750c638832dc86db53c4e835815 Mon Sep 17 00:00:00 2001
From: Florian Engelhardt <florian.engelhardt@r-nw.de>
Date: Thu, 8 Sep 2022 15:15:07 +0200
Subject: [PATCH 1/6] add documentation for the `memory_reset_peak_usage`
 functions

---
 .../functions/memory-reset-peak-usage.xml     | 89 +++++++++++++++++++
 reference/info/versions.xml                   |  1 +
 2 files changed, 90 insertions(+)
 create mode 100644 reference/info/functions/memory-reset-peak-usage.xml

diff --git a/reference/info/functions/memory-reset-peak-usage.xml b/reference/info/functions/memory-reset-peak-usage.xml
new file mode 100644
index 000000000000..3c248b185711
--- /dev/null
+++ b/reference/info/functions/memory-reset-peak-usage.xml
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<refentry xml:id="function.memory-reset-peak-usage" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>memory_reset_peak_usage</refname>
+  <refpurpose>Reset the peak memory usage</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>memory_reset_peak_usage</methodname>
+   <void/>
+  </methodsynopsis>
+  <para>
+   Resets the peak memory usage returned by the
+   <function>memory_get_peak_usage</function> function.
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>memory_get_peak_usage</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+   <title><function>memory_reset_peak_usage</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// This is only an example, the numbers below will
+// differ depending on your system
+
+echo memory_get_peak_usage(); // 422440
+
+$a = str_repeat("Hello", 424242);
+
+echo memory_get_peak_usage(); // 2508672
+
+unset($a);
+
+memory_reset_peak_usage();
+
+$a = str_repeat("Hello", 2424);
+
+echo memory_get_peak_usage(); // 399208
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/info/versions.xml b/reference/info/versions.xml
index b64496244cca..30d96b2d81e2 100644
--- a/reference/info/versions.xml
+++ b/reference/info/versions.xml
@@ -42,6 +42,7 @@
  <function name="ini_get_all" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="ini_restore" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="ini_set" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <function name="memory_reset_peak_usage" from="PHP 8 &gt;= 8.2.0"/>
  <function name="memory_get_peak_usage" from="PHP 5 &gt;= 5.2.0, PHP 7, PHP 8"/>
  <function name="memory_get_usage" from="PHP 4 &gt;= 4.3.2, PHP 5, PHP 7, PHP 8"/>
  <function name="php_ini_loaded_file" from="PHP 5 &gt;= 5.2.4, PHP 7, PHP 8"/>

From 01e11fcd4d6a603f41c1f29834b2ca43a26ebc38 Mon Sep 17 00:00:00 2001
From: Florian Engelhardt <florian.engelhardt@r-nw.de>
Date: Thu, 8 Sep 2022 15:21:02 +0200
Subject: [PATCH 2/6] add link from `memory_get_peak_usage` to
 `memory_reset_peak_usage`

---
 reference/info/functions/memory-get-peak-usage.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/info/functions/memory-get-peak-usage.xml b/reference/info/functions/memory-get-peak-usage.xml
index 6fccb0a258d4..e6b8ffbc2210 100644
--- a/reference/info/functions/memory-get-peak-usage.xml
+++ b/reference/info/functions/memory-get-peak-usage.xml
@@ -48,6 +48,7 @@
   <para>
    <simplelist>
     <member><function>memory_get_usage</function></member>
+    <member><function>memory_reset_peak_usage</function></member>
     <member><link linkend="ini.memory-limit">memory_limit</link></member>
    </simplelist>
   </para>

From d4eef25a3967fbeb85017b74b4c9f690bdcd5c2d Mon Sep 17 00:00:00 2001
From: Florian Engelhardt <florian.engelhardt@r-nw.de>
Date: Thu, 8 Sep 2022 15:25:48 +0200
Subject: [PATCH 3/6] add missing parameters section for
 `memory_reset_peak_usage`

---
 reference/info/functions/memory-reset-peak-usage.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/info/functions/memory-reset-peak-usage.xml b/reference/info/functions/memory-reset-peak-usage.xml
index 3c248b185711..21086f554d46 100644
--- a/reference/info/functions/memory-reset-peak-usage.xml
+++ b/reference/info/functions/memory-reset-peak-usage.xml
@@ -18,6 +18,11 @@
   </para>
  </refsect1>
 
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>

From 83c72c0debf79e49e8d641cb722c0dc3c9788d76 Mon Sep 17 00:00:00 2001
From: Florian Engelhardt <florian.engelhardt@r-nw.de>
Date: Thu, 8 Sep 2022 15:27:51 +0200
Subject: [PATCH 4/6] move "See Also" section to be last

---
 .../info/functions/memory-reset-peak-usage.xml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/reference/info/functions/memory-reset-peak-usage.xml b/reference/info/functions/memory-reset-peak-usage.xml
index 21086f554d46..dea40a5ed3bb 100644
--- a/reference/info/functions/memory-reset-peak-usage.xml
+++ b/reference/info/functions/memory-reset-peak-usage.xml
@@ -30,15 +30,6 @@
   </para>
  </refsect1>
 
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>memory_get_peak_usage</function></member>
-   </simplelist>
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -70,6 +61,15 @@ echo memory_get_peak_usage(); // 399208
   </para>
  </refsect1>
 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>memory_get_peak_usage</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file

From fa5c112ca0034b4e0017f3a465b3acede7a89bd2 Mon Sep 17 00:00:00 2001
From: Florian Engelhardt <florian.engelhardt@r-nw.de>
Date: Thu, 8 Sep 2022 16:18:29 +0200
Subject: [PATCH 5/6] cleanup example section for `memory_reset_peak_usage`

---
 .../functions/memory-reset-peak-usage.xml     | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/reference/info/functions/memory-reset-peak-usage.xml b/reference/info/functions/memory-reset-peak-usage.xml
index dea40a5ed3bb..9832050008fd 100644
--- a/reference/info/functions/memory-reset-peak-usage.xml
+++ b/reference/info/functions/memory-reset-peak-usage.xml
@@ -34,29 +34,33 @@
   &reftitle.examples;
   <para>
    <example>
-   <title><function>memory_reset_peak_usage</function> example</title>
-   <programlisting role="php">
+    <title><function>memory_reset_peak_usage</function> example</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
-// This is only an example, the numbers below will
-// differ depending on your system
 
-echo memory_get_peak_usage(); // 422440
+var_dump(memory_get_peak_usage());
 
 $a = str_repeat("Hello", 424242);
-
-echo memory_get_peak_usage(); // 2508672
+var_dump(memory_get_peak_usage());
 
 unset($a);
-
 memory_reset_peak_usage();
 
 $a = str_repeat("Hello", 2424);
+var_dump(memory_get_peak_usage());
 
-echo memory_get_peak_usage(); // 399208
 ?>
 ]]>
     </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+int(422440)
+int(2508672)
+int(399208)
+]]>
+    </screen>
    </example>
   </para>
  </refsect1>

From 577a0c1c6e4d25d698876c8ad79580a3369d4e2d Mon Sep 17 00:00:00 2001
From: George Peter Banyard <girgias@php.net>
Date: Mon, 26 Sep 2022 10:47:12 +0100
Subject: [PATCH 6/6] Nit

---
 reference/info/functions/memory-reset-peak-usage.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/info/functions/memory-reset-peak-usage.xml b/reference/info/functions/memory-reset-peak-usage.xml
index 9832050008fd..350b705037c7 100644
--- a/reference/info/functions/memory-reset-peak-usage.xml
+++ b/reference/info/functions/memory-reset-peak-usage.xml
@@ -75,7 +75,6 @@ int(399208)
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml