From b65a894b956f1a2aa99380afc6194944ccb1fa9f Mon Sep 17 00:00:00 2001
From: Anna Filina <afilina@gmail.com>
Date: Mon, 11 Jan 2021 19:49:38 +0100
Subject: [PATCH] Other queries can also produce a result set

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

Closes GH-324.
---
 reference/mysqli/mysqli/query.xml            | 6 +++---
 reference/mysqli/mysqli/reap-async-query.xml | 5 ++++-
 reference/mysqli/mysqli_stmt/get-result.xml  | 9 ++++++---
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/reference/mysqli/mysqli/query.xml b/reference/mysqli/mysqli/query.xml
index d772d70cfe..e1b53fde77 100644
--- a/reference/mysqli/mysqli/query.xml
+++ b/reference/mysqli/mysqli/query.xml
@@ -111,9 +111,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns &false; on failure. For successful <literal>SELECT, SHOW, DESCRIBE</literal> or
-   <literal>EXPLAIN</literal> queries <function>mysqli_query</function> will return
-   a <classname>mysqli_result</classname> object. For other successful queries <function>mysqli_query</function> will
+   Returns &false; on failure. For successful queries which produce a result set, such as <literal>SELECT, SHOW, DESCRIBE</literal> or
+   <literal>EXPLAIN</literal>, <function>mysqli_query</function> will return
+   a <classname>mysqli_result</classname> object. For other successful queries, <function>mysqli_query</function> will
    return &true;.
   </para>
  </refsect1>
diff --git a/reference/mysqli/mysqli/reap-async-query.xml b/reference/mysqli/mysqli/reap-async-query.xml
index e05a6d6707..e6092d2228 100644
--- a/reference/mysqli/mysqli/reap-async-query.xml
+++ b/reference/mysqli/mysqli/reap-async-query.xml
@@ -37,7 +37,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns <classname>mysqli_result</classname> in success, &false; otherwise.
+   Returns &false; on failure. For successful queries which produce a result set, such as <literal>SELECT, SHOW, DESCRIBE</literal> or
+   <literal>EXPLAIN</literal>, <function>mysqli_reap_async_query</function> will return
+   a <classname>mysqli_result</classname> object. For other successful queries, <function>mysqli_reap_async_query</function> will
+   return &true;.
   </para>
  </refsect1>
 
diff --git a/reference/mysqli/mysqli_stmt/get-result.xml b/reference/mysqli/mysqli_stmt/get-result.xml
index 14a3592129..f789fcca1d 100644
--- a/reference/mysqli/mysqli_stmt/get-result.xml
+++ b/reference/mysqli/mysqli_stmt/get-result.xml
@@ -37,9 +37,12 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns a resultset for successful SELECT queries, or &false; for other DML
-   queries or on failure. The <function>mysqli_errno</function> function can be
-   used to distinguish between the two types of failure.
+   Returns &false; on failure. For successful queries which produce a result set, such as <literal>SELECT, SHOW, DESCRIBE</literal> or
+   <literal>EXPLAIN</literal>, <function>mysqli_stmt_get_result</function> will return
+   a <classname>mysqli_result</classname> object. For other successful queries, <function>mysqli_stmt_get_result</function> will
+   return &false;. The <function>mysqli_stmt_errno</function> function can be
+   used to distinguish between the two reasons for &false;; due to a bug, prior to PHP 7.4.13,
+   <function>mysqli_errno</function> had to be used for this purpose.
   </para>
  </refsect1>