List:Commits« Previous MessageNext Message »
From:paul.dubois Date:December 9 2010 3:57pm
Subject:svn commit - mysqldoc@docsrva: r24350 - in trunk: . refman-4.1 refman-5.0 refman-5.1 refman-5.5 refman-5.6 refman-6.0
View as plain text  
Author: paul
Date: 2010-12-09 16:57:23 +0100 (Thu, 09 Dec 2010)
New Revision: 24350

Log:
 r36976@dhcp-215:  paul | 2010-12-09 09:56:20 -0500
 Combine two similar sections on linking to the client library


Modified:
   trunk/refman-4.1/apis-c.xml
   trunk/refman-4.1/errors-problems.xml
   trunk/refman-4.1/installing.xml
   trunk/refman-4.1/renamed-nodes.txt
   trunk/refman-5.0/apis-c.xml
   trunk/refman-5.0/errors-problems.xml
   trunk/refman-5.0/installing.xml
   trunk/refman-5.0/renamed-nodes.txt
   trunk/refman-5.1/apis-c.xml
   trunk/refman-5.1/errors-problems.xml
   trunk/refman-5.1/renamed-nodes.txt
   trunk/refman-5.5/apis-c.xml
   trunk/refman-5.5/errors-problems.xml
   trunk/refman-5.5/renamed-nodes.txt
   trunk/refman-5.6/apis-c.xml
   trunk/refman-5.6/errors-problems.xml
   trunk/refman-6.0/apis-c.xml
   trunk/refman-6.0/errors-problems.xml
   trunk/refman-6.0/installing.xml

Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - 07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/mysqldoc/trunk:35498
07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/trunk:45239
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:43968
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/trunk:44480
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:66486
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:39036
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/trunk:39546
ebeeeee4-b232-4669-a521-231442eced53:/mysqldoc-local/mysqldoc/trunk:36973
   + 07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/mysqldoc/trunk:35498
07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/trunk:45239
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:43968
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/trunk:44480
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:66486
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:39036
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/trunk:39546
ebeeeee4-b232-4669-a521-231442eced53:/mysqldoc-local/mysqldoc/trunk:36976


Modified: trunk/refman-4.1/apis-c.xml
===================================================================
--- trunk/refman-4.1/apis-c.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/apis-c.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes

@@ -14131,18 +14131,33 @@
 
     <section id="c-api-linking-problems">
 
-      <title>Problems Linking with the C API</title>
+      <title>Problems Linking to the MySQL Client Library</title>
 
       <indexterm>
+        <primary>C API</primary>
+        <secondary>linking problems</secondary>
+      </indexterm>
+
+      <indexterm>
         <primary>linking</primary>
-        <secondary>problems</secondary>
+        <secondary>errors</secondary>
       </indexterm>
 
       <indexterm>
-        <primary>C API</primary>
-        <secondary>linking problems</secondary>
+        <primary>errors</primary>
+        <secondary>linking</secondary>
       </indexterm>
 
+      <indexterm>
+        <primary>problems</primary>
+        <secondary>linking</secondary>
+      </indexterm>
+
+      <indexterm>
+        <primary>linking</primary>
+        <secondary>problems</secondary>
+      </indexterm>
+
       <para>
         When linking with the C API, the following errors may occur on
         some systems:

@@ -14177,6 +14192,121 @@
         (<literal>libmysqlclient_r</literal>).
       </para>
 
+      <para>
+        When you are linking an application program to use the MySQL
+        client library, you might get undefined reference errors for
+        symbols that start with <literal>mysql_</literal>, such as those
+        shown here:
+      </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+      <para>
+        You should be able to solve this problem by adding
+        <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+        link command, where <literal>dir_path</literal> represents the
+        path name of the directory where the client library is located.
+        To determine the correct directory, try this command:
+      </para>
+
+<programlisting>
+shell&gt; <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+      <para>
+        The output from <command>mysql_config</command> might indicate
+        other libraries that should be specified on the link command as
+        well.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for the
+        <literal>uncompress</literal> or <literal>compress</literal>
+        function, add <literal>-lz</literal> to the end of your link
+        command and try again.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for a
+        function that should exist on your system, such as
+        <literal>connect</literal>, check the manual page for the
+        function in question to determine which libraries you should add
+        to the link command.
+      </para>
+
+      <para>
+        You might get <literal>undefined reference</literal> errors such
+        as the following for functions that don't exist on your system:
+      </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+      <para>
+        This usually means that your MySQL client library was compiled
+        on a system that is not 100% compatible with yours. In this
+        case, you should download the latest MySQL source distribution
+        and compile MySQL yourself. See
+        <xref linkend="source-installation"/>.
+      </para>
+
+      <para>
+        You might get undefined reference errors at runtime when you try
+        to execute a MySQL program. If these errors specify symbols that
+        start with <literal>mysql_</literal> or indicate that the
+        <literal>mysqlclient</literal> library can't be found, it means
+        that your system can't find the shared
+        <filename>libmysqlclient.so</filename> library. The fix for this
+        is to tell your system to search for shared libraries where the
+        library is located. Use whichever of the following methods is
+        appropriate for your system:
+      </para>
+
+      <itemizedlist>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY_PATH</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Copy <filename>libmysqlclient.so</filename> to some
+            directory that is searched by your system, such as
+            <filename>/lib</filename>, and update the shared library
+            information by executing <literal>ldconfig</literal>.
+          </para>
+        </listitem>
+
+      </itemizedlist>
+
+      <para>
+        Another way to solve this problem is by linking your program
+        statically with the <literal>-static</literal> option, or by
+        removing the dynamic MySQL libraries before linking your code.
+        Before trying the second method, you should be sure that no
+        other programs are using the dynamic libraries.
+      </para>
+
     </section>
 
     <section id="threaded-clients">


Modified: trunk/refman-4.1/errors-problems.xml
===================================================================
--- trunk/refman-4.1/errors-problems.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/errors-problems.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 4, Lines Deleted: 141; 5989 bytes

@@ -1393,9 +1393,10 @@
 
         <para>
           Increasing <option role="mysqld">open-files-limit</option> may
-          be necessary. Also see <xref linkend="linux-postinstallation"/>,
-          for how to raise the operating system limit on how many
-          handles can be used by MySQL.
+          be necessary. Also see
+          <xref linkend="linux-postinstallation"/>, for how to raise the
+          operating system limit on how many handles can be used by
+          MySQL.
         </para>
 
       </section>

@@ -2799,144 +2800,6 @@
 
       <title>Installation-Related Issues</title>
 
-      <section id="link-errors">
-
-        <title>Problems Linking to the MySQL Client Library</title>
-
-        <indexterm>
-          <primary>linking</primary>
-          <secondary>errors</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>errors</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>problems</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <para>
-          When you are linking an application program to use the MySQL
-          client library, you might get undefined reference errors for
-          symbols that start with <literal>mysql_</literal>, such as
-          those shown here:
-        </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
-        <para>
-          You should be able to solve this problem by adding
-          <literal>-Ldir_path -lmysqlclient</literal> at the end of your
-          link command, where <literal>dir_path</literal> represents the
-          path name of the directory where the client library is
-          located. To determine the correct directory, try this command:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>mysql_config --libs</userinput>
-</programlisting>
-
-        <para>
-          The output from <command>mysql_config</command> might indicate
-          other libraries that should be specified on the link command
-          as well.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for
-          the <literal>uncompress</literal> or
-          <literal>compress</literal> function, add
-          <literal>-lz</literal> to the end of your link command and try
-          again.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for a
-          function that should exist on your system, such as
-          <literal>connect</literal>, check the manual page for the
-          function in question to determine which libraries you should
-          add to the link command.
-        </para>
-
-        <para>
-          You might get <literal>undefined reference</literal> errors
-          such as the following for functions that don't exist on your
-          system:
-        </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
-        <para>
-          This usually means that your MySQL client library was compiled
-          on a system that is not 100% compatible with yours. In this
-          case, you should download the latest MySQL source distribution
-          and compile MySQL yourself. See
-          <xref linkend="source-installation"/>.
-        </para>
-
-        <para>
-          You might get undefined reference errors at runtime when you
-          try to execute a MySQL program. If these errors specify
-          symbols that start with <literal>mysql_</literal> or indicate
-          that the <literal>mysqlclient</literal> library can't be
-          found, it means that your system can't find the shared
-          <filename>libmysqlclient.so</filename> library. The fix for
-          this is to tell your system to search for shared libraries
-          where the library is located. Use whichever of the following
-          methods is appropriate for your system:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY_PATH</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Copy <filename>libmysqlclient.so</filename> to some
-              directory that is searched by your system, such as
-              <filename>/lib</filename>, and update the shared library
-              information by executing <literal>ldconfig</literal>.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-        <para>
-          Another way to solve this problem is by linking your program
-          statically with the <literal>-static</literal> option, or by
-          removing the dynamic MySQL libraries before linking your code.
-          Before trying the second method, you should be sure that no
-          other programs are using the dynamic libraries.
-        </para>
-
-      </section>
-
       <section id="file-permissions">
 
         <title>Problems with File Permissions</title>


Modified: trunk/refman-4.1/installing.xml
===================================================================
--- trunk/refman-4.1/installing.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/installing.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 1; 438 bytes

@@ -6649,7 +6649,7 @@
         </para>
 
         <para>
-          See <xref linkend="link-errors"/>.
+          See <xref linkend="c-api-linking-problems"/>.
         </para>
 
       </section>


Modified: trunk/refman-4.1/renamed-nodes.txt
===================================================================
--- trunk/refman-4.1/renamed-nodes.txt	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/renamed-nodes.txt	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 600 bytes

@@ -49,6 +49,7 @@
 installing-source source-installation 2011-10-22
 installing-source-tree installing-development-tree 2011-11-28
 internal-use optimization 2010-10-26
+link-errors c-api-linking-problems 2011-12-09
 linux-post-install linux-postinstallation 2011-12-03
 linux-rpm linux-installation-rpm 2011-10-22
 log-files server-logs 2010-03-24


Modified: trunk/refman-5.0/apis-c.xml
===================================================================
--- trunk/refman-5.0/apis-c.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/apis-c.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes

@@ -14405,18 +14405,33 @@
 
     <section id="c-api-linking-problems">
 
-      <title>Problems Linking with the C API</title>
+      <title>Problems Linking to the MySQL Client Library</title>
 
       <indexterm>
+        <primary>C API</primary>
+        <secondary>linking problems</secondary>
+      </indexterm>
+
+      <indexterm>
         <primary>linking</primary>
-        <secondary>problems</secondary>
+        <secondary>errors</secondary>
       </indexterm>
 
       <indexterm>
-        <primary>C API</primary>
-        <secondary>linking problems</secondary>
+        <primary>errors</primary>
+        <secondary>linking</secondary>
       </indexterm>
 
+      <indexterm>
+        <primary>problems</primary>
+        <secondary>linking</secondary>
+      </indexterm>
+
+      <indexterm>
+        <primary>linking</primary>
+        <secondary>problems</secondary>
+      </indexterm>
+
       <para>
         When linking with the C API, the following errors may occur on
         some systems:

@@ -14451,6 +14466,121 @@
         (<literal>libmysqlclient_r</literal>).
       </para>
 
+      <para>
+        When you are linking an application program to use the MySQL
+        client library, you might get undefined reference errors for
+        symbols that start with <literal>mysql_</literal>, such as those
+        shown here:
+      </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+      <para>
+        You should be able to solve this problem by adding
+        <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+        link command, where <literal>dir_path</literal> represents the
+        path name of the directory where the client library is located.
+        To determine the correct directory, try this command:
+      </para>
+
+<programlisting>
+shell&gt; <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+      <para>
+        The output from <command>mysql_config</command> might indicate
+        other libraries that should be specified on the link command as
+        well.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for the
+        <literal>uncompress</literal> or <literal>compress</literal>
+        function, add <literal>-lz</literal> to the end of your link
+        command and try again.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for a
+        function that should exist on your system, such as
+        <literal>connect</literal>, check the manual page for the
+        function in question to determine which libraries you should add
+        to the link command.
+      </para>
+
+      <para>
+        You might get <literal>undefined reference</literal> errors such
+        as the following for functions that don't exist on your system:
+      </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+      <para>
+        This usually means that your MySQL client library was compiled
+        on a system that is not 100% compatible with yours. In this
+        case, you should download the latest MySQL source distribution
+        and compile MySQL yourself. See
+        <xref linkend="source-installation"/>.
+      </para>
+
+      <para>
+        You might get undefined reference errors at runtime when you try
+        to execute a MySQL program. If these errors specify symbols that
+        start with <literal>mysql_</literal> or indicate that the
+        <literal>mysqlclient</literal> library can't be found, it means
+        that your system can't find the shared
+        <filename>libmysqlclient.so</filename> library. The fix for this
+        is to tell your system to search for shared libraries where the
+        library is located. Use whichever of the following methods is
+        appropriate for your system:
+      </para>
+
+      <itemizedlist>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY_PATH</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Copy <filename>libmysqlclient.so</filename> to some
+            directory that is searched by your system, such as
+            <filename>/lib</filename>, and update the shared library
+            information by executing <literal>ldconfig</literal>.
+          </para>
+        </listitem>
+
+      </itemizedlist>
+
+      <para>
+        Another way to solve this problem is by linking your program
+        statically with the <literal>-static</literal> option, or by
+        removing the dynamic MySQL libraries before linking your code.
+        Before trying the second method, you should be sure that no
+        other programs are using the dynamic libraries.
+      </para>
+
     </section>
 
     <section id="threaded-clients">


Modified: trunk/refman-5.0/errors-problems.xml
===================================================================
--- trunk/refman-5.0/errors-problems.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/errors-problems.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 4, Lines Deleted: 141; 5989 bytes

@@ -1393,9 +1393,10 @@
 
         <para>
           Increasing <option role="mysqld">open-files-limit</option> may
-          be necessary. Also see <xref linkend="linux-postinstallation"/>,
-          for how to raise the operating system limit on how many
-          handles can be used by MySQL.
+          be necessary. Also see
+          <xref linkend="linux-postinstallation"/>, for how to raise the
+          operating system limit on how many handles can be used by
+          MySQL.
         </para>
 
       </section>

@@ -2715,144 +2716,6 @@
 
       <title>Installation-Related Issues</title>
 
-      <section id="link-errors">
-
-        <title>Problems Linking to the MySQL Client Library</title>
-
-        <indexterm>
-          <primary>linking</primary>
-          <secondary>errors</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>errors</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>problems</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <para>
-          When you are linking an application program to use the MySQL
-          client library, you might get undefined reference errors for
-          symbols that start with <literal>mysql_</literal>, such as
-          those shown here:
-        </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
-        <para>
-          You should be able to solve this problem by adding
-          <literal>-Ldir_path -lmysqlclient</literal> at the end of your
-          link command, where <literal>dir_path</literal> represents the
-          path name of the directory where the client library is
-          located. To determine the correct directory, try this command:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>mysql_config --libs</userinput>
-</programlisting>
-
-        <para>
-          The output from <command>mysql_config</command> might indicate
-          other libraries that should be specified on the link command
-          as well.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for
-          the <literal>uncompress</literal> or
-          <literal>compress</literal> function, add
-          <literal>-lz</literal> to the end of your link command and try
-          again.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for a
-          function that should exist on your system, such as
-          <literal>connect</literal>, check the manual page for the
-          function in question to determine which libraries you should
-          add to the link command.
-        </para>
-
-        <para>
-          You might get <literal>undefined reference</literal> errors
-          such as the following for functions that don't exist on your
-          system:
-        </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
-        <para>
-          This usually means that your MySQL client library was compiled
-          on a system that is not 100% compatible with yours. In this
-          case, you should download the latest MySQL source distribution
-          and compile MySQL yourself. See
-          <xref linkend="source-installation"/>.
-        </para>
-
-        <para>
-          You might get undefined reference errors at runtime when you
-          try to execute a MySQL program. If these errors specify
-          symbols that start with <literal>mysql_</literal> or indicate
-          that the <literal>mysqlclient</literal> library can't be
-          found, it means that your system can't find the shared
-          <filename>libmysqlclient.so</filename> library. The fix for
-          this is to tell your system to search for shared libraries
-          where the library is located. Use whichever of the following
-          methods is appropriate for your system:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY_PATH</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Copy <filename>libmysqlclient.so</filename> to some
-              directory that is searched by your system, such as
-              <filename>/lib</filename>, and update the shared library
-              information by executing <literal>ldconfig</literal>.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-        <para>
-          Another way to solve this problem is by linking your program
-          statically with the <literal>-static</literal> option, or by
-          removing the dynamic MySQL libraries before linking your code.
-          Before trying the second method, you should be sure that no
-          other programs are using the dynamic libraries.
-        </para>
-
-      </section>
-
       <section id="file-permissions">
 
         <title>Problems with File Permissions</title>


Modified: trunk/refman-5.0/installing.xml
===================================================================
--- trunk/refman-5.0/installing.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/installing.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 1; 438 bytes

@@ -3467,7 +3467,7 @@
         </para>
 
         <para>
-          See <xref linkend="link-errors"/>.
+          See <xref linkend="c-api-linking-problems"/>.
         </para>
 
       </section>


Modified: trunk/refman-5.0/renamed-nodes.txt
===================================================================
--- trunk/refman-5.0/renamed-nodes.txt	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/renamed-nodes.txt	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 600 bytes

@@ -53,6 +53,7 @@
 installing-source source-installation 2011-10-22
 installing-source-tree installing-development-tree 2011-11-28
 internal-use optimization 2010-10-26
+link-errors c-api-linking-problems 2011-12-09
 linux-post-install linux-postinstallation 2011-12-03
 linux-rpm linux-installation-rpm 2011-10-22
 log-files server-logs 2010-03-24


Modified: trunk/refman-5.1/apis-c.xml
===================================================================
--- trunk/refman-5.1/apis-c.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.1/apis-c.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes

@@ -14481,18 +14481,33 @@
 
     <section id="c-api-linking-problems">
 
-      <title>Problems Linking with the C API</title>
+      <title>Problems Linking to the MySQL Client Library</title>
 
       <indexterm>
+        <primary>C API</primary>
+        <secondary>linking problems</secondary>
+      </indexterm>
+
+      <indexterm>
         <primary>linking</primary>
-        <secondary>problems</secondary>
+        <secondary>errors</secondary>
       </indexterm>
 
       <indexterm>
-        <primary>C API</primary>
-        <secondary>linking problems</secondary>
+        <primary>errors</primary>
+        <secondary>linking</secondary>
       </indexterm>
 
+      <indexterm>
+        <primary>problems</primary>
+        <secondary>linking</secondary>
+      </indexterm>
+
+      <indexterm>
+        <primary>linking</primary>
+        <secondary>problems</secondary>
+      </indexterm>
+
       <para>
         When linking with the C API, the following errors may occur on
         some systems:

@@ -14527,6 +14542,121 @@
         (<literal>libmysqlclient_r</literal>).
       </para>
 
+      <para>
+        When you are linking an application program to use the MySQL
+        client library, you might get undefined reference errors for
+        symbols that start with <literal>mysql_</literal>, such as those
+        shown here:
+      </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+      <para>
+        You should be able to solve this problem by adding
+        <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+        link command, where <literal>dir_path</literal> represents the
+        path name of the directory where the client library is located.
+        To determine the correct directory, try this command:
+      </para>
+
+<programlisting>
+shell&gt; <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+      <para>
+        The output from <command>mysql_config</command> might indicate
+        other libraries that should be specified on the link command as
+        well.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for the
+        <literal>uncompress</literal> or <literal>compress</literal>
+        function, add <literal>-lz</literal> to the end of your link
+        command and try again.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for a
+        function that should exist on your system, such as
+        <literal>connect</literal>, check the manual page for the
+        function in question to determine which libraries you should add
+        to the link command.
+      </para>
+
+      <para>
+        You might get <literal>undefined reference</literal> errors such
+        as the following for functions that don't exist on your system:
+      </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+      <para>
+        This usually means that your MySQL client library was compiled
+        on a system that is not 100% compatible with yours. In this
+        case, you should download the latest MySQL source distribution
+        and compile MySQL yourself. See
+        <xref linkend="source-installation"/>.
+      </para>
+
+      <para>
+        You might get undefined reference errors at runtime when you try
+        to execute a MySQL program. If these errors specify symbols that
+        start with <literal>mysql_</literal> or indicate that the
+        <literal>mysqlclient</literal> library can't be found, it means
+        that your system can't find the shared
+        <filename>libmysqlclient.so</filename> library. The fix for this
+        is to tell your system to search for shared libraries where the
+        library is located. Use whichever of the following methods is
+        appropriate for your system:
+      </para>
+
+      <itemizedlist>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY_PATH</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Copy <filename>libmysqlclient.so</filename> to some
+            directory that is searched by your system, such as
+            <filename>/lib</filename>, and update the shared library
+            information by executing <literal>ldconfig</literal>.
+          </para>
+        </listitem>
+
+      </itemizedlist>
+
+      <para>
+        Another way to solve this problem is by linking your program
+        statically with the <literal>-static</literal> option, or by
+        removing the dynamic MySQL libraries before linking your code.
+        Before trying the second method, you should be sure that no
+        other programs are using the dynamic libraries.
+      </para>
+
     </section>
 
     <section id="threaded-clients">


Modified: trunk/refman-5.1/errors-problems.xml
===================================================================
--- trunk/refman-5.1/errors-problems.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.1/errors-problems.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 0, Lines Deleted: 138; 5472 bytes

@@ -2717,144 +2717,6 @@
 
       <title>Installation-Related Issues</title>
 
-      <section id="link-errors">
-
-        <title>Problems Linking to the MySQL Client Library</title>
-
-        <indexterm>
-          <primary>linking</primary>
-          <secondary>errors</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>errors</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>problems</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <para>
-          When you are linking an application program to use the MySQL
-          client library, you might get undefined reference errors for
-          symbols that start with <literal>mysql_</literal>, such as
-          those shown here:
-        </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
-        <para>
-          You should be able to solve this problem by adding
-          <literal>-Ldir_path -lmysqlclient</literal> at the end of your
-          link command, where <literal>dir_path</literal> represents the
-          path name of the directory where the client library is
-          located. To determine the correct directory, try this command:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>mysql_config --libs</userinput>
-</programlisting>
-
-        <para>
-          The output from <command>mysql_config</command> might indicate
-          other libraries that should be specified on the link command
-          as well.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for
-          the <literal>uncompress</literal> or
-          <literal>compress</literal> function, add
-          <literal>-lz</literal> to the end of your link command and try
-          again.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for a
-          function that should exist on your system, such as
-          <literal>connect</literal>, check the manual page for the
-          function in question to determine which libraries you should
-          add to the link command.
-        </para>
-
-        <para>
-          You might get <literal>undefined reference</literal> errors
-          such as the following for functions that don't exist on your
-          system:
-        </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
-        <para>
-          This usually means that your MySQL client library was compiled
-          on a system that is not 100% compatible with yours. In this
-          case, you should download the latest MySQL source distribution
-          and compile MySQL yourself. See
-          <xref linkend="source-installation"/>.
-        </para>
-
-        <para>
-          You might get undefined reference errors at runtime when you
-          try to execute a MySQL program. If these errors specify
-          symbols that start with <literal>mysql_</literal> or indicate
-          that the <literal>mysqlclient</literal> library can't be
-          found, it means that your system can't find the shared
-          <filename>libmysqlclient.so</filename> library. The fix for
-          this is to tell your system to search for shared libraries
-          where the library is located. Use whichever of the following
-          methods is appropriate for your system:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY_PATH</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Copy <filename>libmysqlclient.so</filename> to some
-              directory that is searched by your system, such as
-              <filename>/lib</filename>, and update the shared library
-              information by executing <literal>ldconfig</literal>.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-        <para>
-          Another way to solve this problem is by linking your program
-          statically with the <literal>-static</literal> option, or by
-          removing the dynamic MySQL libraries before linking your code.
-          Before trying the second method, you should be sure that no
-          other programs are using the dynamic libraries.
-        </para>
-
-      </section>
-
       <section id="file-permissions">
 
         <title>Problems with File Permissions</title>


Modified: trunk/refman-5.1/renamed-nodes.txt
===================================================================
--- trunk/refman-5.1/renamed-nodes.txt	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.1/renamed-nodes.txt	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 594 bytes

@@ -56,6 +56,7 @@
 installing-source source-installation 2011-10-22
 installing-source-tree installing-development-tree 2011-11-28
 internal-use optimization 2010-10-26
+link-errors c-api-linking-problems 2011-12-09
 linux linux-installation 2010-10-20
 linux-os linux-installation 2010-10-01
 linux-post-install linux-installation 2010-10-01


Modified: trunk/refman-5.5/apis-c.xml
===================================================================
--- trunk/refman-5.5/apis-c.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.5/apis-c.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 126, Lines Deleted: 4; 5351 bytes

@@ -15499,18 +15499,33 @@
 
     <section id="c-api-linking-problems">
 
-      <title>Problems Linking with the C API</title>
+      <title>Problems Linking to the MySQL Client Library</title>
 
       <indexterm>
+        <primary>C API</primary>
+        <secondary>linking problems</secondary>
+      </indexterm>
+
+      <indexterm>
         <primary>linking</primary>
-        <secondary>problems</secondary>
+        <secondary>errors</secondary>
       </indexterm>
 
       <indexterm>
-        <primary>C API</primary>
-        <secondary>linking problems</secondary>
+        <primary>errors</primary>
+        <secondary>linking</secondary>
       </indexterm>
 
+      <indexterm>
+        <primary>problems</primary>
+        <secondary>linking</secondary>
+      </indexterm>
+
+      <indexterm>
+        <primary>linking</primary>
+        <secondary>problems</secondary>
+      </indexterm>
+
       <para>
         When linking with the C API, the following errors may occur on
         some systems:

@@ -15532,6 +15547,113 @@
         compile/link line.
       </para>
 
+      <para>
+        When you are linking an application program to use the MySQL
+        client library, you might get undefined reference errors for
+        symbols that start with <literal>mysql_</literal>, such as those
+        shown here:
+      </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+      <para>
+        You should be able to solve this problem by adding
+        <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+        link command, where <literal>dir_path</literal> represents the
+        path name of the directory where the client library is located.
+        To determine the correct directory, try this command:
+      </para>
+
+<programlisting>
+shell&gt; <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+      <para>
+        The output from <command>mysql_config</command> might indicate
+        other libraries that should be specified on the link command as
+        well.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for the
+        <literal>uncompress</literal> or <literal>compress</literal>
+        function, add <literal>-lz</literal> to the end of your link
+        command and try again.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for a
+        function that should exist on your system, such as
+        <literal>connect</literal>, check the manual page for the
+        function in question to determine which libraries you should add
+        to the link command.
+      </para>
+
+      <para>
+        You might get <literal>undefined reference</literal> errors such
+        as the following for functions that don't exist on your system:
+      </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+      <para>
+        This usually means that your MySQL client library was compiled
+        on a system that is not 100% compatible with yours. In this
+        case, you should download the latest MySQL source distribution
+        and compile MySQL yourself. See
+        <xref linkend="source-installation"/>.
+      </para>
+
+      <para>
+        You might get undefined reference errors at runtime when you try
+        to execute a MySQL program. If these errors specify symbols that
+        start with <literal>mysql_</literal> or indicate that the
+        <literal>mysqlclient</literal> library can't be found, it means
+        that your system can't find the shared
+        <filename>libmysqlclient.so</filename> library. The fix for this
+        is to tell your system to search for shared libraries where the
+        library is located. Use whichever of the following methods is
+        appropriate for your system:
+      </para>
+
+      <itemizedlist>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY_PATH</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Copy <filename>libmysqlclient.so</filename> to some
+            directory that is searched by your system, such as
+            <filename>/lib</filename>, and update the shared library
+            information by executing <literal>ldconfig</literal>.
+          </para>
+        </listitem>
+
+      </itemizedlist>
+
     </section>
 
     <section id="threaded-clients">


Modified: trunk/refman-5.5/errors-problems.xml
===================================================================
--- trunk/refman-5.5/errors-problems.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.5/errors-problems.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 0, Lines Deleted: 130; 5097 bytes

@@ -2702,136 +2702,6 @@
 
       <title>Installation-Related Issues</title>
 
-      <section id="link-errors">
-
-        <title>Problems Linking to the MySQL Client Library</title>
-
-        <indexterm>
-          <primary>linking</primary>
-          <secondary>errors</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>errors</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>problems</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <para>
-          When you are linking an application program to use the MySQL
-          client library, you might get undefined reference errors for
-          symbols that start with <literal>mysql_</literal>, such as
-          those shown here:
-        </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
-        <para>
-          You should be able to solve this problem by adding
-          <literal>-Ldir_path -lmysqlclient</literal> at the end of your
-          link command, where <literal>dir_path</literal> represents the
-          path name of the directory where the client library is
-          located. To determine the correct directory, try this command:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>mysql_config --libs</userinput>
-</programlisting>
-
-        <para>
-          The output from <command>mysql_config</command> might indicate
-          other libraries that should be specified on the link command
-          as well.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for
-          the <literal>uncompress</literal> or
-          <literal>compress</literal> function, add
-          <literal>-lz</literal> to the end of your link command and try
-          again.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for a
-          function that should exist on your system, such as
-          <literal>connect</literal>, check the manual page for the
-          function in question to determine which libraries you should
-          add to the link command.
-        </para>
-
-        <para>
-          You might get <literal>undefined reference</literal> errors
-          such as the following for functions that don't exist on your
-          system:
-        </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
-        <para>
-          This usually means that your MySQL client library was compiled
-          on a system that is not 100% compatible with yours. In this
-          case, you should download the latest MySQL source distribution
-          and compile MySQL yourself. See
-          <xref linkend="source-installation"/>.
-        </para>
-
-        <para>
-          You might get undefined reference errors at runtime when you
-          try to execute a MySQL program. If these errors specify
-          symbols that start with <literal>mysql_</literal> or indicate
-          that the <literal>mysqlclient</literal> library can't be
-          found, it means that your system can't find the shared
-          <filename>libmysqlclient.so</filename> library. The fix for
-          this is to tell your system to search for shared libraries
-          where the library is located. Use whichever of the following
-          methods is appropriate for your system:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY_PATH</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Copy <filename>libmysqlclient.so</filename> to some
-              directory that is searched by your system, such as
-              <filename>/lib</filename>, and update the shared library
-              information by executing <literal>ldconfig</literal>.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-      </section>
-
       <section id="file-permissions">
 
         <title>Problems with File Permissions</title>


Modified: trunk/refman-5.5/renamed-nodes.txt
===================================================================
--- trunk/refman-5.5/renamed-nodes.txt	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.5/renamed-nodes.txt	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 598 bytes

@@ -53,6 +53,7 @@
 installing-i5os i5os-installation 2011-10-22
 installing-source source-installation 2011-10-22
 installing-source-tree installing-development-tree 2011-11-28
+link-errors c-api-linking-problems 2011-12-09
 linux-alpha linux-installation 2011-10-23
 linux-ia-64 linux-installation 2011-10-23
 linux linux-installation 2011-10-23


Modified: trunk/refman-5.6/apis-c.xml
===================================================================
--- trunk/refman-5.6/apis-c.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.6/apis-c.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 126, Lines Deleted: 4; 5351 bytes

@@ -15459,18 +15459,33 @@
 
     <section id="c-api-linking-problems">
 
-      <title>Problems Linking with the C API</title>
+      <title>Problems Linking to the MySQL Client Library</title>
 
       <indexterm>
+        <primary>C API</primary>
+        <secondary>linking problems</secondary>
+      </indexterm>
+
+      <indexterm>
         <primary>linking</primary>
-        <secondary>problems</secondary>
+        <secondary>errors</secondary>
       </indexterm>
 
       <indexterm>
-        <primary>C API</primary>
-        <secondary>linking problems</secondary>
+        <primary>errors</primary>
+        <secondary>linking</secondary>
       </indexterm>
 
+      <indexterm>
+        <primary>problems</primary>
+        <secondary>linking</secondary>
+      </indexterm>
+
+      <indexterm>
+        <primary>linking</primary>
+        <secondary>problems</secondary>
+      </indexterm>
+
       <para>
         When linking with the C API, the following errors may occur on
         some systems:

@@ -15492,6 +15507,113 @@
         compile/link line.
       </para>
 
+      <para>
+        When you are linking an application program to use the MySQL
+        client library, you might get undefined reference errors for
+        symbols that start with <literal>mysql_</literal>, such as those
+        shown here:
+      </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+      <para>
+        You should be able to solve this problem by adding
+        <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+        link command, where <literal>dir_path</literal> represents the
+        path name of the directory where the client library is located.
+        To determine the correct directory, try this command:
+      </para>
+
+<programlisting>
+shell&gt; <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+      <para>
+        The output from <command>mysql_config</command> might indicate
+        other libraries that should be specified on the link command as
+        well.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for the
+        <literal>uncompress</literal> or <literal>compress</literal>
+        function, add <literal>-lz</literal> to the end of your link
+        command and try again.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for a
+        function that should exist on your system, such as
+        <literal>connect</literal>, check the manual page for the
+        function in question to determine which libraries you should add
+        to the link command.
+      </para>
+
+      <para>
+        You might get <literal>undefined reference</literal> errors such
+        as the following for functions that don't exist on your system:
+      </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+      <para>
+        This usually means that your MySQL client library was compiled
+        on a system that is not 100% compatible with yours. In this
+        case, you should download the latest MySQL source distribution
+        and compile MySQL yourself. See
+        <xref linkend="source-installation"/>.
+      </para>
+
+      <para>
+        You might get undefined reference errors at runtime when you try
+        to execute a MySQL program. If these errors specify symbols that
+        start with <literal>mysql_</literal> or indicate that the
+        <literal>mysqlclient</literal> library can't be found, it means
+        that your system can't find the shared
+        <filename>libmysqlclient.so</filename> library. The fix for this
+        is to tell your system to search for shared libraries where the
+        library is located. Use whichever of the following methods is
+        appropriate for your system:
+      </para>
+
+      <itemizedlist>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY_PATH</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Copy <filename>libmysqlclient.so</filename> to some
+            directory that is searched by your system, such as
+            <filename>/lib</filename>, and update the shared library
+            information by executing <literal>ldconfig</literal>.
+          </para>
+        </listitem>
+
+      </itemizedlist>
+
     </section>
 
     <section id="threaded-clients">


Modified: trunk/refman-5.6/errors-problems.xml
===================================================================
--- trunk/refman-5.6/errors-problems.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.6/errors-problems.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 0, Lines Deleted: 130; 5097 bytes

@@ -2702,136 +2702,6 @@
 
       <title>Installation-Related Issues</title>
 
-      <section id="link-errors">
-
-        <title>Problems Linking to the MySQL Client Library</title>
-
-        <indexterm>
-          <primary>linking</primary>
-          <secondary>errors</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>errors</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>problems</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <para>
-          When you are linking an application program to use the MySQL
-          client library, you might get undefined reference errors for
-          symbols that start with <literal>mysql_</literal>, such as
-          those shown here:
-        </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
-        <para>
-          You should be able to solve this problem by adding
-          <literal>-Ldir_path -lmysqlclient</literal> at the end of your
-          link command, where <literal>dir_path</literal> represents the
-          path name of the directory where the client library is
-          located. To determine the correct directory, try this command:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>mysql_config --libs</userinput>
-</programlisting>
-
-        <para>
-          The output from <command>mysql_config</command> might indicate
-          other libraries that should be specified on the link command
-          as well.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for
-          the <literal>uncompress</literal> or
-          <literal>compress</literal> function, add
-          <literal>-lz</literal> to the end of your link command and try
-          again.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for a
-          function that should exist on your system, such as
-          <literal>connect</literal>, check the manual page for the
-          function in question to determine which libraries you should
-          add to the link command.
-        </para>
-
-        <para>
-          You might get <literal>undefined reference</literal> errors
-          such as the following for functions that don't exist on your
-          system:
-        </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
-        <para>
-          This usually means that your MySQL client library was compiled
-          on a system that is not 100% compatible with yours. In this
-          case, you should download the latest MySQL source distribution
-          and compile MySQL yourself. See
-          <xref linkend="source-installation"/>.
-        </para>
-
-        <para>
-          You might get undefined reference errors at runtime when you
-          try to execute a MySQL program. If these errors specify
-          symbols that start with <literal>mysql_</literal> or indicate
-          that the <literal>mysqlclient</literal> library can't be
-          found, it means that your system can't find the shared
-          <filename>libmysqlclient.so</filename> library. The fix for
-          this is to tell your system to search for shared libraries
-          where the library is located. Use whichever of the following
-          methods is appropriate for your system:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY_PATH</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Copy <filename>libmysqlclient.so</filename> to some
-              directory that is searched by your system, such as
-              <filename>/lib</filename>, and update the shared library
-              information by executing <literal>ldconfig</literal>.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-      </section>
-
       <section id="file-permissions">
 
         <title>Problems with File Permissions</title>


Modified: trunk/refman-6.0/apis-c.xml
===================================================================
--- trunk/refman-6.0/apis-c.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-6.0/apis-c.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes

@@ -15284,18 +15284,33 @@
 
     <section id="c-api-linking-problems">
 
-      <title>Problems Linking with the C API</title>
+      <title>Problems Linking to the MySQL Client Library</title>
 
       <indexterm>
+        <primary>C API</primary>
+        <secondary>linking problems</secondary>
+      </indexterm>
+
+      <indexterm>
         <primary>linking</primary>
-        <secondary>problems</secondary>
+        <secondary>errors</secondary>
       </indexterm>
 
       <indexterm>
-        <primary>C API</primary>
-        <secondary>linking problems</secondary>
+        <primary>errors</primary>
+        <secondary>linking</secondary>
       </indexterm>
 
+      <indexterm>
+        <primary>problems</primary>
+        <secondary>linking</secondary>
+      </indexterm>
+
+      <indexterm>
+        <primary>linking</primary>
+        <secondary>problems</secondary>
+      </indexterm>
+
       <para>
         When linking with the C API, the following errors may occur on
         some systems:

@@ -15330,6 +15345,121 @@
         (<literal>libmysqlclient_r</literal>).
       </para>
 
