From 7d3e1ee122fbfe562d8094345daadecb03583995 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 16 Jun 2026 13:39:24 +0200
Subject: [PATCH 1/4] intl: document the procedural style of
 IntlGregorianCalendar methods

---
 .../getgregorianchange.xml                    | 26 +++++++++++----
 .../intl/intlgregoriancalendar/isleapyear.xml | 27 ++++++++++-----
 .../setgregorianchange.xml                    | 33 +++++++++++++------
 3 files changed, 60 insertions(+), 26 deletions(-)

diff --git a/reference/intl/intlgregoriancalendar/getgregorianchange.xml b/reference/intl/intlgregoriancalendar/getgregorianchange.xml
index 2d15d52a4ec7..a637ccf31cb9 100644
--- a/reference/intl/intlgregoriancalendar/getgregorianchange.xml
+++ b/reference/intl/intlgregoriancalendar/getgregorianchange.xml
@@ -8,21 +8,33 @@
 
  <refsect1 role="description">
   &reftitle.description;
+  <simpara>&style.oop;</simpara>
   <methodsynopsis role="IntlGregorianCalendar">
    <modifier>public</modifier> <type>float</type><methodname>IntlGregorianCalendar::getGregorianChange</methodname>
    <void/>
   </methodsynopsis>
-  <para>
-
-  </para>
-
-  &warn.undocumented.func;
-
+  <simpara>&style.procedural;</simpara>
+  <methodsynopsis>
+   <type>float</type><methodname>intlgregcal_get_gregorian_change</methodname>
+   <methodparam><type>IntlGregorianCalendar</type><parameter>calendar</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Gets the Gregorian Calendar change date. This is the point at which the
+   calendar switches from Julian dates to Gregorian dates, expressed as a UNIX
+   timestamp in milliseconds. It defaults to midnight (UTC) on October 15, 1582.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  &no.function.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>calendar</parameter></term>
+    <listitem>
+     <simpara>An <classname>IntlGregorianCalendar</classname> instance.</simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
diff --git a/reference/intl/intlgregoriancalendar/isleapyear.xml b/reference/intl/intlgregoriancalendar/isleapyear.xml
index b963637484c0..ae412266d281 100644
--- a/reference/intl/intlgregoriancalendar/isleapyear.xml
+++ b/reference/intl/intlgregoriancalendar/isleapyear.xml
@@ -8,27 +8,36 @@
 
  <refsect1 role="description">
   &reftitle.description;
+  <simpara>&style.oop;</simpara>
   <methodsynopsis role="IntlGregorianCalendar">
    <modifier>public</modifier> <type>bool</type><methodname>IntlGregorianCalendar::isLeapYear</methodname>
    <methodparam><type>int</type><parameter>year</parameter></methodparam>
   </methodsynopsis>
-  <para>
-
-  </para>
-
-  &warn.undocumented.func;
-
+  <simpara>&style.procedural;</simpara>
+  <methodsynopsis>
+   <type>bool</type><methodname>intlgregcal_is_leap_year</methodname>
+   <methodparam><type>IntlGregorianCalendar</type><parameter>calendar</parameter></methodparam>
+   <methodparam><type>int</type><parameter>year</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Determines whether the given <parameter>year</parameter> is a leap year
+   in the Gregorian calendar.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
   &reftitle.parameters;
   <variablelist>
+   <varlistentry>
+    <term><parameter>calendar</parameter></term>
+    <listitem>
+     <simpara>An <classname>IntlGregorianCalendar</classname> instance.</simpara>
+    </listitem>
+   </varlistentry>
    <varlistentry>
     <term><parameter>year</parameter></term>
     <listitem>
-     <para>
-      
-     </para>
+     <simpara>The year to check.</simpara>
     </listitem>
    </varlistentry>
   </variablelist>
diff --git a/reference/intl/intlgregoriancalendar/setgregorianchange.xml b/reference/intl/intlgregoriancalendar/setgregorianchange.xml
index 26678d6fd1d4..1b72a93dfb8e 100644
--- a/reference/intl/intlgregoriancalendar/setgregorianchange.xml
+++ b/reference/intl/intlgregoriancalendar/setgregorianchange.xml
@@ -3,32 +3,45 @@
 <refentry xml:id="intlgregoriancalendar.setgregorianchange" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>IntlGregorianCalendar::setGregorianChange</refname>
-  <refpurpose>Set the Gregorian Calendar the change date</refpurpose>
+  <refpurpose>Set the Gregorian Calendar change date</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
+  <simpara>&style.oop;</simpara>
   <methodsynopsis role="IntlGregorianCalendar">
    <modifier>public</modifier> <type>bool</type><methodname>IntlGregorianCalendar::setGregorianChange</methodname>
    <methodparam><type>float</type><parameter>timestamp</parameter></methodparam>
   </methodsynopsis>
