List:Internals« Previous MessageNext Message »
From:paul Date:August 10 2005 3:12pm
Subject:bk commit - mysqldoc@docsrva tree (paul:1.3228)
View as plain text  
Below is the list of changes that have just been committed into a local
mysqldoc repository of paul. When paul does a push these changes will
be propagated to the main repository and, within 24 hours after the
push, to the public repository.
For information on how to access the public repository
see http://www.mysql.com/doc/I/n/Installing_source_tree.html

ChangeSet
  1.3228 05/08/10 10:12:00 paul@stripped +4 -0
  manpage markup

  refman/mysql-apis.xml
    1.28 05/08/10 10:11:57 paul@stripped +122 -134
    manpage markup

  refman-5.1/mysql-apis.xml
    1.7 05/08/10 10:11:56 paul@stripped +84 -77
    Sync.

  refman-5.0/mysql-apis.xml
    1.7 05/08/10 10:11:55 paul@stripped +84 -77
    Sync.

  refman-4.1/mysql-apis.xml
    1.24 05/08/10 10:11:55 paul@stripped +84 -77
    Sync.

  refman/mysql-apis.xml
    1.27 05/08/10 09:54:58 paul@stripped +2 -2
    manpage markup

  refman-5.1/mysql-apis.xml
    1.6 05/08/10 09:54:54 paul@stripped +2 -2
    manpage markup

  refman-5.0/mysql-apis.xml
    1.6 05/08/10 09:54:51 paul@stripped +2 -2
    manpage markup

  refman-4.1/mysql-apis.xml
    1.23 05/08/10 09:54:44 paul@stripped +2 -2
    manpage markup

# This is a BitKeeper patch.  What follows are the unified diffs for the
# set of deltas contained in the patch.  The rest of the patch, the part
# that BitKeeper cares about, is below these diffs.
# User:	paul
# Host:	frost.snake.net
# Root:	/Volumes/frost2/MySQL/bk/mysqldoc

--- 1.5/refman-5.1/mysql-apis.xml	2005-08-09 11:01:07 -05:00
+++ 1.7/refman-5.1/mysql-apis.xml	2005-08-10 10:11:56 -05:00
@@ -87,48 +87,52 @@
 
     </itemizedlist>
 
-    <refentry id="msql2mysql">
+    <section id="fake-id-for-msql2mysql-manpage-section-wrapper">
 
-      <indexterm type="concept">
-        <primary><command>msql2mysql</command></primary>
-      </indexterm>
-
-      <refmeta>
-        <refentrytitle>msql2mysql</refentrytitle>
-        <manvolnum>man</manvolnum>
-        <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
-      </refmeta>
-
-      <refnamediv>
-        <refname>msql2mysql</refname>
-        <refpurpose>convert mSQL programs for use with MySQL</refpurpose>
-      </refnamediv>
-
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>msql2mysql<replaceable>C-source-file</replaceable> &hellip;</command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
+      <title>fake title for msql2mysql manpage section wrapper</title>
 
-      <refsection id="msql2mysql-description">
+      <refentry id="msql2mysql">
 
-        <title>Description</title>
-
-        <para>
-          Initially, the MySQL C API was developed to be very similar to
-          that for the mSQL database system. Because of this, mSQL
-          programs often can be converted relatively easily for use with
-          MySQL by changing the names of the C API functions.
-        </para>
-
-        <para>
-          The <command>msql2mysql</command> utility performs the
-          conversion of mSQL C API function calls to their MySQL
-          equivalents. <command>msql2mysql</command> converts the input
-          file in place, so make a copy of the original before
-          converting it. For example, use <command>msql2mysql</command>
-          like this:
-        </para>
+        <indexterm type="concept">
+          <primary><command>msql2mysql</command></primary>
+        </indexterm>
+
+        <refmeta>
+          <refentrytitle>msql2mysql</refentrytitle>
+          <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
+          <manvolnum>man</manvolnum>
+        </refmeta>
+
+        <refnamediv>
+          <refname>msql2mysql</refname>
+          <refpurpose>convert mSQL programs for use with MySQL</refpurpose>
+        </refnamediv>
+
+        <refsynopsisdiv>
+          <cmdsynopsis>
+            <command>msql2mysql<replaceable>C-source-file</replaceable> &hellip;</command>
+          </cmdsynopsis>
+        </refsynopsisdiv>
+
+        <refsection id="msql2mysql-description">
+
+          <title>Description</title>
+
+          <para>
+            Initially, the MySQL C API was developed to be very similar
+            to that for the mSQL database system. Because of this, mSQL
+            programs often can be converted relatively easily for use
+            with MySQL by changing the names of the C API functions.
+          </para>
+
+          <para>
+            The <command>msql2mysql</command> utility performs the
+            conversion of mSQL C API function calls to their MySQL
+            equivalents. <command>msql2mysql</command> converts the
+            input file in place, so make a copy of the original before
+            converting it. For example, use
+            <command>msql2mysql</command> like this:
+          </para>
 
 <programlisting>
 shell&gt; <userinput>cp client-prog.c client-prog.c.orig</userinput>
@@ -136,47 +140,49 @@
 client-prog.c converted
 </programlisting>
 
-        <para>
-          Then examine <filename>client-prog.c</filename> and make any
-          post-conversion revisions that may be necessary.
-        </para>
+          <para>
+            Then examine <filename>client-prog.c</filename> and make any
+            post-conversion revisions that may be necessary.
+          </para>
 
-        <para>
-          <command>msql2mysql</command> uses the
-          <command>replace</command> utility to make the function name
-          substitutions. See <xref linkend="replace-utility"/>.
-        </para>
+          <para>
+            <command>msql2mysql</command> uses the
+            <command>replace</command> utility to make the function name
+            substitutions. See <xref linkend="replace-utility"/>.
+          </para>
+
+        </refsection>
 
-      </refsection>
+      </refentry>
 
-    </refentry>
+    </section>
 
-    <refentry id="mysql-config">
+    <section id="fake-id-for-mysql-config-manpage-section-wrapper">
 
-      <indexterm type="concept">
-        <primary><command>mysql_config</command></primary>
-      </indexterm>
+      <title>fake title for mysql-config manpage section wrapper</title>
 
-      <refmeta>
-        <refentrytitle>mysql_config</refentrytitle>
-        <manvolnum>man</manvolnum>
-        <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
-      </refmeta>
+      <refentry id="mysql-config">
 
-      <refnamediv>
-        <refname>mysql_config</refname>
-        <refpurpose>get compile options for compiling clients</refpurpose>
-      </refnamediv>
+        <indexterm type="concept">
+          <primary><command>mysql_config</command></primary>
+        </indexterm>
 
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>mysql_config <replaceable>options</replaceable></command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
+        <refmeta>
+          <refentrytitle>mysql_config</refentrytitle>
+          <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
+          <manvolnum>man</manvolnum>
+        </refmeta>
 
-      <refsection id="mysql-config-description">
+        <refnamediv>
+          <refname>mysql_config</refname>
+          <refpurpose>get compile options for compiling clients</refpurpose>
+        </refnamediv>
 
-        <title>Description</title>
+        <refsynopsisdiv>
+          <cmdsynopsis>
+            <command>mysql_config <replaceable>options</replaceable></command>
+          </cmdsynopsis>
+        </refsynopsisdiv>
 
         <para>
           <command>mysql_config</command> provides you with useful
@@ -325,9 +331,9 @@
           its output into the surrounding command.
         </para>
 
-      </refsection>
+      </refentry>
 
-    </refentry>
+    </section>
 
   </section>
 
@@ -360,11 +366,12 @@
     </para>
 
     <para>
-      Most of the other client APIs (all except Connector/J) use the
-      <literal>mysqlclient</literal> library to communicate with the
-      MySQL server. This means that, for example, you can take advantage
-      of many of the same environment variables that are used by other
-      client programs, because they are referenced from the library. See
+      Most of the other client APIs (all except Connector/J and
+      Connector/NET) use the <literal>mysqlclient</literal> library to
+      communicate with the MySQL server. This means that, for example,
+      you can take advantage of many of the same environment variables
+      that are used by other client programs, because they are
+      referenced from the library. See
       <xref linkend="client-side-scripts"/>, for a list of these
       variables.
     </para>

--- 1.22/refman-4.1/mysql-apis.xml	2005-08-09 11:01:07 -05:00
+++ 1.24/refman-4.1/mysql-apis.xml	2005-08-10 10:11:55 -05:00
@@ -87,48 +87,52 @@
 
     </itemizedlist>
 
-    <refentry id="msql2mysql">
+    <section id="fake-id-for-msql2mysql-manpage-section-wrapper">
 
-      <indexterm type="concept">
-        <primary><command>msql2mysql</command></primary>
-      </indexterm>
-
-      <refmeta>
-        <refentrytitle>msql2mysql</refentrytitle>
-        <manvolnum>man</manvolnum>
-        <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
-      </refmeta>
-
-      <refnamediv>
-        <refname>msql2mysql</refname>
-        <refpurpose>convert mSQL programs for use with MySQL</refpurpose>
-      </refnamediv>
-
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>msql2mysql<replaceable>C-source-file</replaceable> &hellip;</command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
+      <title>fake title for msql2mysql manpage section wrapper</title>
 
-      <refsection id="msql2mysql-description">
+      <refentry id="msql2mysql">
 
-        <title>Description</title>
-
-        <para>
-          Initially, the MySQL C API was developed to be very similar to
-          that for the mSQL database system. Because of this, mSQL
-          programs often can be converted relatively easily for use with
-          MySQL by changing the names of the C API functions.
-        </para>
-
-        <para>
-          The <command>msql2mysql</command> utility performs the
-          conversion of mSQL C API function calls to their MySQL
-          equivalents. <command>msql2mysql</command> converts the input
-          file in place, so make a copy of the original before
-          converting it. For example, use <command>msql2mysql</command>
-          like this:
-        </para>
+        <indexterm type="concept">
+          <primary><command>msql2mysql</command></primary>
+        </indexterm>
+
+        <refmeta>
+          <refentrytitle>msql2mysql</refentrytitle>
+          <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
+          <manvolnum>man</manvolnum>
+        </refmeta>
+
+        <refnamediv>
+          <refname>msql2mysql</refname>
+          <refpurpose>convert mSQL programs for use with MySQL</refpurpose>
+        </refnamediv>
+
+        <refsynopsisdiv>
+          <cmdsynopsis>
+            <command>msql2mysql<replaceable>C-source-file</replaceable> &hellip;</command>
+          </cmdsynopsis>
+        </refsynopsisdiv>
+
+        <refsection id="msql2mysql-description">
+
+          <title>Description</title>
+
+          <para>
+            Initially, the MySQL C API was developed to be very similar
+            to that for the mSQL database system. Because of this, mSQL
+            programs often can be converted relatively easily for use
+            with MySQL by changing the names of the C API functions.
+          </para>
+
+          <para>
+            The <command>msql2mysql</command> utility performs the
+            conversion of mSQL C API function calls to their MySQL
+            equivalents. <command>msql2mysql</command> converts the
+            input file in place, so make a copy of the original before
+            converting it. For example, use
+            <command>msql2mysql</command> like this:
+          </para>
 
 <programlisting>
 shell&gt; <userinput>cp client-prog.c client-prog.c.orig</userinput>
@@ -136,47 +140,49 @@
 client-prog.c converted
 </programlisting>
 
-        <para>
-          Then examine <filename>client-prog.c</filename> and make any
-          post-conversion revisions that may be necessary.
-        </para>
+          <para>
+            Then examine <filename>client-prog.c</filename> and make any
+            post-conversion revisions that may be necessary.
+          </para>
 
-        <para>
-          <command>msql2mysql</command> uses the
-          <command>replace</command> utility to make the function name
-          substitutions. See <xref linkend="replace-utility"/>.
-        </para>
+          <para>
+            <command>msql2mysql</command> uses the
+            <command>replace</command> utility to make the function name
+            substitutions. See <xref linkend="replace-utility"/>.
+          </para>
+
+        </refsection>
 
-      </refsection>
+      </refentry>
 
-    </refentry>
+    </section>
 
-    <refentry id="mysql-config">
+    <section id="fake-id-for-mysql-config-manpage-section-wrapper">
 
-      <indexterm type="concept">
-        <primary><command>mysql_config</command></primary>
-      </indexterm>
+      <title>fake title for mysql-config manpage section wrapper</title>
 
-      <refmeta>
-        <refentrytitle>mysql_config</refentrytitle>
-        <manvolnum>man</manvolnum>
-        <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
-      </refmeta>
+      <refentry id="mysql-config">
 
-      <refnamediv>
-        <refname>mysql_config</refname>
-        <refpurpose>get compile options for compiling clients</refpurpose>
-      </refnamediv>
+        <indexterm type="concept">
+          <primary><command>mysql_config</command></primary>
+        </indexterm>
 
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>mysql_config <replaceable>options</replaceable></command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
+        <refmeta>
+          <refentrytitle>mysql_config</refentrytitle>
+          <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
+          <manvolnum>man</manvolnum>
+        </refmeta>
 
-      <refsection id="mysql-config-description">
+        <refnamediv>
+          <refname>mysql_config</refname>
+          <refpurpose>get compile options for compiling clients</refpurpose>
+        </refnamediv>
 
-        <title>Description</title>
+        <refsynopsisdiv>
+          <cmdsynopsis>
+            <command>mysql_config <replaceable>options</replaceable></command>
+          </cmdsynopsis>
+        </refsynopsisdiv>
 
         <para>
           <command>mysql_config</command> provides you with useful
@@ -325,9 +331,9 @@
           its output into the surrounding command.
         </para>
 
-      </refsection>
+      </refentry>
 
-    </refentry>
+    </section>
 
   </section>
 
@@ -360,11 +366,12 @@
     </para>
 
     <para>
-      Most of the other client APIs (all except Connector/J) use the
-      <literal>mysqlclient</literal> library to communicate with the
-      MySQL server. This means that, for example, you can take advantage
-      of many of the same environment variables that are used by other
-      client programs, because they are referenced from the library. See
+      Most of the other client APIs (all except Connector/J and
+      Connector/NET) use the <literal>mysqlclient</literal> library to
+      communicate with the MySQL server. This means that, for example,
+      you can take advantage of many of the same environment variables
+      that are used by other client programs, because they are
+      referenced from the library. See
       <xref linkend="client-side-scripts"/>, for a list of these
       variables.
     </para>

--- 1.26/refman/mysql-apis.xml	2005-08-09 11:01:08 -05:00
+++ 1.28/refman/mysql-apis.xml	2005-08-10 10:11:57 -05:00
@@ -99,8 +99,8 @@
 
         <refmeta>
           <refentrytitle>msql2mysql</refentrytitle>
-          <manvolnum>man</manvolnum>
           <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
+          <manvolnum>man</manvolnum>
         </refmeta>
 
         <refnamediv>
@@ -169,8 +169,8 @@
 
         <refmeta>
           <refentrytitle>mysql_config</refentrytitle>
-          <manvolnum>man</manvolnum>
           <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
+          <manvolnum>man</manvolnum>
         </refmeta>
 
         <refnamediv>
@@ -184,126 +184,116 @@
           </cmdsynopsis>
         </refsynopsisdiv>
 
-        <refsection id="mysql-config-description">
-
-          <title>Description</title>
-
-          <para>
-            <command>mysql_config</command> provides you with useful
-            information for compiling your MySQL client and connecting
-            it to MySQL.
-          </para>
-
-        </refsection>
-
-        <refsection id="mysql-config-options">
-
-          <title>Options</title>
-
-          <para>
-            <command>mysql_config</command> supports the following
-            options:
-          </para>
-
-          <itemizedlist>
-
-            <listitem>
-              <para>
-                <option>--cflags</option>
-              </para>
-
-              <para>
-                Compiler flags to find include files and critical
-                compiler flags and defines used when compiling the
-                <literal>libmysqlclient</literal> library.
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--include</option>
-              </para>
-
-              <para>
-                Compiler options to find MySQL include files. (Note that
-                normally you would use <option>--cflags</option> instead
-                of this option.)
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--libmysqld-libs</option>,
-                <option>---embedded</option>
-              </para>
-
-              <para>
-                Libraries and options required to link with the MySQL
-                embedded server.
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--libs</option>
-              </para>
-
-              <para>
-                Libraries and options required to link with the MySQL
-                client library.
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--libs_r</option>
-              </para>
-
-              <para>
-                Libraries and options required to link with the
-                thread-safe MySQL client library.
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--port</option>
-              </para>
-
-              <para>
-                The default TCP/IP port number, defined when configuring
-                MySQL.
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--socket</option>
-              </para>
-
-              <para>
-                The default Unix socket file, defined when configuring
-                MySQL.
-              </para>
-            </listitem>
-
-            <listitem>
-              <para>
-                <option>--version</option>
-              </para>
-
-              <para>
-                Version number and version for the MySQL distribution.
-              </para>
-            </listitem>
-
-          </itemizedlist>
-
-          <para>
-            If you invoke <command>mysql_config</command> with no
-            options, it displays a list of all options that it supports,
-            and their values:
-          </para>
+        <para>
+          <command>mysql_config</command> provides you with useful
+          information for compiling your MySQL client and connecting it
+          to MySQL.
+        </para>
+
+        <para>
+          <command>mysql_config</command> supports the following
+          options:
+        </para>
+
+        <itemizedlist>
+
+          <listitem>
+            <para>
+              <option>--cflags</option>
+            </para>
+
+            <para>
+              Compiler flags to find include files and critical compiler
+              flags and defines used when compiling the
+              <literal>libmysqlclient</literal> library.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--include</option>
+            </para>
+
+            <para>
+              Compiler options to find MySQL include files. (Note that
+              normally you would use <option>--cflags</option> instead
+              of this option.)
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--libmysqld-libs</option>,
+              <option>---embedded</option>
+            </para>
+
+            <para>
+              Libraries and options required to link with the MySQL
+              embedded server.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--libs</option>
+            </para>
+
+            <para>
+              Libraries and options required to link with the MySQL
+              client library.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--libs_r</option>
+            </para>
+
+            <para>
+              Libraries and options required to link with the
+              thread-safe MySQL client library.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--port</option>
+            </para>
+
+            <para>
+              The default TCP/IP port number, defined when configuring
+              MySQL.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--socket</option>
+            </para>
+
+            <para>
+              The default Unix socket file, defined when configuring
+              MySQL.
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <option>--version</option>
+            </para>
+
+            <para>
+              Version number and version for the MySQL distribution.
+            </para>
+          </listitem>
+
+        </itemizedlist>
+
+        <para>
+          If you invoke <command>mysql_config</command> with no options,
+          it displays a list of all options that it supports, and their
+          values:
+        </para>
 
 <programlisting>
 shell&gt; <userinput>mysql_config</userinput>
@@ -322,26 +312,24 @@
                     -lcrypt -lnsl -lm -lpthread -lrt]
 </programlisting>
 