+      <para>
+        When you are linking an application program to use the MySQL
+        client library, you might get undefined reference errors for
+        symbols that start with <literal>mysql_</literal>, such as those
+        shown here:
+      </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+      <para>
+        You should be able to solve this problem by adding
+        <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+        link command, where <literal>dir_path</literal> represents the
+        path name of the directory where the client library is located.
+        To determine the correct directory, try this command:
+      </para>
+
+<programlisting>
+shell&gt; <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+      <para>
+        The output from <command>mysql_config</command> might indicate
+        other libraries that should be specified on the link command as
+        well.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for the
+        <literal>uncompress</literal> or <literal>compress</literal>
+        function, add <literal>-lz</literal> to the end of your link
+        command and try again.
+      </para>
+
+      <para>
+        If you get <literal>undefined reference</literal> errors for a
+        function that should exist on your system, such as
+        <literal>connect</literal>, check the manual page for the
+        function in question to determine which libraries you should add
+        to the link command.
+      </para>
+
+      <para>
+        You might get <literal>undefined reference</literal> errors such
+        as the following for functions that don't exist on your system:
+      </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+      <para>
+        This usually means that your MySQL client library was compiled
+        on a system that is not 100% compatible with yours. In this
+        case, you should download the latest MySQL source distribution
+        and compile MySQL yourself. See
+        <xref linkend="source-installation"/>.
+      </para>
+
+      <para>
+        You might get undefined reference errors at runtime when you try
+        to execute a MySQL program. If these errors specify symbols that
+        start with <literal>mysql_</literal> or indicate that the
+        <literal>mysqlclient</literal> library can't be found, it means
+        that your system can't find the shared
+        <filename>libmysqlclient.so</filename> library. The fix for this
+        is to tell your system to search for shared libraries where the
+        library is located. Use whichever of the following methods is
+        appropriate for your system:
+      </para>
+
+      <itemizedlist>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY_PATH</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Add the path to the directory where
+            <filename>libmysqlclient.so</filename> is located to the
+            <literal>LD_LIBRARY</literal> environment variable.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Copy <filename>libmysqlclient.so</filename> to some
+            directory that is searched by your system, such as
+            <filename>/lib</filename>, and update the shared library
+            information by executing <literal>ldconfig</literal>.
+          </para>
+        </listitem>
+
+      </itemizedlist>
+
+      <para>
+        Another way to solve this problem is by linking your program
+        statically with the <literal>-static</literal> option, or by
+        removing the dynamic MySQL libraries before linking your code.
+        Before trying the second method, you should be sure that no
+        other programs are using the dynamic libraries.
+      </para>
+
     </section>
 
     <section id="threaded-clients">


Modified: trunk/refman-6.0/errors-problems.xml
===================================================================
--- trunk/refman-6.0/errors-problems.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-6.0/errors-problems.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 4, Lines Deleted: 141; 5989 bytes

@@ -1394,9 +1394,10 @@
 
         <para>
           Increasing <option role="mysqld">open-files-limit</option> may
-          be necessary. Also see <xref linkend="linux-postinstallation"/>,
-          for how to raise the operating system limit on how many
-          handles can be used by MySQL.
+          be necessary. Also see
+          <xref linkend="linux-postinstallation"/>, for how to raise the
+          operating system limit on how many handles can be used by
+          MySQL.
         </para>
 
       </section>

@@ -2706,144 +2707,6 @@
 
       <title>Installation-Related Issues</title>
 
-      <section id="link-errors">
-
-        <title>Problems Linking to the MySQL Client Library</title>
-
-        <indexterm>
-          <primary>linking</primary>
-          <secondary>errors</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>errors</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <indexterm>
-          <primary>problems</primary>
-          <secondary>linking</secondary>
-        </indexterm>
-
-        <para>
-          When you are linking an application program to use the MySQL
-          client library, you might get undefined reference errors for
-          symbols that start with <literal>mysql_</literal>, such as
-          those shown here:
-        </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
-        <para>
-          You should be able to solve this problem by adding
-          <literal>-Ldir_path -lmysqlclient</literal> at the end of your
-          link command, where <literal>dir_path</literal> represents the
-          path name of the directory where the client library is
-          located. To determine the correct directory, try this command:
-        </para>
-
-<programlisting>
-shell&gt; <userinput>mysql_config --libs</userinput>
-</programlisting>
-
-        <para>
-          The output from <command>mysql_config</command> might indicate
-          other libraries that should be specified on the link command
-          as well.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for
-          the <literal>uncompress</literal> or
-          <literal>compress</literal> function, add
-          <literal>-lz</literal> to the end of your link command and try
-          again.
-        </para>
-
-        <para>
-          If you get <literal>undefined reference</literal> errors for a
-          function that should exist on your system, such as
-          <literal>connect</literal>, check the manual page for the
-          function in question to determine which libraries you should
-          add to the link command.
-        </para>
-
-        <para>
-          You might get <literal>undefined reference</literal> errors
-          such as the following for functions that don't exist on your
-          system:
-        </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
-        <para>
-          This usually means that your MySQL client library was compiled
-          on a system that is not 100% compatible with yours. In this
-          case, you should download the latest MySQL source distribution
-          and compile MySQL yourself. See
-          <xref linkend="source-installation"/>.
-        </para>
-
-        <para>
-          You might get undefined reference errors at runtime when you
-          try to execute a MySQL program. If these errors specify
-          symbols that start with <literal>mysql_</literal> or indicate
-          that the <literal>mysqlclient</literal> library can't be
-          found, it means that your system can't find the shared
-          <filename>libmysqlclient.so</filename> library. The fix for
-          this is to tell your system to search for shared libraries
-          where the library is located. Use whichever of the following
-          methods is appropriate for your system:
-        </para>
-
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY_PATH</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Add the path to the directory where
-              <filename>libmysqlclient.so</filename> is located to the
-              <literal>LD_LIBRARY</literal> environment variable.
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Copy <filename>libmysqlclient.so</filename> to some
-              directory that is searched by your system, such as
-              <filename>/lib</filename>, and update the shared library
-              information by executing <literal>ldconfig</literal>.
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
-        <para>
-          Another way to solve this problem is by linking your program
-          statically with the <literal>-static</literal> option, or by
-          removing the dynamic MySQL libraries before linking your code.
-          Before trying the second method, you should be sure that no
-          other programs are using the dynamic libraries.
-        </para>
-
-      </section>
-
       <section id="file-permissions">
 
         <title>Problems with File Permissions</title>


Modified: trunk/refman-6.0/installing.xml
===================================================================
--- trunk/refman-6.0/installing.xml	2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-6.0/installing.xml	2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 1; 438 bytes

@@ -2161,7 +2161,7 @@
         </para>
 
         <para>
-          See <xref linkend="link-errors"/>.
+          See <xref linkend="c-api-linking-problems"/>.
         </para>
 
       </section>


Thread
svn commit - mysqldoc@docsrva: r24350 - in trunk: . refman-4.1 refman-5.0 refman-5.1 refman-5.5 refman-5.6 refman-6.0paul.dubois9 Dec