-  <para>
-
-  </para>
-
-  &warn.undocumented.func;
-
+  <simpara>&style.procedural;</simpara>
+  <methodsynopsis>
+   <type>bool</type><methodname>intlgregcal_set_gregorian_change</methodname>
+   <methodparam><type>IntlGregorianCalendar</type><parameter>calendar</parameter></methodparam>
+   <methodparam><type>float</type><parameter>timestamp</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Sets the Gregorian Calendar change date. This is the point at which the
+   calendar switches from Julian dates to Gregorian dates, expressed as a UNIX
+   timestamp in milliseconds.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
   &reftitle.parameters;
   <variablelist>
+   <varlistentry>
+    <term><parameter>calendar</parameter></term>
+    <listitem>
+     <simpara>An <classname>IntlGregorianCalendar</classname> instance.</simpara>
+    </listitem>
+   </varlistentry>
    <varlistentry>
     <term><parameter>timestamp</parameter></term>
     <listitem>
-     <para>
-      
-     </para>
+     <simpara>
+      The Gregorian Calendar change date, expressed as a UNIX timestamp in
+      milliseconds.
+     </simpara>
     </listitem>
    </varlistentry>
   </variablelist>

From fecfd16d9b9e2609f70e4152bae8dd4ae8d11490 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Sun, 16 Aug 2026 18:17:54 +0200
Subject: [PATCH 2/4] Update
 reference/intl/intlgregoriancalendar/getgregorianchange.xml

Co-authored-by: Jordi Kroon <jordi@jordikroon.nl>
---
 reference/intl/intlgregoriancalendar/getgregorianchange.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/intl/intlgregoriancalendar/getgregorianchange.xml b/reference/intl/intlgregoriancalendar/getgregorianchange.xml
index a637ccf31cb9..8c151b00c6de 100644
--- a/reference/intl/intlgregoriancalendar/getgregorianchange.xml
+++ b/reference/intl/intlgregoriancalendar/getgregorianchange.xml
@@ -20,7 +20,7 @@
   </methodsynopsis>
   <simpara>
    Gets the Gregorian Calendar change date. This is the point at which the
-   calendar switches from Julian dates to Gregorian dates, expressed as a UNIX
+   calendar switches from Julian dates to Gregorian dates, expressed as a Unix
    timestamp in milliseconds. It defaults to midnight (UTC) on October 15, 1582.
   </simpara>
  </refsect1>

From bac6d4d5aa51be03027cc9c12d64a4d902ba413b Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Sun, 16 Aug 2026 18:18:03 +0200
Subject: [PATCH 3/4] Update
 reference/intl/intlgregoriancalendar/setgregorianchange.xml

Co-authored-by: Jordi Kroon <jordi@jordikroon.nl>
---
 reference/intl/intlgregoriancalendar/setgregorianchange.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/intl/intlgregoriancalendar/setgregorianchange.xml b/reference/intl/intlgregoriancalendar/setgregorianchange.xml
index 1b72a93dfb8e..5ff86efd5657 100644
--- a/reference/intl/intlgregoriancalendar/setgregorianchange.xml
+++ b/reference/intl/intlgregoriancalendar/setgregorianchange.xml
@@ -39,7 +39,7 @@
     <term><parameter>timestamp</parameter></term>
     <listitem>
      <simpara>
-      The Gregorian Calendar change date, expressed as a UNIX timestamp in
+      The Gregorian Calendar change date, expressed as a Unix timestamp in
       milliseconds.
      </simpara>
     </listitem>

From b5363b5bbf7c8b9a4a4149a64f553295de8532a3 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Sun, 16 Aug 2026 18:18:18 +0200
Subject: [PATCH 4/4] Update
 reference/intl/intlgregoriancalendar/setgregorianchange.xml

Co-authored-by: Jordi Kroon <jordi@jordikroon.nl>
---
 reference/intl/intlgregoriancalendar/setgregorianchange.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/intl/intlgregoriancalendar/setgregorianchange.xml b/reference/intl/intlgregoriancalendar/setgregorianchange.xml
index 5ff86efd5657..2419380cfd23 100644
--- a/reference/intl/intlgregoriancalendar/setgregorianchange.xml
+++ b/reference/intl/intlgregoriancalendar/setgregorianchange.xml
@@ -21,7 +21,7 @@
   </methodsynopsis>
   <simpara>
    Sets the Gregorian Calendar change date. This is the point at which the
-   calendar switches from Julian dates to Gregorian dates, expressed as a UNIX
+   calendar switches from Julian dates to Gregorian dates, expressed as a Unix
    timestamp in milliseconds.
   </simpara>
  </refsect1>