From 6b0e3ce8b1b18903bc069fafd54201f954fc0d0a Mon Sep 17 00:00:00 2001
From: Anthony Bedford <abedford@php.net>
Date: Thu, 24 Mar 2011 11:59:12 +0000
Subject: [PATCH] Add useful notes chapter. Notes on diffs between libmysql and
 mysqlnd when handling GEOMETRY types. Fixes bug #49357.

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

diff --git a/reference/mysqli/book.xml b/reference/mysqli/book.xml
index e672583d57..d147e8d4d6 100644
--- a/reference/mysqli/book.xml
+++ b/reference/mysqli/book.xml
@@ -55,6 +55,7 @@
  &reference.mysqli.setup;
  &reference.mysqli.persistconns;
  &reference.mysqli.constants;
+ &reference.mysqli.notes;
  &reference.mysqli.summary;
  &reference.mysqli.mysqli;
  &reference.mysqli.mysqli-stmt;
diff --git a/reference/mysqli/notes.xml b/reference/mysqli/notes.xml
new file mode 100644
index 0000000000..a76690afe3
--- /dev/null
+++ b/reference/mysqli/notes.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: $ -->
+
+<chapter xml:id="mysqli.notes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Notes</title>
+
+ <para>Some implementation notes:</para>
+
+ <orderedlist>
+  <listitem>
+   <para>
+     Support was added for <literal>MYSQL_TYPE_GEOMETRY</literal> 
+     to the MySQLi extension in PHP 5.3.
+   </para>
+  </listitem>
+  <listitem>
+   <para>
+     Note there are different internal implementations within 
+     <literal>libmysql</literal> and <literal>mysqlnd</literal> for handling 
+     columns of type <literal>MYSQL_TYPE_GEOMETRY</literal>. Generally speaking, 
+     <literal>mysqlnd</literal> will allocate significantly less memory. For 
+     example, if there is a <literal>POINT</literal> 
+     column in a result set, <literal>libmysql</literal> may pre-allocate up 
+     to 4GB of RAM although less than 50 bytes are 
+     needed for holding a <literal>POINT</literal> column in memory. Memory 
+     allocation is much lower, less than 50 bytes, if 
+     using <literal>mysqlnd</literal>.
+   </para>
+  </listitem>
+ </orderedlist>
+
+</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
+-->
+