svn commit - mysqldoc@docsrva: r13992 - trunk/refman-common

[anthony.bedford]

Author: tbedford
Date: 2009-02-27 11:50:10 +0100 (Fri, 27 Feb 2009)
New Revision: 13992

Log:
Added note on C/ODBC driver pitfall when using unixODBC/iODBC.

Modified:
   trunk/refman-common/connector-odbc.xml


Modified: trunk/refman-common/connector-odbc.xml
===================================================================
--- trunk/refman-common/connector-odbc.xml	2009-02-27 10:34:20 UTC (rev 13991)
+++ trunk/refman-common/connector-odbc.xml	2009-02-27 10:50:10 UTC (rev 13992)
Changed blocks: 2, Lines Added: 17, Lines Deleted: 2; 1558 bytes

@@ -803,6 +803,20 @@
       becomes available for other users.
     </para>
 
+    <note>
+      <para>
+        On all non-Windows platforms except Mac OS X, the driver is
+        built against <literal>unixODBC</literal> and is expecting a
+        2-byte <literal>SQLWCHAR</literal>, not 4 bytes as
+        <literal>iODBC</literal> is using. For this reason, the binaries
+        are <emphasis role="bold">only</emphasis> compatible with
+        <literal>unixODBC</literal> and you will need to recompile the
+        driver against <literal>iODBC</literal> if you wish to use them
+        together. For further information see
+        <xref linkend="connector-odbc-driver-manager"/>.
+      </para>
+    </note>
+
     <para>
       For further instructions:
     </para>

@@ -1761,8 +1775,9 @@
           <para>
             If you have built your own MySQL server and/or client
             libraries from source then you must have used the
-            <option role="configure">--enable-thread-safe-client</option>
option to
-            <literal>configure</literal> when the libraries were built.
+            <option role="configure">--enable-thread-safe-client</option>
+            option to <literal>configure</literal> when the libraries
+            were built.
           </para>
 
           <para>