From 09b921a9005036c271b51a3d360a8dd0bd637fa2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Tue, 2 May 2023 20:57:18 +0200
Subject: [PATCH 1/3] Narrow bool return types to true when possible

---
 reference/array/functions/natcasesort.xml             |  4 +---
 reference/array/functions/natsort.xml                 |  4 +---
 reference/array/functions/shuffle.xml                 |  3 +--
 reference/dom/domcharacterdata/appenddata.xml         |  2 +-
 .../errorfunc/functions/restore-error-handler.xml     |  3 +--
 .../errorfunc/functions/restore-exception-handler.xml |  3 +--
 reference/info/functions/phpcredits.xml               |  2 +-
 reference/info/functions/phpinfo.xml                  | 11 ++++-------
 reference/mysqli/mysqli/close.xml                     |  4 ++--
 reference/mysqli/mysqli/debug.xml                     |  4 ++--
 reference/mysqli/mysqli/ssl-set.xml                   |  4 ++--
 reference/mysqli/mysqli_stmt/close.xml                |  4 ++--
 reference/network/functions/closelog.xml              |  3 +--
 reference/network/functions/openlog.xml               |  2 +-
 reference/network/functions/syslog.xml                |  3 +--
 .../functions/sodium-crypto-generichash-update.xml    |  2 +-
 .../xml/functions/xml-set-character-data-handler.xml  |  2 +-
 reference/xml/functions/xml-set-default-handler.xml   |  2 +-
 reference/xml/functions/xml-set-element-handler.xml   | 11 ++++-------
 .../functions/xml-set-end-namespace-decl-handler.xml  |  2 +-
 .../functions/xml-set-external-entity-ref-handler.xml |  2 +-
 .../xml/functions/xml-set-notation-decl-handler.xml   |  2 +-
 reference/xml/functions/xml-set-object.xml            |  2 +-
 .../xml-set-processing-instruction-handler.xml        |  2 +-
 .../xml-set-start-namespace-decl-handler.xml          |  2 +-
 .../xml-set-unparsed-entity-decl-handler.xml          |  2 +-
 26 files changed, 36 insertions(+), 51 deletions(-)

diff --git a/reference/array/functions/natcasesort.xml b/reference/array/functions/natcasesort.xml
index 157678a50046..5bb2c635b362 100644
--- a/reference/array/functions/natcasesort.xml
+++ b/reference/array/functions/natcasesort.xml
@@ -112,8 +112,7 @@ Array
 ]]>
     </screen>
     <para>
-     For more information see: Martin Pool's <link
-     xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>
+     For more information see: Martin Pool's <link xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>
      page.
     </para>
    </example>
@@ -131,7 +130,6 @@ Array
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/array/functions/natsort.xml b/reference/array/functions/natsort.xml
index 751db526fa83..e88a1c13e8c6 100644
--- a/reference/array/functions/natsort.xml
+++ b/reference/array/functions/natsort.xml
@@ -106,8 +106,7 @@ Array
 ]]>
     </screen>
     <para>
-     For more information see: Martin Pool's <link
-     xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>
+     For more information see: Martin Pool's <link xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>
      page.
     </para>
    </example>
@@ -191,7 +190,6 @@ Array
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/array/functions/shuffle.xml b/reference/array/functions/shuffle.xml
index c438aab4889c..fa454e5d54f9 100644
--- a/reference/array/functions/shuffle.xml
+++ b/reference/array/functions/shuffle.xml
@@ -8,7 +8,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>shuffle</methodname>
+   <type>true</type><methodname>shuffle</methodname>
    <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -97,7 +97,6 @@ foreach ($numbers as $number) {
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/dom/domcharacterdata/appenddata.xml b/reference/dom/domcharacterdata/appenddata.xml
index 10e70f77a1c4..b0bc17011602 100644
--- a/reference/dom/domcharacterdata/appenddata.xml
+++ b/reference/dom/domcharacterdata/appenddata.xml
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DOMCharacterData">
-   <modifier>public</modifier> <type>bool</type><methodname>DOMCharacterData::appendData</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>DOMCharacterData::appendData</methodname>
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
   </methodsynopsis>
   <para>
diff --git a/reference/errorfunc/functions/restore-error-handler.xml b/reference/errorfunc/functions/restore-error-handler.xml
index 5563d1b43457..0c4bfcca9b06 100644
--- a/reference/errorfunc/functions/restore-error-handler.xml
+++ b/reference/errorfunc/functions/restore-error-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>restore_error_handler</methodname>
+   <type>true</type><methodname>restore_error_handler</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -77,7 +77,6 @@ Invalid serialized value.
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/errorfunc/functions/restore-exception-handler.xml b/reference/errorfunc/functions/restore-exception-handler.xml
index 4ccb1c3a4d49..490e51d2d51e 100644
--- a/reference/errorfunc/functions/restore-exception-handler.xml
+++ b/reference/errorfunc/functions/restore-exception-handler.xml
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>restore_exception_handler</methodname>
+   <type>true</type><methodname>restore_exception_handler</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -83,7 +83,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/info/functions/phpcredits.xml b/reference/info/functions/phpcredits.xml
index 1a692e8ed608..0581b9b3f8a7 100644
--- a/reference/info/functions/phpcredits.xml
+++ b/reference/info/functions/phpcredits.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>phpcredits</methodname>
+   <type>true</type><methodname>phpcredits</methodname>
    <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>CREDITS_ALL</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
diff --git a/reference/info/functions/phpinfo.xml b/reference/info/functions/phpinfo.xml
index c33f719fcd1a..31977d885434 100644
--- a/reference/info/functions/phpinfo.xml
+++ b/reference/info/functions/phpinfo.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>phpinfo</methodname>
+   <type>true</type><methodname>phpinfo</methodname>
    <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>INFO_ALL</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
@@ -21,8 +21,7 @@
   </para>
   <para>
    Because every system is setup differently, <function>phpinfo</function> is
-   commonly used to check <link
-   linkend="configuration">configuration settings</link> and for available
+   commonly used to check <link linkend="configuration">configuration settings</link> and for available
    <link linkend="language.variables.predefined">predefined variables</link>
    on a given system.
   </para>
@@ -44,8 +43,7 @@
        following <emphasis>constants</emphasis> bitwise values summed
        together in the optional <parameter>flags</parameter> parameter.
        One can also combine the respective constants or bitwise values
-       together with the <link
-       linkend="language.operators.bitwise">bitwise or operator</link>.
+       together with the <link linkend="language.operators.bitwise">bitwise or operator</link>.
       </para>
       <para>
        <table>
@@ -111,8 +109,7 @@
            <entry>INFO_LICENSE</entry>
            <entry>64</entry>
            <entry>
-            PHP License information.  See also the <link
-            xlink:href="&url.php.license;">license FAQ</link>.
+            PHP License information.  See also the <link xlink:href="&url.php.license;">license FAQ</link>.
            </entry>
           </row>
           <row>
diff --git a/reference/mysqli/mysqli/close.xml b/reference/mysqli/mysqli/close.xml
index 42229766f674..728807934b42 100644
--- a/reference/mysqli/mysqli/close.xml
+++ b/reference/mysqli/mysqli/close.xml
@@ -11,12 +11,12 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier>public</modifier> <type>bool</type><methodname>mysqli::close</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>mysqli::close</methodname>
    <void/>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <type>bool</type><methodname>mysqli_close</methodname>
+   <type>true</type><methodname>mysqli_close</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
   </methodsynopsis>
   <para>
diff --git a/reference/mysqli/mysqli/debug.xml b/reference/mysqli/mysqli/debug.xml
index 0fd249204510..632ed80b0b3b 100644
--- a/reference/mysqli/mysqli/debug.xml
+++ b/reference/mysqli/mysqli/debug.xml
@@ -11,12 +11,12 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier>public</modifier> <type>bool</type><methodname>mysqli::debug</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>mysqli::debug</methodname>
    <methodparam><type>string</type><parameter>options</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <type>bool</type><methodname>mysqli_debug</methodname>
+   <type>true</type><methodname>mysqli_debug</methodname>
    <methodparam><type>string</type><parameter>options</parameter></methodparam>
   </methodsynopsis>
   <para>
diff --git a/reference/mysqli/mysqli/ssl-set.xml b/reference/mysqli/mysqli/ssl-set.xml
index 59cc795cda54..fe527c2a1ac7 100644
--- a/reference/mysqli/mysqli/ssl-set.xml
+++ b/reference/mysqli/mysqli/ssl-set.xml
@@ -11,7 +11,7 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier>public</modifier> <type>bool</type><methodname>mysqli::ssl_set</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>mysqli::ssl_set</methodname>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>key</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>certificate</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>ca_certificate</parameter></methodparam>
@@ -20,7 +20,7 @@
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <type>bool</type><methodname>mysqli_ssl_set</methodname>
+   <type>true</type><methodname>mysqli_ssl_set</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>key</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>certificate</parameter></methodparam>
diff --git a/reference/mysqli/mysqli_stmt/close.xml b/reference/mysqli/mysqli_stmt/close.xml
index 5c1e38f67800..75ac539638f9 100644
--- a/reference/mysqli/mysqli_stmt/close.xml
+++ b/reference/mysqli/mysqli_stmt/close.xml
@@ -11,12 +11,12 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli_stmt">
-   <modifier>public</modifier> <type>bool</type><methodname>mysqli_stmt::close</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>mysqli_stmt::close</methodname>
    <void/>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <type>bool</type><methodname>mysqli_stmt_close</methodname>
+   <type>true</type><methodname>mysqli_stmt_close</methodname>
    <methodparam><type>mysqli_stmt</type><parameter>statement</parameter></methodparam>
   </methodsynopsis>
   <para>
diff --git a/reference/network/functions/closelog.xml b/reference/network/functions/closelog.xml
index 1ebb0d977ebd..c686646a6a5e 100644
--- a/reference/network/functions/closelog.xml
+++ b/reference/network/functions/closelog.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>closelog</methodname>
+   <type>true</type><methodname>closelog</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -41,7 +41,6 @@
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/network/functions/openlog.xml b/reference/network/functions/openlog.xml
index b8473ece182b..eabf3308b275 100644
--- a/reference/network/functions/openlog.xml
+++ b/reference/network/functions/openlog.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>openlog</methodname>
+   <type>true</type><methodname>openlog</methodname>
    <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>
    <methodparam><type>int</type><parameter>facility</parameter></methodparam>
diff --git a/reference/network/functions/syslog.xml b/reference/network/functions/syslog.xml
index df992cc6808e..0ad0e86c0a56 100644
--- a/reference/network/functions/syslog.xml
+++ b/reference/network/functions/syslog.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>syslog</methodname>
+   <type>true</type><methodname>syslog</methodname>
    <methodparam><type>int</type><parameter>priority</parameter></methodparam>
    <methodparam><type>string</type><parameter>message</parameter></methodparam>
   </methodsynopsis>
@@ -164,7 +164,6 @@ closelog();
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/sodium/functions/sodium-crypto-generichash-update.xml b/reference/sodium/functions/sodium-crypto-generichash-update.xml
index 0c71d61f04c8..dd9af516b767 100644
--- a/reference/sodium/functions/sodium-crypto-generichash-update.xml
+++ b/reference/sodium/functions/sodium-crypto-generichash-update.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>sodium_crypto_generichash_update</methodname>
+   <type>true</type><methodname>sodium_crypto_generichash_update</methodname>
    <methodparam><type>string</type><parameter role="reference">state</parameter></methodparam>
    <methodparam><type>string</type><parameter>message</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-character-data-handler.xml b/reference/xml/functions/xml-set-character-data-handler.xml
index 7fc44e8dd56d..604303c29894 100644
--- a/reference/xml/functions/xml-set-character-data-handler.xml
+++ b/reference/xml/functions/xml-set-character-data-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_character_data_handler</methodname>
+   <type>true</type><methodname>xml_set_character_data_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-default-handler.xml b/reference/xml/functions/xml-set-default-handler.xml
index 04acbae0f24e..83e5163f4ae7 100644
--- a/reference/xml/functions/xml-set-default-handler.xml
+++ b/reference/xml/functions/xml-set-default-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_default_handler</methodname>
+   <type>true</type><methodname>xml_set_default_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-element-handler.xml b/reference/xml/functions/xml-set-element-handler.xml
index d917a6f7e254..be2c9d896498 100644
--- a/reference/xml/functions/xml-set-element-handler.xml
+++ b/reference/xml/functions/xml-set-element-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_element_handler</methodname>
+   <type>true</type><methodname>xml_set_element_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>start_handler</parameter></methodparam>
    <methodparam><type>callable</type><parameter>end_handler</parameter></methodparam>
@@ -62,8 +62,7 @@
          <listitem>
           <simpara>
            The second parameter, <parameter>name</parameter>, contains the name
-           of the element for which this handler is called.If <link
-           linkend="xml.case-folding">case-folding</link> is in effect for this
+           of the element for which this handler is called.If <link linkend="xml.case-folding">case-folding</link> is in effect for this
            parser, the element name will be in uppercase letters.
           </simpara>
          </listitem>
@@ -75,8 +74,7 @@
            The third parameter, <parameter>attribs</parameter>, contains an
            associative array with the element's attributes (if any).The keys
            of this array are the attribute names, the values are the attribute
-           values.Attribute names are <link
-           linkend="xml.case-folding">case-folded</link> on the same criteria as
+           values.Attribute names are <link linkend="xml.case-folding">case-folded</link> on the same criteria as
            element names.Attribute values are <emphasis>not</emphasis>
            case-folded.
           </simpara>
@@ -119,8 +117,7 @@
          <listitem>
           <simpara>
            The second parameter, <parameter>name</parameter>, contains the name
-           of the element for which this handler is called.If <link
-           linkend="xml.case-folding">case-folding</link> is in effect for this
+           of the element for which this handler is called.If <link linkend="xml.case-folding">case-folding</link> is in effect for this
            parser, the element name will be in uppercase letters.
           </simpara>
          </listitem>
diff --git a/reference/xml/functions/xml-set-end-namespace-decl-handler.xml b/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
index c4a97e2d80b5..0117d12a8fcd 100644
--- a/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
+++ b/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_end_namespace_decl_handler</methodname>
+   <type>true</type><methodname>xml_set_end_namespace_decl_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-external-entity-ref-handler.xml b/reference/xml/functions/xml-set-external-entity-ref-handler.xml
index f8d853c6f55d..4585427ede70 100644
--- a/reference/xml/functions/xml-set-external-entity-ref-handler.xml
+++ b/reference/xml/functions/xml-set-external-entity-ref-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_external_entity_ref_handler</methodname>
+   <type>true</type><methodname>xml_set_external_entity_ref_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-notation-decl-handler.xml b/reference/xml/functions/xml-set-notation-decl-handler.xml
index e64f8ff02780..afccd228dafd 100644
--- a/reference/xml/functions/xml-set-notation-decl-handler.xml
+++ b/reference/xml/functions/xml-set-notation-decl-handler.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_notation_decl_handler</methodname>
+   <type>true</type><methodname>xml_set_notation_decl_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-object.xml b/reference/xml/functions/xml-set-object.xml
index 3e8f411c2927..ab9ff3076ff7 100644
--- a/reference/xml/functions/xml-set-object.xml
+++ b/reference/xml/functions/xml-set-object.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_object</methodname>
+   <type>true</type><methodname>xml_set_object</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-processing-instruction-handler.xml b/reference/xml/functions/xml-set-processing-instruction-handler.xml
index c331e2820639..5aeb9d805e68 100644
--- a/reference/xml/functions/xml-set-processing-instruction-handler.xml
+++ b/reference/xml/functions/xml-set-processing-instruction-handler.xml
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_processing_instruction_handler</methodname>
+   <type>true</type><methodname>xml_set_processing_instruction_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-start-namespace-decl-handler.xml b/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
index ee6691734ccf..7781c32d7873 100644
--- a/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
+++ b/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_start_namespace_decl_handler</methodname>
+   <type>true</type><methodname>xml_set_start_namespace_decl_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml b/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
index 6d8c838cd54a..1f61d941d1cb 100644
--- a/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
+++ b/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>xml_set_unparsed_entity_decl_handler</methodname>
+   <type>true</type><methodname>xml_set_unparsed_entity_decl_handler</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
    <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>

From 9b21393ab372ec740da75b763b991113f795ba66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Sun, 7 May 2023 11:15:00 +0200
Subject: [PATCH 2/3] Fix return type sections + add some change logs

---
 reference/array/functions/shuffle.xml         |  2 +-
 reference/dom/domcharacterdata/appenddata.xml |  2 +-
 .../functions/restore-error-handler.xml       |  2 +-
 .../functions/restore-exception-handler.xml   |  2 +-
 reference/info/functions/phpcredits.xml       |  2 +-
 reference/info/functions/phpinfo.xml          |  2 +-
 reference/mysqli/mysqli/close.xml             | 26 ++++++++++++++++++-
 reference/mysqli/mysqli/debug.xml             | 26 ++++++++++++++++++-
 reference/mysqli/mysqli/ssl-set.xml           |  2 +-
 reference/mysqli/mysqli_stmt/close.xml        | 26 ++++++++++++++++++-
 reference/network/functions/closelog.xml      |  2 +-
 reference/network/functions/openlog.xml       |  2 +-
 reference/network/functions/syslog.xml        |  2 +-
 .../sodium-crypto-generichash-update.xml      |  2 +-
 reference/spl/splheap/insert.xml              |  4 +--
 .../xml-set-character-data-handler.xml        |  2 +-
 .../xml/functions/xml-set-default-handler.xml |  2 +-
 .../xml/functions/xml-set-element-handler.xml |  2 +-
 .../xml-set-end-namespace-decl-handler.xml    |  2 +-
 .../xml-set-external-entity-ref-handler.xml   |  2 +-
 .../xml-set-notation-decl-handler.xml         |  2 +-
 reference/xml/functions/xml-set-object.xml    |  2 +-
 ...xml-set-processing-instruction-handler.xml |  2 +-
 .../xml-set-start-namespace-decl-handler.xml  |  2 +-
 .../xml-set-unparsed-entity-decl-handler.xml  |  2 +-
 25 files changed, 98 insertions(+), 26 deletions(-)

diff --git a/reference/array/functions/shuffle.xml b/reference/array/functions/shuffle.xml
index fa454e5d54f9..5e24f8943ea5 100644
--- a/reference/array/functions/shuffle.xml
+++ b/reference/array/functions/shuffle.xml
@@ -34,7 +34,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
  <refsect1 role="changelog">
diff --git a/reference/dom/domcharacterdata/appenddata.xml b/reference/dom/domcharacterdata/appenddata.xml
index b0bc17011602..159f114e398c 100644
--- a/reference/dom/domcharacterdata/appenddata.xml
+++ b/reference/dom/domcharacterdata/appenddata.xml
@@ -35,7 +35,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.void;
+   &return.true.always;
   </para>
  </refsect1>
  <refsect1 role="seealso">
diff --git a/reference/errorfunc/functions/restore-error-handler.xml b/reference/errorfunc/functions/restore-error-handler.xml
index 0c4bfcca9b06..45f3333c5595 100644
--- a/reference/errorfunc/functions/restore-error-handler.xml
+++ b/reference/errorfunc/functions/restore-error-handler.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   This function always returns &true;.
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/errorfunc/functions/restore-exception-handler.xml b/reference/errorfunc/functions/restore-exception-handler.xml
index 490e51d2d51e..474215e7d00f 100644
--- a/reference/errorfunc/functions/restore-exception-handler.xml
+++ b/reference/errorfunc/functions/restore-exception-handler.xml
@@ -30,7 +30,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   This function always returns &true;.
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/info/functions/phpcredits.xml b/reference/info/functions/phpcredits.xml
index 0581b9b3f8a7..2960f987e98b 100644
--- a/reference/info/functions/phpcredits.xml
+++ b/reference/info/functions/phpcredits.xml
@@ -99,7 +99,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/info/functions/phpinfo.xml b/reference/info/functions/phpinfo.xml
index 31977d885434..db71081c92d3 100644
--- a/reference/info/functions/phpinfo.xml
+++ b/reference/info/functions/phpinfo.xml
@@ -132,7 +132,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/mysqli/mysqli/close.xml b/reference/mysqli/mysqli/close.xml
index 728807934b42..6972d3540ba2 100644
--- a/reference/mysqli/mysqli/close.xml
+++ b/reference/mysqli/mysqli/close.xml
@@ -44,7 +44,31 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        This function now always returns &true;. Previously it returned &false; on failure.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
 
diff --git a/reference/mysqli/mysqli/debug.xml b/reference/mysqli/mysqli/debug.xml
index 632ed80b0b3b..50bbba0f692a 100644
--- a/reference/mysqli/mysqli/debug.xml
+++ b/reference/mysqli/mysqli/debug.xml
@@ -108,7 +108,31 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns &true;.
+   &return.true.always;
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        This function now always returns &true;. Previously it returned &false; on failure.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
 
diff --git a/reference/mysqli/mysqli/ssl-set.xml b/reference/mysqli/mysqli/ssl-set.xml
index fe527c2a1ac7..44d383db68e9 100644
--- a/reference/mysqli/mysqli/ssl-set.xml
+++ b/reference/mysqli/mysqli/ssl-set.xml
@@ -89,7 +89,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   This function always returns &true; value. If SSL setup is
+   &return.true.always; If SSL setup is
    incorrect <function>mysqli_real_connect</function> will return an error
    when you attempt to connect.
   </para>
diff --git a/reference/mysqli/mysqli_stmt/close.xml b/reference/mysqli/mysqli_stmt/close.xml
index 75ac539638f9..2a188e12f31a 100644
--- a/reference/mysqli/mysqli_stmt/close.xml
+++ b/reference/mysqli/mysqli_stmt/close.xml
@@ -39,7 +39,31 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        This function now always returns &true;. Previously it returned &false; on failure.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
 
diff --git a/reference/network/functions/closelog.xml b/reference/network/functions/closelog.xml
index c686646a6a5e..3b66a9d996be 100644
--- a/reference/network/functions/closelog.xml
+++ b/reference/network/functions/closelog.xml
@@ -26,7 +26,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/network/functions/openlog.xml b/reference/network/functions/openlog.xml
index eabf3308b275..eb7808b60058 100644
--- a/reference/network/functions/openlog.xml
+++ b/reference/network/functions/openlog.xml
@@ -181,7 +181,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/network/functions/syslog.xml b/reference/network/functions/syslog.xml
index 0ad0e86c0a56..115abf8a1ce9 100644
--- a/reference/network/functions/syslog.xml
+++ b/reference/network/functions/syslog.xml
@@ -100,7 +100,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/sodium/functions/sodium-crypto-generichash-update.xml b/reference/sodium/functions/sodium-crypto-generichash-update.xml
index dd9af516b767..0bda655ac274 100644
--- a/reference/sodium/functions/sodium-crypto-generichash-update.xml
+++ b/reference/sodium/functions/sodium-crypto-generichash-update.xml
@@ -44,7 +44,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/spl/splheap/insert.xml b/reference/spl/splheap/insert.xml
index 94e9478b5723..1ea107608e0c 100644
--- a/reference/spl/splheap/insert.xml
+++ b/reference/spl/splheap/insert.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="SplHeap">
-   <modifier>public</modifier> <type>bool</type><methodname>SplHeap::insert</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>SplHeap::insert</methodname>
    <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
   </methodsynopsis>
 
@@ -37,7 +37,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Always returns &true;.
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-character-data-handler.xml b/reference/xml/functions/xml-set-character-data-handler.xml
index 604303c29894..fc55487e56b7 100644
--- a/reference/xml/functions/xml-set-character-data-handler.xml
+++ b/reference/xml/functions/xml-set-character-data-handler.xml
@@ -87,7 +87,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-default-handler.xml b/reference/xml/functions/xml-set-default-handler.xml
index 83e5163f4ae7..b5b76e380087 100644
--- a/reference/xml/functions/xml-set-default-handler.xml
+++ b/reference/xml/functions/xml-set-default-handler.xml
@@ -88,7 +88,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-element-handler.xml b/reference/xml/functions/xml-set-element-handler.xml
index be2c9d896498..8c9077ecc85b 100644
--- a/reference/xml/functions/xml-set-element-handler.xml
+++ b/reference/xml/functions/xml-set-element-handler.xml
@@ -137,7 +137,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-end-namespace-decl-handler.xml b/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
index 0117d12a8fcd..1e4b1c1b50cd 100644
--- a/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
+++ b/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
@@ -93,7 +93,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-external-entity-ref-handler.xml b/reference/xml/functions/xml-set-external-entity-ref-handler.xml
index 4585427ede70..4c2284f17b38 100644
--- a/reference/xml/functions/xml-set-external-entity-ref-handler.xml
+++ b/reference/xml/functions/xml-set-external-entity-ref-handler.xml
@@ -122,7 +122,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-notation-decl-handler.xml b/reference/xml/functions/xml-set-notation-decl-handler.xml
index afccd228dafd..03cdf84004ba 100644
--- a/reference/xml/functions/xml-set-notation-decl-handler.xml
+++ b/reference/xml/functions/xml-set-notation-decl-handler.xml
@@ -129,7 +129,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-object.xml b/reference/xml/functions/xml-set-object.xml
index ab9ff3076ff7..ae7f493ea072 100644
--- a/reference/xml/functions/xml-set-object.xml
+++ b/reference/xml/functions/xml-set-object.xml
@@ -48,7 +48,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-processing-instruction-handler.xml b/reference/xml/functions/xml-set-processing-instruction-handler.xml
index 5aeb9d805e68..37272b253807 100644
--- a/reference/xml/functions/xml-set-processing-instruction-handler.xml
+++ b/reference/xml/functions/xml-set-processing-instruction-handler.xml
@@ -107,7 +107,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-start-namespace-decl-handler.xml b/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
index 7781c32d7873..26e5e002553a 100644
--- a/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
+++ b/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
@@ -97,7 +97,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
diff --git a/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml b/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
index 1f61d941d1cb..73f43f30e030 100644
--- a/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
+++ b/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
@@ -139,7 +139,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

From 658149099ae984a7008ebccd6ad0e144f4d27275 Mon Sep 17 00:00:00 2001
From: kocsismate <kocsismate@woohoolabs.com>
Date: Sun, 7 May 2023 22:31:28 +0200
Subject: [PATCH 3/3] Revert changes for openlog()

---
 reference/network/functions/openlog.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/network/functions/openlog.xml b/reference/network/functions/openlog.xml
index eb7808b60058..b8473ece182b 100644
--- a/reference/network/functions/openlog.xml
+++ b/reference/network/functions/openlog.xml
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>true</type><methodname>openlog</methodname>
+   <type>bool</type><methodname>openlog</methodname>
    <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>
    <methodparam><type>int</type><parameter>facility</parameter></methodparam>
@@ -181,7 +181,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.true.always;
+   &return.success;
   </para>
  </refsect1>