svn commit - mysqldoc@docsrva: r7856 - trunk/refman-5.1

[mcbrown]

Author: mcbrown
Date: 2007-09-14 12:35:06 +0200 (Fri, 14 Sep 2007)
New Revision: 7856

Log:
Documenting Dev Bug #30717



Modified:
   trunk/refman-5.1/dba-core.xml
   trunk/refman-5.1/errors-problems.xml
   trunk/refman-5.1/installing.xml
   trunk/refman-5.1/news-5.1.xml


Modified: trunk/refman-5.1/dba-core.xml
===================================================================
--- trunk/refman-5.1/dba-core.xml	2007-09-14 10:26:47 UTC (rev 7855)
+++ trunk/refman-5.1/dba-core.xml	2007-09-14 10:35:06 UTC (rev 7856)
Changed blocks: 8, Lines Added: 18, Lines Deleted: 13; 4454 bytes

@@ -1273,10 +1273,14 @@
 
             <para>
               Enable support for named pipes. This option applies only
-              on Windows NT, 2000, XP, and 2003 systems, and can be used
-              only with the <command>mysqld-nt</command> and
+              on Windows NT, 2000, XP, and 2003 systems. For MySQL
+              5.1.20 and earler, this option is available only when
+              using the <command>mysqld-nt</command> and
               <literal>mysqld-debug</literal> servers that support
-              named-pipe connections.
+              named-pipe connections. For MySQL 5.1.21 and later,
+              <command>mysqld-nt</command> is not available, but support
+              is included in the standard <command>mysqld</command> and
+              <command>mysqld-debug</command> servers.
             </para>
           </listitem>
 

@@ -31159,7 +31163,8 @@
           Servers configured as just described allow clients to connect
           over TCP/IP. If your version of Windows supports named pipes
           and you also want to allow named-pipe connections, use the
-          <command>mysqld-nt</command> or
+          <command>mysqld-nt</command> (MySQL 5.1.20 and earlier),
+          <command>mysqld</command> (MySQL 5.1.21 and later) or
           <command>mysqld-debug</command> server and specify options
           that enable the named pipe and specify its name. Each server
           that supports named-pipe connections must use a unique pipe

@@ -31180,7 +31185,7 @@
         </para>
 
 <programlisting>
-C:\&gt; <userinput>C:\mysql\bin\mysqld-nt
--defaults-file=C:\my-opts1.cnf</userinput>
+C:\&gt; <userinput>C:\mysql\bin\mysqld
--defaults-file=C:\my-opts1.cnf</userinput>
 </programlisting>
 
         <para>

@@ -31218,7 +31223,7 @@
 
         <para>
           For the following instructions, assume that you want to run
-          the <command>mysqld-nt</command> server from two different
+          the <command>mysqld</command> server from two different
           versions of MySQL that are installed at
           <filename>C:\mysql-5.0.19</filename> and
           <filename>C:\mysql-&current-version;</filename>, respectively.

@@ -31308,9 +31313,9 @@
               options for all services in one of the standard option
               files. To do this, use a different service name for each
               server. Suppose that you want to run the 5.0.19
-              <command>mysqld-nt</command> using the service name of
+              <command>mysqld</command> using the service name of
               <literal>mysqld1</literal> and the &current-version;
-              <command>mysqld-nt</command> using the service name
+              <command>mysqld</command> using the service name
               <literal>mysqld2</literal>. In this case, you can use the
               <literal>[mysqld1]</literal> group for 5.0.19 and the
               <literal>[mysqld2]</literal> group for &current-version;.

@@ -31341,8 +31346,8 @@
             </para>
 
 <programlisting>
-C:\&gt; <userinput>C:\mysql-5.0.19\bin\mysqld-nt --install
mysqld1</userinput>
-C:\&gt; <userinput>C:\mysql-&current-version;\bin\mysqld-nt --install
mysqld2</userinput>
+C:\&gt; <userinput>C:\mysql-5.0.19\bin\mysqld --install
mysqld1</userinput>
+C:\&gt; <userinput>C:\mysql-&current-version;\bin\mysqld --install
mysqld2</userinput>
 </programlisting>
 
             <para>

@@ -31393,7 +31398,7 @@
 </programlisting>
 
             <para>
-              For the &current-version; <command>mysqld-nt</command>,
+              For the &current-version; <command>mysqld</command>,
               create a file <filename>C:\my-opts2.cnf</filename> that
               looks like this:
             </para>

@@ -31412,9 +31417,9 @@
             </para>
 
 <programlisting>
-C:\&gt; <userinput>C:\mysql-5.0.19\bin\mysqld-nt --install
mysqld1</userinput>
+C:\&gt; <userinput>C:\mysql-5.0.19\bin\mysqld --install
mysqld1</userinput>
            <userinput>--defaults-file=C:\my-opts1.cnf</userinput>
-C:\&gt; <userinput>C:\mysql-&current-version;\bin\mysqld-nt --install
mysqld2</userinput>
+C:\&gt; <userinput>C:\mysql-&current-version;\bin\mysqld --install
mysqld2</userinput>
            <userinput>--defaults-file=C:\my-opts2.cnf</userinput>
 </programlisting>
 


