Author: paul
Date: 2007-10-04 21:18:00 +0200 (Thu, 04 Oct 2007)
New Revision: 7973
Log:
r30686@polar: paul | 2007-10-04 14:15:49 -0500
Update libmysqld compilation section with current info. (Kent)
Modified:
trunk/refman-4.1/apis.xml
trunk/refman-5.1/apis-libmysqld.xml
trunk/refman-5.2/apis-libmysqld.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:30683
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:25316
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:20005
+ 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:30686
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:25316
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:20005
Modified: trunk/refman-4.1/apis.xml
===================================================================
--- trunk/refman-4.1/apis.xml 2007-10-04 18:25:50 UTC (rev 7972)
+++ trunk/refman-4.1/apis.xml 2007-10-04 19:18:00 UTC (rev 7973)
Changed blocks: 4, Lines Added: 29, Lines Deleted: 13; 3468 bytes
@@ -155,12 +155,20 @@
<title>Compiling Programs with <literal>libmysqld</literal></title>
<para>
- To get a <literal>libmysqld</literal> library you should
- configure MySQL with the <option>--with-embedded-server</option>
- option. See <xref linkend="configure-options"/>.
+ In precompiled binary MySQL distributions that include
+ <literal>libmysqld</literal>, the embedded server library, MySQL
+ builds the library using the appropriate vendor compiler if
+ there is one.
</para>
<para>
+ To get a <literal>libmysqld</literal> library if you build MySQL
+ from source yourself, you should configure MySQL with the
+ <option>--with-embedded-server</option> option. See
+ <xref linkend="configure-options"/>.
+ </para>
+
+ <para>
When you link your program with <literal>libmysqld</literal>,
you must also include the system-specific
<literal>pthread</literal> libraries and some libraries that the
@@ -176,12 +184,12 @@
<para>
To compile a C program to include the necessary files to embed
- the MySQL server library into a compiled version of a program,
- use the GNU C compiler (<literal>gcc</literal>). The compiler
- will need to know where to find various files and need
- instructions on how to compile the program. The following
- example shows how a program could be compiled from the command
- line:
+ the MySQL server library into an executable version of a
+ program, the compiler will need to know where to find various
+ files and need instructions on how to compile the program. The
+ following example shows how a program could be compiled from the
+ command line, assuming that you are using
+ <command>gcc</command>, use the GNU C compiler:
</para>
<programlisting>
@@ -190,8 +198,8 @@
</programlisting>
<para>
- Immediately following the <literal>gcc</literal> command is the
- name of the uncompiled C program file. After it, the
+ Immediately following the <command>gcc</command> command is the
+ name of the C program source file. After it, the
<option>-o</option> option is given to indicate that the file
name that follows is the name that the compiler is to give to
the output file, the compiled program. The next line of code
@@ -200,10 +208,18 @@
compiled. Because of a problem with
<command>mysql_config</command>, the option <option>-lz</option>
(for compression) is added here. The
- <command>mysql_config</command> piece is contained in backticks,
- not single quotes.
+ <command>mysql_config</command> command is contained in
+ backticks, not single quotes.
</para>
+ <para>
+ On some non-<command>gcc</command> platforms, the embedded
+ library depends on C++ runtime libraries and linking against the
+ embedded library might result in missing-symbol errors. To solve
+ this, link using a C++ compiler or explicitly list the required
+ libraries on the link command line.
+ </para>
+
</section>
<section id="libmysqld-restrictions">
Modified: trunk/refman-5.1/apis-libmysqld.xml
===================================================================
--- trunk/refman-5.1/apis-libmysqld.xml 2007-10-04 18:25:50 UTC (rev 7972)
+++ trunk/refman-5.1/apis-libmysqld.xml 2007-10-04 19:18:00 UTC (rev 7973)
Changed blocks: 4, Lines Added: 27, Lines Deleted: 10; 3159 bytes
@@ -110,8 +110,16 @@
<title>Compiling Programs with <literal>libmysqld</literal></title>
<para>
- To get a <literal>libmysqld</literal> library you should configure
- MySQL with the <option>--with-embedded-server</option> option. See
+ In precompiled binary MySQL distributions that include
+ <literal>libmysqld</literal>, the embedded server library, MySQL
+ builds the library using the appropriate vendor compiler if there
+ is one.
+ </para>
+
+ <para>
+ To get a <literal>libmysqld</literal> library if you build MySQL
+ from source yourself, you should configure MySQL with the
+ <option>--with-embedded-server</option> option. See
<xref linkend="configure-options"/>.
</para>
@@ -131,11 +139,12 @@
<para>
To compile a C program to include the necessary files to embed the
- MySQL server library into a compiled version of a program, use the
- GNU C compiler (<literal>gcc</literal>). The compiler will need to
- know where to find various files and need instructions on how to
- compile the program. The following example shows how a program
- could be compiled from the command line:
+ MySQL server library into an executable version of a program, the
+ compiler will need to know where to find various files and need
+ instructions on how to compile the program. The following example
+ shows how a program could be compiled from the command line,
+ assuming that you are using <command>gcc</command>, use the GNU C
+ compiler:
</para>
<programlisting>
@@ -144,8 +153,8 @@
</programlisting>
<para>
- Immediately following the <literal>gcc</literal> command is the
- name of the uncompiled C program file. After it, the
+ Immediately following the <command>gcc</command> command is the
+ name of the C program source file. After it, the
<option>-o</option> option is given to indicate that the file name
that follows is the name that the compiler is to give to the
output file, the compiled program. The next line of code tells the
@@ -153,10 +162,18 @@
and other settings for the system on which it's compiled. Because
of a problem with <command>mysql_config</command>, the option
<option>-lz</option> (for compression) is added here. The
- <command>mysql_config</command> piece is contained in backticks,
+ <command>mysql_config</command> command is contained in backticks,
not single quotes.
</para>
+ <para>
+ On some non-<command>gcc</command> platforms, the embedded library
+ depends on C++ runtime libraries and linking against the embedded
+ library might result in missing-symbol errors. To solve this, link
+ using a C++ compiler or explicitly list the required libraries on
+ the link command line.
+ </para>
+
</section>
<section id="libmysqld-restrictions">
Modified: trunk/refman-5.2/apis-libmysqld.xml
===================================================================
--- trunk/refman-5.2/apis-libmysqld.xml 2007-10-04 18:25:50 UTC (rev 7972)
+++ trunk/refman-5.2/apis-libmysqld.xml 2007-10-04 19:18:00 UTC (rev 7973)
Changed blocks: 4, Lines Added: 27, Lines Deleted: 10; 3159 bytes
@@ -110,8 +110,16 @@
<title>Compiling Programs with <literal>libmysqld</literal></title>
<para>
- To get a <literal>libmysqld</literal> library you should configure
- MySQL with the <option>--with-embedded-server</option> option. See
+ In precompiled binary MySQL distributions that include
+ <literal>libmysqld</literal>, the embedded server library, MySQL
+ builds the library using the appropriate vendor compiler if there
+ is one.
+ </para>
+
+ <para>
+ To get a <literal>libmysqld</literal> library if you build MySQL
+ from source yourself, you should configure MySQL with the
+ <option>--with-embedded-server</option> option. See
<xref linkend="configure-options"/>.
</para>
@@ -131,11 +139,12 @@
<para>
To compile a C program to include the necessary files to embed the
- MySQL server library into a compiled version of a program, use the
- GNU C compiler (<literal>gcc</literal>). The compiler will need to
- know where to find various files and need instructions on how to
- compile the program. The following example shows how a program
- could be compiled from the command line:
+ MySQL server library into an executable version of a program, the
+ compiler will need to know where to find various files and need
+ instructions on how to compile the program. The following example
+ shows how a program could be compiled from the command line,
+ assuming that you are using <command>gcc</command>, use the GNU C
+ compiler:
</para>
<programlisting>
@@ -144,8 +153,8 @@
</programlisting>
<para>
- Immediately following the <literal>gcc</literal> command is the
- name of the uncompiled C program file. After it, the
+ Immediately following the <command>gcc</command> command is the
+ name of the C program source file. After it, the
<option>-o</option> option is given to indicate that the file name
that follows is the name that the compiler is to give to the
output file, the compiled program. The next line of code tells the
@@ -153,10 +162,18 @@
and other settings for the system on which it's compiled. Because
of a problem with <command>mysql_config</command>, the option
<option>-lz</option> (for compression) is added here. The
- <command>mysql_config</command> piece is contained in backticks,
+ <command>mysql_config</command> command is contained in backticks,
not single quotes.
</para>
+ <para>
+ On some non-<command>gcc</command> platforms, the embedded library
+ depends on C++ runtime libraries and linking against the embedded
+ library might result in missing-symbol errors. To solve this, link
+ using a C++ compiler or explicitly list the required libraries on
+ the link command line.
+ </para>
+
</section>
<section id="libmysqld-restrictions">
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r7973 - in trunk: . refman-4.1 refman-5.1 refman-5.2 | paul | 4 Oct |
