Synchronize manual with stubs for PHP 8.4 - part 6 (#4209)

Co-authored-by: Gina Peter Banyard <[email protected]>

Author: kocsismate

reference/readline/functions/readline-add-history.xml

@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>readline_add_history</methodname>
+   <type>true</type><methodname>readline_add_history</methodname>
    <methodparam><type>string</type><parameter>prompt</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 </refentry>

reference/readline/functions/readline-callback-handler-install.xml

@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>readline_callback_handler_install</methodname>
+   <type>true</type><methodname>readline_callback_handler_install</methodname>
    <methodparam><type>string</type><parameter>prompt</parameter></methodparam>
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
   </methodsynopsis>
@@ -55,7 +55,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
@@ -117,7 +117,6 @@ echo "Prompting disabled. All done.\n";
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

reference/readline/functions/readline-clear-history.xml

@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>readline_clear_history</methodname>
+   <type>true</type><methodname>readline_clear_history</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -25,11 +25,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

reference/sqlite3/sqlite3result/finalize.xml

@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="SQLite3Result">
-   <modifier>public</modifier> <type>bool</type><methodname>SQLite3Result::finalize</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>SQLite3Result::finalize</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -25,10 +25,39 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns &true;.
+   &return.true.always;
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   An <exceptionname>Error</exceptionname> is thrown if the method is called on an uninitialized object.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.1.0</entry>
+      <entry>
+       This method now throws an <exceptionname>Error</exceptionname> exception if the
+       object is not correct initialized. Previously, it returned &false;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:

reference/sqlite3/sqlite3stmt/close.xml

@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="SQLite3Stmt">
-   <modifier>public</modifier> <type>bool</type><methodname>SQLite3Stmt::close</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>SQLite3Stmt::close</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -32,10 +32,40 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns &true;
+   &return.true.always;
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   An <exceptionname>Error</exceptionname> is thrown if the method is called on an uninitialized object.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.1.0</entry>
+      <entry>
+       This method now throws an <exceptionname>Error</exceptionname> exception if the
+       object is not correct initialized. Previously, it returned
+       &false;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables: