From f832eeb991a3f87f845b0d21e8eb90341b9ffd80 Mon Sep 17 00:00:00 2001
From: Anthony Bedford <abedford@php.net>
Date: Fri, 13 Nov 2009 17:44:31 +0000
Subject: [PATCH] Added a miscellaneous notes section.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@290684 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mysqlnd/book.xml  |  1 +
 reference/mysqlnd/notes.xml | 67 +++++++++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 reference/mysqlnd/notes.xml

diff --git a/reference/mysqlnd/book.xml b/reference/mysqlnd/book.xml
index f753ebc8ec..91741a62d1 100644
--- a/reference/mysqlnd/book.xml
+++ b/reference/mysqlnd/book.xml
@@ -25,6 +25,7 @@
 &reference.mysqlnd.config;
 &reference.mysqlnd.persist;
 &reference.mysqlnd.stats;
+&reference.mysqlnd.notes;
 
 </book>
 <!-- Keep this comment at the end of the file
diff --git a/reference/mysqlnd/notes.xml b/reference/mysqlnd/notes.xml
new file mode 100644
index 0000000000..439911aff0
--- /dev/null
+++ b/reference/mysqlnd/notes.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 290562 $ -->
+<chapter xml:id="mysqlnd.notes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Notes</title>
+ <para>
+  This section provides a collection of miscellaneous notes on MySQL
+  Native Driver usage.
+ </para>
+ <itemizedlist>
+  <listitem>
+   <para>
+    In the case where you pass a statement to
+    <function>mysqli_query</function> that is longer than
+    <literal>max_allowed_packet</literal> of the server, the returned
+    error codes are different depending on whether you are using MySQL
+    Native Driver (<literal>mysqlnd</literal>) or MySQL Client Library
+    (<literal>libmysql</literal>). The behavior is as follows:
+   </para>
+   <itemizedlist>
+    <listitem>
+     <para>
+      <literal>mysqlnd</literal> on Linux returns an error code of 1153.
+      The error message means <quote>got a packet bigger than
+      <literal>max_allowed_packet</literal> bytes</quote>.
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      <literal>mysqlnd</literal> on Windows returns an error code 2006.
+      This error message means <quote>server has gone away</quote>.
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      <literal>libmysql</literal> on all platforms returns an error code
+      2006. This error message means <quote>server has gone
+      away</quote>.
+     </para>
+    </listitem>
+   </itemizedlist>
+   <para>
+    The same thing happens with
+    <function>mysqli_stmt_prepare</function>.
+   </para>
+  </listitem>
+ </itemizedlist>
+</chapter>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->