-          <para>
-            You can use <command>mysql_config</command> within a command
-            line to include the value that it displays for a particular
-            option. For example, to compile a MySQL client program, use
-            <command>mysql_config</command> as follows:
-          </para>
+        <para>
+          You can use <command>mysql_config</command> within a command
+          line to include the value that it displays for a particular
+          option. For example, to compile a MySQL client program, use
+          <command>mysql_config</command> as follows:
+        </para>
 
 <programlisting>
 shell&gt; <userinput>CFG=/usr/local/mysql/bin/mysql_config</userinput>
 shell&gt; <userinput>sh -c "gcc -o progname `$CFG --cflags` progname.c `$CFG --libs`"</userinput>
 </programlisting>
 
-          <para>
-            When you use <command>mysql_config</command> this way, be
-            sure to invoke it within backtick ('<literal>`</literal>')
-            characters. That tells the shell to execute it and
-            substitute its output into the surrounding command.
-          </para>
-
-        </refsection>
+        <para>
+          When you use <command>mysql_config</command> this way, be sure
+          to invoke it within backtick ('<literal>`</literal>')
+          characters. That tells the shell to execute it and substitute
+          its output into the surrounding command.
+        </para>
 
       </refentry>
 

--- 1.5/refman-5.0/mysql-apis.xml	2005-08-09 11:01:07 -05:00
+++ 1.7/refman-5.0/mysql-apis.xml	2005-08-10 10:11:55 -05:00
@@ -87,48 +87,52 @@
 
     </itemizedlist>
 
-    <refentry id="msql2mysql">
+    <section id="fake-id-for-msql2mysql-manpage-section-wrapper">
 
-      <indexterm type="concept">
-        <primary><command>msql2mysql</command></primary>
-      </indexterm>
-
-      <refmeta>
-        <refentrytitle>msql2mysql</refentrytitle>
-        <manvolnum>man</manvolnum>
-        <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
-      </refmeta>
-
-      <refnamediv>
-        <refname>msql2mysql</refname>
-        <refpurpose>convert mSQL programs for use with MySQL</refpurpose>
-      </refnamediv>
-
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>msql2mysql<replaceable>C-source-file</replaceable> &hellip;</command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
+      <title>fake title for msql2mysql manpage section wrapper</title>
 
-      <refsection id="msql2mysql-description">
+      <refentry id="msql2mysql">
 
-        <title>Description</title>
-
-        <para>
-          Initially, the MySQL C API was developed to be very similar to
-          that for the mSQL database system. Because of this, mSQL
-          programs often can be converted relatively easily for use with
-          MySQL by changing the names of the C API functions.
-        </para>
-
-        <para>
-          The <command>msql2mysql</command> utility performs the
-          conversion of mSQL C API function calls to their MySQL
-          equivalents. <command>msql2mysql</command> converts the input
-          file in place, so make a copy of the original before
-          converting it. For example, use <command>msql2mysql</command>
-          like this:
-        </para>
+        <indexterm type="concept">
+          <primary><command>msql2mysql</command></primary>
+        </indexterm>
+
+        <refmeta>
+          <refentrytitle>msql2mysql</refentrytitle>
+          <refmiscinfo>Convert mSQL Programs for Use with MySQL</refmiscinfo>
+          <manvolnum>man</manvolnum>
+        </refmeta>
+
+        <refnamediv>
+          <refname>msql2mysql</refname>
+          <refpurpose>convert mSQL programs for use with MySQL</refpurpose>
+        </refnamediv>
+
+        <refsynopsisdiv>
+          <cmdsynopsis>
+            <command>msql2mysql<replaceable>C-source-file</replaceable> &hellip;</command>
+          </cmdsynopsis>
+        </refsynopsisdiv>
+
+        <refsection id="msql2mysql-description">
+
+          <title>Description</title>
+
+          <para>
+            Initially, the MySQL C API was developed to be very similar
+            to that for the mSQL database system. Because of this, mSQL
+            programs often can be converted relatively easily for use
+            with MySQL by changing the names of the C API functions.
+          </para>
+
+          <para>
+            The <command>msql2mysql</command> utility performs the
+            conversion of mSQL C API function calls to their MySQL
+            equivalents. <command>msql2mysql</command> converts the
+            input file in place, so make a copy of the original before
+            converting it. For example, use
+            <command>msql2mysql</command> like this:
+          </para>
 
 <programlisting>
 shell&gt; <userinput>cp client-prog.c client-prog.c.orig</userinput>
