From 80c280119b5abcf8a9be76a34172d3279ee49f17 Mon Sep 17 00:00:00 2001
From: Gina Peter Banyard <girgias@php.net>
Date: Sun, 17 Nov 2024 04:44:05 +0000
Subject: [PATCH 1/3] PHP 8.4: Document RoundingMode

---
 reference/math/roundingmode.xml | 109 ++++++++++++++++++++++++++++++++
 reference/math/versions.xml     |   3 +
 2 files changed, 112 insertions(+)
 create mode 100644 reference/math/roundingmode.xml

diff --git a/reference/math/roundingmode.xml b/reference/math/roundingmode.xml
new file mode 100644
index 000000000000..ec20fbc14c2d
--- /dev/null
+++ b/reference/math/roundingmode.xml
@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="utf-8"?>
+<reference xmlns="http://docbook.org/ns/docbook" xml:id="enum.roundingmode" role="enum">
+ <title>The RoundingMode Enum</title>
+ <titleabbrev>RoundingMode</titleabbrev>
+
+ <partintro>
+  <section xml:id="enum.roundingmode.intro">
+   &reftitle.intro;
+   <simpara>
+    The <enumname>RoundingMode</enumname> is used to specify how rounding
+    should be performed for <function>round</function>,
+    <function>bcround</function>, and <methodname>BCMath::round</methodname>.
+   </simpara>
+  </section>
+
+  <section xml:id="enum.roundingmode.synopsis">
+   &reftitle.enumsynopsis;
+
+   <enumsynopsis>
+    <enumname>RoundingMode</enumname>
+
+    <enumitem>
+     <enumidentifier>HalfAwayFromZero</enumidentifier>
+     <enumitemdescription>
+      Round to the nearest integer.
+      If the decimal part is <literal>5</literal>,
+      round to the integer with the larger absolute value.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>HalfTowardsZero</enumidentifier>
+     <enumitemdescription>
+      Round to the nearest integer.
+      If the decimal part is <literal>5</literal>,
+      round to the integer with the smaller absolute value.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>HalfEven</enumidentifier>
+     <enumitemdescription>
+      Round to the nearest integer.
+      If the decimal part is <literal>5</literal>,
+      round to the even integer.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>HalfOdd</enumidentifier>
+     <enumitemdescription>
+      Round to the nearest integer.
+      If the decimal part is <literal>5</literal>,
+      round to the odd integer.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>TowardsZero</enumidentifier>
+     <enumitemdescription>
+      Round to the nearest integer with a smaller or equal absolute value.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>AwayFromZero</enumidentifier>
+     <enumitemdescription>
+      Round to the nearest integer with a greater or equal absolute value.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>NegativeInfinity</enumidentifier>
+     <enumitemdescription>
+      Round to the largest integer that is smaller or equal.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>PositiveInfinity</enumidentifier>
+     <enumitemdescription>
+      Round to the smallest integer that is greater or equal.
+     </enumitemdescription>
+    </enumitem>
+
+   </enumsynopsis>
+  </section>
+ </partintro>
+</reference>
+<!-- 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/math/versions.xml b/reference/math/versions.xml
index f3688e13677d..f76a9e03e16e 100644
--- a/reference/math/versions.xml
+++ b/reference/math/versions.xml
@@ -48,6 +48,9 @@
  <function name="tan" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="tanh" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="intdiv" from="PHP 7, PHP 8"/>
+
+ <!-- RoundingMode -->
+ <function name="roundingmode" from="PHP 8 &gt;= 8.4.0"/>
 </versions>
 <!-- Keep this comment at the end of the file
 Local variables:

From 244c3b8cd8d784194a628b43adbe2cf54321af8a Mon Sep 17 00:00:00 2001
From: Gina Peter Banyard <girgias@php.net>
Date: Sun, 17 Nov 2024 17:45:58 +0000
Subject: [PATCH 2/3] Update reference/math/roundingmode.xml
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com>
---
 reference/math/roundingmode.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/math/roundingmode.xml b/reference/math/roundingmode.xml
index ec20fbc14c2d..d0db7407f1c4 100644
--- a/reference/math/roundingmode.xml
+++ b/reference/math/roundingmode.xml
@@ -7,7 +7,7 @@
   <section xml:id="enum.roundingmode.intro">
    &reftitle.intro;
    <simpara>
-    The <enumname>RoundingMode</enumname> is used to specify how rounding
+    The <enumname>RoundingMode</enumname> enum is used to specify how rounding
     should be performed for <function>round</function>,
     <function>bcround</function>, and <methodname>BCMath::round</methodname>.
    </simpara>

From e1351f97dcd19793caf83538080071c2c944ece4 Mon Sep 17 00:00:00 2001
From: Gina Peter Banyard <girgias@php.net>
Date: Wed, 20 Nov 2024 16:41:37 +0000
Subject: [PATCH 3/3] Include in manual

---
 reference/math/book.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/math/book.xml b/reference/math/book.xml
index d6488d5a5c9b..7f1ce4ce0ce5 100644
--- a/reference/math/book.xml
+++ b/reference/math/book.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
 <book xml:id="book.math" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="core" ?>
  <title>Mathematical Functions</title>
@@ -37,10 +36,10 @@
  <!-- }}} -->
 
  &reference.math.constants;
+ &reference.math.roundingmode;
  &reference.math.reference;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml