diff --git a/reference/mysql/functions/mysql-query.xml b/reference/mysql/functions/mysql-query.xml
index a09bd9cc8f..93a5ddeab2 100644
--- a/reference/mysql/functions/mysql-query.xml
+++ b/reference/mysql/functions/mysql-query.xml
@@ -11,6 +11,7 @@
       <type>resource</type><methodname>mysql_query</methodname>
       <methodparam><type>string</type><parameter>query</parameter></methodparam>
       <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>result_mode</parameter></methodparam>
      </methodsynopsis>
     <para>
      <function>mysql_query</function> sends a query to the currently
@@ -21,6 +22,13 @@
      to establish a link as if <function>mysql_connect</function> was
      called with no arguments, and use it.
     </para>
+    <para>
+     The optional <parameter>result_mode</parameter> parameter
+     can be MYSQL_USE_RESULT and MYSQL_STORE_RESULT. It
+     defaults to MYSQL_STORE_RESULT, so the result is buffered.
+     See also <function>mysql_unbuffered_query</function> for the
+     counterpart of this behaviour.
+    </para>
     <note>
      <para>
       The query string should not end with a semicolon.
diff --git a/reference/mysql/functions/mysql-unbuffered-query.xml b/reference/mysql/functions/mysql-unbuffered-query.xml
index dd9233d6ce..e82a8f9869 100644
--- a/reference/mysql/functions/mysql-unbuffered-query.xml
+++ b/reference/mysql/functions/mysql-unbuffered-query.xml
@@ -14,6 +14,7 @@
       <type>resource</type><methodname>mysql_unbuffered_query</methodname>
       <methodparam><type>string</type><parameter>query</parameter></methodparam>
       <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>result_mode</parameter></methodparam>
      </methodsynopsis>
     <para>
      <function>mysql_unbuffered_query</function> sends a SQL query
@@ -28,6 +29,13 @@
      have to specify the optional parameter
      <parameter>link_identifier</parameter>.
     </para>
+    <para>
+     The optional <parameter>result_mode</parameter> parameter
+     can be MYSQL_USE_RESULT and MYSQL_STORE_RESULT. It
+     defaults to MYSQL_USE_RESULT, so the result is not buffered.
+     See also <function>mysql_query</function> for the
+     counterpart of this behaviour.
+    </para>
     <note>
      <para>
       The benefits of <function>mysql_unbuffered_query</function> come