Modified: trunk/refman-5.1/errors-problems.xml
===================================================================
--- trunk/refman-5.1/errors-problems.xml	2007-09-14 10:26:47 UTC (rev 7855)
+++ trunk/refman-5.1/errors-problems.xml	2007-09-14 10:35:06 UTC (rev 7856)
Changed blocks: 2, Lines Added: 2, Lines Deleted: 2; 979 bytes

@@ -2613,7 +2613,7 @@
             </para>
 
 <programlisting>
-C:\&gt; <userinput>C:\mysql\bin\mysqld-nt
--init-file=C:\mysql-init.txt</userinput>
+C:\&gt; <userinput>C:\mysql\bin\mysqld
--init-file=C:\mysql-init.txt</userinput>
 </programlisting>
 
             <para>

@@ -2631,7 +2631,7 @@
             </para>
 
 <programlisting>
-C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server
&current-series;\bin\mysqld-nt.exe"</userinput>
+C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server
&current-series;\bin\mysqld.exe"</userinput>
          <userinput>--defaults-file="C:\Program Files\MySQL\MySQL Server
&current-series;\my.ini"</userinput>
          <userinput>--init-file=C:\mysql-init.txt</userinput>
 </programlisting>


Modified: trunk/refman-5.1/installing.xml
===================================================================
--- trunk/refman-5.1/installing.xml	2007-09-14 10:26:47 UTC (rev 7855)
+++ trunk/refman-5.1/installing.xml	2007-09-14 10:35:06 UTC (rev 7856)
Changed blocks: 4, Lines Added: 37, Lines Deleted: 7; 2793 bytes

@@ -4201,7 +4201,7 @@
 
       <para>
         The following table shows the available servers for Windows in
-        MySQL &current-series;.
+        MySQL 5.1.20 and earlier.
       </para>
 
       <informaltable>

@@ -4231,6 +4231,33 @@
       </informaltable>
 
       <para>
+        The following table shows the available servers for Windows in
+        MySQL 5.1.21 and earlier.
+      </para>
+
+      <informaltable>
+        <tgroup cols="2">
+          <colspec colwidth="20*"/>
+          <colspec colwidth="80*"/>
+          <tbody>
+            <row>
+              <entry><emphasis
role="bold">Binary</emphasis></entry>
+              <entry><emphasis
role="bold">Description</emphasis></entry>
+            </row>
+            <row>
+              <entry><command>mysqld</command></entry>
+              <entry>Optimized binary with named-pipe support</entry>
+            </row>
+            <row>
+              <entry><command>mysqld-debug</command></entry>
+              <entry>Like <command>mysqld</command>, but compiled with
full debugging and
+                automatic memory allocation checking</entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+
+      <para>
         All of the preceding binaries are optimized for modern Intel
         processors, but should work on any Intel i386-class or higher
         processor.

@@ -4281,9 +4308,12 @@
 
         <listitem>
           <para>
-            Named-pipe connections are allowed only by the
-            <command>mysqld-nt</command> and
-            <command>mysqld-debug</command> servers.
+            For MySQL 5.1.20 and earlier, named-pipe connections are
+            allowed only by the <command>mysqld-nt</command> and
+            <command>mysqld-debug</command> servers. For MySQL 5.1.21
+            and later, the <command>mysqld</command> and
+            <command>mysqld-debug</command> both contain support for
+            named-pipe connections.
           </para>
         </listitem>
 

@@ -4293,9 +4323,9 @@
         <para>
           Most of the examples in this manual use
           <command>mysqld</command> as the server name. If you choose to
-          use a different server, such as <command>mysqld-nt</command>,
-          make the appropriate substitutions in the commands that are
-          shown in the examples.
+          use a different server, such as <command>mysqld-nt</command>
+          or <command>mysqld-debug</command>, make the appropriate
+          substitutions in the commands that are shown in the examples.
         </para>
       </note>
 


Modified: trunk/refman-5.1/news-5.1.xml
===================================================================
--- trunk/refman-5.1/news-5.1.xml	2007-09-14 10:26:47 UTC (rev 7855)
+++ trunk/refman-5.1/news-5.1.xml	2007-09-14 10:35:06 UTC (rev 7856)
Changed blocks: 1, Lines Added: 12, Lines Deleted: 0; 985 bytes

@@ -1026,6 +1026,18 @@
 
       <listitem>
         <para>
+          <emphasis role="bold">Incompatible change</emphasis>: On
+          Windows only, the <command>mysqld-nt</command> has been
+          removed from this release and all future releases. The
+          <command>mysqld</command> server now includes named-pipe
+          support as standard, and you do not have to use the
+          <command>mysqld-nt</command> version to enable named-pipe
+          support.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
           <emphasis role="bold">Incompatible change</emphasis>: In MySQL
           5.1.6, when log tables were implemented, the default log
           destination for the general query and slow query log was