List:Commits« Previous MessageNext Message »
From:anthony.bedford Date:April 9 2009 2:41pm
Subject:svn commit - mysqldoc@docsrva: r14565 - trunk/refman-common
View as plain text  
Author: tbedford
Date: 2009-04-09 16:41:35 +0200 (Thu, 09 Apr 2009)
New Revision: 14565

Log:
Added note on potential binary incompatibilities.

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


Modified: trunk/refman-common/connector-cpp.xml
===================================================================
--- trunk/refman-common/connector-cpp.xml	2009-04-09 14:21:48 UTC (rev 14564)
+++ trunk/refman-common/connector-cpp.xml	2009-04-09 14:41:35 UTC (rev 14565)
Changed blocks: 1, Lines Added: 43, Lines Deleted: 9; 2701 bytes

@@ -2929,18 +2929,52 @@
       <emphasis role="bold"> Known issues: </emphasis>
     </para>
 
-    <para>
-      When linking against a static library for 1.0.3 on Windows you
-      need to define <literal>CPPDBC_PUBLIC_FUNC</literal> either in the
-      compiler options (preferable) or with <literal>/D
-      "CPPCONN_PUBLIC_FUNC="</literal>. You can also explicitly define
-      it in your code by placing <literal>#define
-      CPPCONN_PUBLIC_FUNC</literal> before the header inclusions.
-    </para>
+    <itemizedlist>
 
+      <listitem>
+        <para>
+          When linking against a static library for 1.0.3 on Windows you
+          need to define <literal>CPPDBC_PUBLIC_FUNC</literal> either in
+          the compiler options (preferable) or with <literal>/D
+          "CPPCONN_PUBLIC_FUNC="</literal>. You can also explicitly
+          define it in your code by placing <literal>#define
+          CPPCONN_PUBLIC_FUNC</literal> before the header inclusions.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          Generally speaking C++ library binaries are less portable than
+          C library binaries. Issues can be caused by name mangling,
+          different Standard Template Library (STL) versions and using
+          different compilers and linkers for linking against the
+          libraries than were used for building the library itself.
+        </para>
+
+        <para>
+          Even a small change in the compiler version can, but does not
+          have to, cause problems. If you obtain error messages, that
+          you suspect are related to binary incompatibilities, build
+          &ccpp; from source, using the same compiler and linker that
+          you will use to build and link your application.
+        </para>
+
+        <para>
+          Due to the variations between Linux distributions, compiler
+          and linker versions and STL versions, it is not possible to
+          provide binaries for each and every possible configuration.
+          However, the &ccpp; binary distributions contain a
+          <filename>README</filename> file that describes the
+          environment and settings used to build the binary versions of
+          the libraries.
+        </para>
+      </listitem>
+
+    </itemizedlist>
+
     <para>
       See also the &ccpp; Changelogs which can be found here
-      <xref linkend="ccpp-news" />
+      <xref linkend="ccpp-news" />.
     </para>
 
   </section>


Thread
svn commit - mysqldoc@docsrva: r14565 - trunk/refman-commonanthony.bedford9 Apr