@@ -136,47 +140,49 @@
 client-prog.c converted
 </programlisting>
 
-        <para>
-          Then examine <filename>client-prog.c</filename> and make any
-          post-conversion revisions that may be necessary.
-        </para>
+          <para>
+            Then examine <filename>client-prog.c</filename> and make any
+            post-conversion revisions that may be necessary.
+          </para>
 
-        <para>
-          <command>msql2mysql</command> uses the
-          <command>replace</command> utility to make the function name
-          substitutions. See <xref linkend="replace-utility"/>.
-        </para>
+          <para>
+            <command>msql2mysql</command> uses the
+            <command>replace</command> utility to make the function name
+            substitutions. See <xref linkend="replace-utility"/>.
+          </para>
+
+        </refsection>
 
-      </refsection>
+      </refentry>
 
-    </refentry>
+    </section>
 
-    <refentry id="mysql-config">
+    <section id="fake-id-for-mysql-config-manpage-section-wrapper">
 
-      <indexterm type="concept">
-        <primary><command>mysql_config</command></primary>
-      </indexterm>
+      <title>fake title for mysql-config manpage section wrapper</title>
 
-      <refmeta>
-        <refentrytitle>mysql_config</refentrytitle>
-        <manvolnum>man</manvolnum>
-        <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
-      </refmeta>
+      <refentry id="mysql-config">
 
-      <refnamediv>
-        <refname>mysql_config</refname>
-        <refpurpose>get compile options for compiling clients</refpurpose>
-      </refnamediv>
+        <indexterm type="concept">
+          <primary><command>mysql_config</command></primary>
+        </indexterm>
 
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>mysql_config <replaceable>options</replaceable></command>
-        </cmdsynopsis>
-      </refsynopsisdiv>
+        <refmeta>
+          <refentrytitle>mysql_config</refentrytitle>
+          <refmiscinfo>Get Compile Options for Compiling Clients</refmiscinfo>
+          <manvolnum>man</manvolnum>
+        </refmeta>
 
-      <refsection id="mysql-config-description">
+        <refnamediv>
+          <refname>mysql_config</refname>
+          <refpurpose>get compile options for compiling clients</refpurpose>
+        </refnamediv>
 
-        <title>Description</title>
+        <refsynopsisdiv>
+          <cmdsynopsis>
+            <command>mysql_config <replaceable>options</replaceable></command>
+          </cmdsynopsis>
+        </refsynopsisdiv>
 
         <para>
           <command>mysql_config</command> provides you with useful
@@ -325,9 +331,9 @@
           its output into the surrounding command.
         </para>
 
-      </refsection>
+      </refentry>
 
-    </refentry>
+    </section>
 
   </section>
 
@@ -360,11 +366,12 @@
     </para>
 
     <para>
-      Most of the other client APIs (all except Connector/J) use the
-      <literal>mysqlclient</literal> library to communicate with the
-      MySQL server. This means that, for example, you can take advantage
-      of many of the same environment variables that are used by other
-      client programs, because they are referenced from the library. See
+      Most of the other client APIs (all except Connector/J and
+      Connector/NET) use the <literal>mysqlclient</literal> library to
+      communicate with the MySQL server. This means that, for example,
+      you can take advantage of many of the same environment variables
+      that are used by other client programs, because they are
+      referenced from the library. See
       <xref linkend="client-side-scripts"/>, for a list of these
       variables.
     </para>
Thread
bk commit - mysqldoc@docsrva tree (paul:1.3228)paul10 Aug