diff --git a/functions/mysql.xml b/functions/mysql.xml
index 0f3281282c..38b945cbd2 100644
--- a/functions/mysql.xml
+++ b/functions/mysql.xml
@@ -51,6 +51,13 @@
      server associated with the specified link identifier.  If the
      link identifier isn't specified, the last opened link is assumed.
     </para>
+    <note>
+     <para>
+      If you are using transactions, you need to call
+      <function>mysql_affected_rows</function> after your INSERT,
+      UPDATE, or DELETE query, not after the commit.
+     </para>
+    </note>
     <para>
      If the last query was a DELETE query with no WHERE clause, all
      of the records will have been deleted from the table but this