List:Commits« Previous MessageNext Message »
From:paul Date:January 30 2006 9:37pm
Subject:svn commit - mysqldoc@docsrva: r1137 - in trunk: . refman-4.1 refman-5.0 refman-5.1
View as plain text  
Author: paul
Date: 2006-01-30 22:37:47 +0100 (Mon, 30 Jan 2006)
New Revision: 1137

Log:
 r2718@kite-hub:  paul | 2006-01-30 15:03:16 -0600
 General revisions.


Modified:
   trunk/
   trunk/refman-4.1/installing.xml
   trunk/refman-5.0/installing.xml
   trunk/refman-5.1/installing.xml


Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:6940
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:2715
   + b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:6940
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:2718

Modified: trunk/refman-4.1/installing.xml
===================================================================
--- trunk/refman-4.1/installing.xml	2006-01-30 20:36:24 UTC (rev 1136)
+++ trunk/refman-4.1/installing.xml	2006-01-30 21:37:47 UTC (rev 1137)
@@ -4582,6 +4582,20 @@
       <title>&title-windows-server-first-start;</title>
 
       <para>
+        This section gives a general overview of starting the MySQL
+        server. The following sections provide more specific information
+        for starting the MySQL server from the command line or as a
+        Windows service.
+      </para>
+
+      <para>
+        The information here applies primarily if you installed MySQL
+        using the <literal>Noinstall</literal> version, or if you wish
+        to configure and test MySQL manually rather than with the GUI
+        tools.
+      </para>
+
+      <para>
         On Windows 95, 98, or Me, MySQL clients always connect to the
         server using TCP/IP. (This allows any machine on your network to
         connect to your MySQL server.) Because of this, you must make
@@ -4620,13 +4634,6 @@
       </para>
 
       <para>
-        This section gives a general overview of starting the MySQL
-        server. The following sections provide more specific information
-        for starting the MySQL server from the command line or as a
-        Windows service.
-      </para>
-
-      <para>
         The examples in these sections assume that MySQL is installed
         under the default location of <filename>C:\mysql</filename>.
         Adjust the pathnames shown in the examples if you have MySQL
@@ -4750,7 +4757,15 @@
 </programlisting>
 
       <para>
-        This invokes the MySQL administrative utility
+        <emphasis role="bold">Note</emphasis>: If the MySQL
+        <literal>root</literal> user account has a password, you need to
+        invoke <command>mysqladmin</command> with the
+        <option>-p</option> option and supply the password when
+        prompted.
+      </para>
+
+      <para>
+        This command invokes the MySQL administrative utility
         <command>mysqladmin</command> to connect to the server and tell
         it to shut down. The command connects as the MySQL
         <literal>root</literal> user, which is the default
@@ -4771,11 +4786,11 @@
       </para>
 
       <para>
-        The last option is to start <command>mysqld</command> with
-        <option>--standalone --debug</option>. In this case,
-        <command>mysqld</command> writes a log file
-        <filename>C:\mysqld.trace</filename> that should contain the
-        reason why <command>mysqld</command> does not start. See
+        The last option is to start <command>mysqld</command> with the
+        <option>--standalone</option> and <option>--debug</option>
+        options. In this case, <command>mysqld</command> writes a log
+        file <filename>C:\mysqld.trace</filename> that should contain
+        the reason why <command>mysqld</command> doesn't start. See
         <xref linkend="making-trace-files"/>.
       </para>
 
@@ -4804,12 +4819,11 @@
       <para>
         The <command>Services</command> utility (the Windows
         <command>Service Control Manager</command>) can be found in the
-        Windows <guimenu>Control Panel</guimenu> (under
-        <guimenuitem>Administrative Tools</guimenuitem> on Windows 2000,
-        XP, and Server 2003). It is advisable to close the
+        Windows Control Panel (under <guimenuitem>Administrative
+        Tools</guimenuitem> on Windows 2000, XP, and Server 2003). To
+        avoid conflicts, it is advisable to close the
         <command>Services</command> utility while performing server
-        installation or removal operations from this command line. This
-        prevents some odd errors.
+        installation or removal operations from the command line.
       </para>
 
       <para>
@@ -4823,7 +4837,15 @@
 </programlisting>
 
       <para>
-        This invokes the MySQL administrative utility
+        <emphasis role="bold">Note</emphasis>: If the MySQL
+        <literal>root</literal> user account has a password, you need to
+        invoke this command as <command>mysqladmin</command> with the
+        <option>-p</option> option and supply the password when
+        prompted.
+      </para>
+
+      <para>
+        This command invokes the MySQL administrative utility
         <command>mysqladmin</command> to connect to the server and tell
         it to shut down. The command connects as the MySQL
         <literal>root</literal> user, which is the default
@@ -4837,16 +4859,6 @@
       </para>
 
 <programlisting>
-C:\&gt; <userinput>mysqld --install</userinput>
-</programlisting>
-
-      <para>
-        If you have problems installing <command>mysqld</command> as a
-        service using just the server name, try installing it using its
-        full pathname. For example:
-      </para>
-
-<programlisting>
 C:\&gt; <userinput>C:\mysql\bin\mysqld --install</userinput>
 </programlisting>
 
@@ -4976,7 +4988,7 @@
         <literal>[mysqld]</literal> group from the standard option
         files. However, because the <option>--defaults-file</option>
         option is present, the server reads options from the
-        <literal>[mysqld]</literal> option group, but only from the
+        <literal>[mysqld]</literal> option group, and only from the
         named file.
       </para>
 
@@ -5000,8 +5012,8 @@
         Once a MySQL server has been installed as a service, Windows
         starts the service automatically whenever Windows starts. The
         service also can be started immediately from the
-        <literal>Services</literal> utility, or by using the command
-        <command>NET START MySQL</command>. The <command>NET</command>
+        <command>Services</command> utility, or by using a <command>NET
+        START MySQL</command> command. The <command>NET</command>
         command is not case sensitive.
       </para>
 
@@ -5019,9 +5031,9 @@
         When a MySQL server has been installed as a service, and the
         service is running, Windows stops the service automatically when
         Windows shuts down. The server also can be stopped manually by
-        using the <literal>Services</literal> utility, the command
-        <command>NET STOP MySQL</command>, or the command
-        <command>mysqladmin shutdown</command>.
+        using the <literal>Services</literal> utility, the <command>NET
+        STOP MySQL</command> command, or the <command>mysqladmin
+        shutdown</command> command.
       </para>
 
       <para>
@@ -5128,7 +5140,8 @@
         rather than TCP/IP by specifying the <option>--pipe</option>
         option or by specifying <literal>.</literal> (period) as the
         host name. Use the <option>--socket</option> option to specify
-        the name of the pipe. As of MySQL 4.1, you can use the
+        the name of the pipe if you do not want to use the default pipe
+        name. As of MySQL 4.1, you can use the
         <option>--protocol=PIPE</option> option instead.
       </para>
 

Modified: trunk/refman-5.0/installing.xml
===================================================================
--- trunk/refman-5.0/installing.xml	2006-01-30 20:36:24 UTC (rev 1136)
+++ trunk/refman-5.0/installing.xml	2006-01-30 21:37:47 UTC (rev 1137)
@@ -4509,13 +4509,36 @@
       </remark>
 
       <para>
-        The information in this section applies primarily if you
-        installed MySQL using the <literal>Noinstall</literal> version,
-        or if you wish to configure and test MySQL manually rather than
-        with the GUI tools.
+        This section gives a general overview of starting the MySQL
+        server. The following sections provide more specific information
+        for starting the MySQL server from the command line or as a
+        Windows service.
       </para>
 
       <para>
+        The information here applies primarily if you installed MySQL
+        using the <literal>Noinstall</literal> version, or if you wish
+        to configure and test MySQL manually rather than with the GUI
+        tools.
+      </para>
+
+      <para>
+        The examples in these sections assume that MySQL is installed
+        under the default location of <filename>C:\Program
+        Files\MySQL\MySQL Server &current-series;</filename>. Adjust the
+        pathnames shown in the examples if you have MySQL installed in a
+        different location.
+      </para>
+
+      <para>
+        On NT-based systems such as Windows NT, 2000, XP, or 2003,
+        clients have two options. They can use TCP/IP, or they can use a
+        named pipe if the server supports named-pipe connections. For
+        MySQL to work with TCP/IP on Windows NT 4, you must install
+        service pack 3 (or newer).
+      </para>
+
+      <para>
         On Windows 95, 98, or Me, MySQL clients always connect to the
         server using TCP/IP. (This allows any machine on your network to
         connect to your MySQL server.) Because of this, you must make
@@ -4533,14 +4556,6 @@
       </para>
 
       <para>
-        On NT-based systems such as Windows NT, 2000, XP, or 2003,
-        clients have two options. They can use TCP/IP, or they can use a
-        named pipe if the server supports named-pipe connections. For
-        MySQL to work with TCP/IP on Windows NT 4, you must install
-        service pack 3 (or newer).
-      </para>
-
-      <para>
         MySQL for Windows also supports shared-memory connections if
         started with the <option>--shared-memory</option> option.
         Clients can connect through shared memory by using the
@@ -4553,21 +4568,6 @@
       </para>
 
       <para>
-        This section gives a general overview of starting the MySQL
-        server. The following sections provide more specific information
-        for starting the MySQL server from the command line or as a
-        Windows service.
-      </para>
-
-      <para>
-        The examples in these sections assume that MySQL is installed
-        under the default location of <filename>C:\Program
-        Files\MySQL\MySQL Server &current-series;</filename>. Adjust the
-        pathnames shown in the examples if you have MySQL installed in a
-        different location.
-      </para>
-
-      <para>
         Testing is best done from a command prompt in a console window
         (or <quote>DOS window</quote>). In this way you can have the
         server display status messages in the window where they are easy
@@ -4685,7 +4685,15 @@
 </programlisting>
 
       <para>
-        This invokes the MySQL administrative utility
+        <emphasis role="bold">Note</emphasis>: If the MySQL
+        <literal>root</literal> user account has a password, you need to
+        invoke <command>mysqladmin</command> with the
+        <option>-p</option> option and supply the password when
+        prompted.
+      </para>
+
+      <para>
+        This command invokes the MySQL administrative utility
         <command>mysqladmin</command> to connect to the server and tell
         it to shut down. The command connects as the MySQL
         <literal>root</literal> user, which is the default
@@ -4707,11 +4715,11 @@
       </para>
 
       <para>
-        The last option is to start <command>mysqld</command> with
-        <option>--standalone --debug</option>. In this case,
-        <command>mysqld</command> writes a log file
-        <filename>C:\mysqld.trace</filename> that should contain the
-        reason why <command>mysqld</command> doesn't start. See
+        The last option is to start <command>mysqld</command> with the
+        <option>--standalone</option> and <option>--debug</option>
+        options. In this case, <command>mysqld</command> writes a log
+        file <filename>C:\mysqld.trace</filename> that should contain
+        the reason why <command>mysqld</command> doesn't start. See
         <xref linkend="making-trace-files"/>.
       </para>
 
@@ -4740,10 +4748,10 @@
         The <command>Services</command> utility (the Windows
         <command>Service Control Manager</command>) can be found in the
         Windows Control Panel (under <guimenuitem>Administrative
-        Tools</guimenuitem> on Windows 2000, XP, and Server 2003). It is
-        advisable to close the <command>Services</command> utility while
-        performing server installation or removal operations from the
-        command line. This prevents a number of errors.
+        Tools</guimenuitem> on Windows 2000, XP, and Server 2003). To
+        avoid conflicts, it is advisable to close the
+        <command>Services</command> utility while performing server
+        installation or removal operations from the command line.
       </para>
 
       <para>
@@ -4759,15 +4767,15 @@
       <para>
         <emphasis role="bold">Note</emphasis>: If the MySQL
         <literal>root</literal> user account has a password, you need to
-        invoke this command as <command>C:\Program Files\MySQL\MySQL
-        Server &current-series;\bin\mysqladmin -u root -p
-        shutdown</command> and supply the password when prompted.
+        invoke this command as <command>mysqladmin</command> with the
+        <option>-p</option> option and supply the password when
+        prompted.
       </para>
 
       <para>
-        This invokes the MySQL administrative utility
-        <command>mysqladmin</command>, which connects to the server and
-        tells it to shut down. The command connects as the MySQL
+        This command invokes the MySQL administrative utility
+        <command>mysqladmin</command> to connect to the server and tell
+        it to shut down. The command connects as the MySQL
         <literal>root</literal> user, which is the default
         administrative account in the MySQL grant system. Note that
         users in the MySQL grant system are wholly independent from any
@@ -4779,28 +4787,18 @@
       </para>
 
 <programlisting>
-C:\&gt; <userinput>mysqld --install</userinput>
+C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld" --install</userinput>
 </programlisting>
 
       <para>
-        If you have problems installing <command>mysqld</command> as a
-        service using just the server name, try installing it using its
-        full pathname. For example:
+        The service-installation command does not start the server.
+        Instructions for that are given later in this section.
       </para>
 
-<programlisting>
-C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld" --install</userinput>
-</programlisting>
-
-      <remark>
-        I commented this out because no instructions were given how to
-        "fix" the path. - PD
-      </remark>
-
       <para>
-        You can also add the path to the mysql <filename>bin</filename>
-        directory to your Windows system <literal>PATH</literal>
-        environment variable:
+        To make it easier to invoke MySQL programs, you can add the
+        pathname of the MySQL <filename>bin</filename> directory to your
+        Windows system <literal>PATH</literal> environment variable:
       </para>
 
       <itemizedlist>
@@ -4815,10 +4813,10 @@
 
         <listitem>
           <para>
-            Next select, the <guimenuitem>Advanced</guimenuitem> tab
-            from the <guimenu>System Properties</guimenu> menu that
-            appears, and click the <guibutton>Environment
-            Variables</guibutton> button.
+            Next select the <guimenuitem>Advanced</guimenuitem> tab from
+            the <guimenu>System Properties</guimenu> menu that appears,
+            and click the <guibutton>Environment Variables</guibutton>
+            button.
           </para>
         </listitem>
 
@@ -4837,7 +4835,7 @@
             space marked <guilabel>Variable Value</guilabel>. (Use the
             <keycap>End</keycap> key to ensure that your cursor is
             positioned at the very end of the text in this space.) Then
-            enter the complete path to your MySQL
+            enter the complete pathname of your MySQL
             <filename>bin</filename> directory (for example,
             <literal>C:\Program Files\MySQL\MySQL Server
             &current-series;\bin</literal>), Note that there should be a
@@ -4852,14 +4850,11 @@
             command-line utilities such as <command>mysqladmin</command>
             and <command>mysqldump</command>.
           </para>
-        </listitem>
 
-        <listitem>
           <para>
-            Note that you should not add the MySQL
-            <filename>bin</filename> directory to your Windows
-            <literal>PATH</literal> if you are running multiple MySQL
-            servers on the same machine.
+            You should not add the MySQL <filename>bin</filename>
+            directory to your Windows <literal>PATH</literal> if you are
+            running multiple MySQL servers on the same machine.
           </para>
         </listitem>
 
@@ -4868,18 +4863,13 @@
       <para>
         <emphasis role="bold">Warning</emphasis>: You must exercise
         great care when editing your system <literal>PATH</literal> by
-        hand; the accidentally deletion or modification of any portion
-        of the existing <literal>PATH</literal> value can leave you with
-        a malfunctioning or even unusable system.
+        hand; accidental deletion or modification of any portion of the
+        existing <literal>PATH</literal> value can leave you with a
+        malfunctioning or even unusable system.
       </para>
 
       <para>
-        The service-installation command does not start the server.
-        Instructions for that are given later in this section.
-      </para>
-
-      <para>
-        The following additional arguments are available in MySQL
+        The following additional arguments can be used in MySQL
         &current-series; when installing the service:
       </para>
 
@@ -4987,7 +4977,8 @@
       </para>
 
 <programlisting>
-C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld" --install MySQL --defaults-file=C:\my-opts.cnf</userinput>
+C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld"</userinput>
+          <userinput>--install MySQL --defaults-file=C:\my-opts.cnf</userinput>
 </programlisting>
 
       <para>
@@ -4998,7 +4989,7 @@
         <literal>[mysqld]</literal> group from the standard option
         files. However, because the <option>--defaults-file</option>
         option is present, the server reads options from the
-        <literal>[mysqld]</literal> option group, but only from the
+        <literal>[mysqld]</literal> option group, and only from the
         named file.
       </para>
 
@@ -5012,8 +5003,8 @@
         Once a MySQL server has been installed as a service, Windows
         starts the service automatically whenever Windows starts. The
         service also can be started immediately from the
-        <command>Services</command> utility, or by using the command
-        <command>NET START MySQL</command>. The <command>NET</command>
+        <command>Services</command> utility, or by using a <command>NET
+        START MySQL</command> command. The <command>NET</command>
         command is not case sensitive.
       </para>
 
@@ -5032,9 +5023,9 @@
         When a MySQL server has been installed as a service, and the
         service is running, Windows stops the service automatically when
         Windows shuts down. The server also can be stopped manually by
-        using the <literal>Services</literal> utility, the command
-        <command>NET STOP MySQL</command>, or the command
-        <command>mysqladmin shutdown</command>.
+        using the <literal>Services</literal> utility, the <command>NET
+        STOP MySQL</command> command, or the <command>mysqladmin
+        shutdown</command> command.
       </para>
 
       <para>
@@ -5110,8 +5101,8 @@
         rather than TCP/IP by specifying the <option>--pipe</option> or
         <option>--protocol=PIPE</option> option, or by specifying
         <literal>.</literal> (period) as the host name. Use the
-        <option>--socket</option> option to specify the name of the
-        pipe.
+        <option>--socket</option> option to specify the name of the pipe
+        if you do not want to use the default pipe name.
       </para>
 
     </section>

Modified: trunk/refman-5.1/installing.xml
===================================================================
--- trunk/refman-5.1/installing.xml	2006-01-30 20:36:24 UTC (rev 1136)
+++ trunk/refman-5.1/installing.xml	2006-01-30 21:37:47 UTC (rev 1137)
@@ -4509,13 +4509,36 @@
       </remark>
 
       <para>
-        The information in this section applies primarily if you
-        installed MySQL using the <literal>Noinstall</literal> version,
-        or if you wish to configure and test MySQL manually rather than
-        with the GUI tools.
+        This section gives a general overview of starting the MySQL
+        server. The following sections provide more specific information
+        for starting the MySQL server from the command line or as a
+        Windows service.
       </para>
 
       <para>
+        The information here applies primarily if you installed MySQL
+        using the <literal>Noinstall</literal> version, or if you wish
+        to configure and test MySQL manually rather than with the GUI
+        tools.
+      </para>
+
+      <para>
+        The examples in these sections assume that MySQL is installed
+        under the default location of <filename>C:\Program
+        Files\MySQL\MySQL Server &current-series;</filename>. Adjust the
+        pathnames shown in the examples if you have MySQL installed in a
+        different location.
+      </para>
+
+      <para>
+        On NT-based systems such as Windows NT, 2000, XP, or 2003,
+        clients have two options. They can use TCP/IP, or they can use a
+        named pipe if the server supports named-pipe connections. For
+        MySQL to work with TCP/IP on Windows NT 4, you must install
+        service pack 3 (or newer).
+      </para>
+
+      <para>
         On Windows 95, 98, or Me, MySQL clients always connect to the
         server using TCP/IP. (This allows any machine on your network to
         connect to your MySQL server.) Because of this, you must make
@@ -4533,14 +4556,6 @@
       </para>
 
       <para>
-        On NT-based systems such as Windows NT, 2000, XP, or 2003,
-        clients have two options. They can use TCP/IP, or they can use a
-        named pipe if the server supports named-pipe connections. For
-        MySQL to work with TCP/IP on Windows NT 4, you must install
-        service pack 3 (or newer).
-      </para>
-
-      <para>
         MySQL for Windows also supports shared-memory connections if
         started with the <option>--shared-memory</option> option.
         Clients can connect through shared memory by using the
@@ -4553,21 +4568,6 @@
       </para>
 
       <para>
-        This section gives a general overview of starting the MySQL
-        server. The following sections provide more specific information
-        for starting the MySQL server from the command line or as a
-        Windows service.
-      </para>
-
-      <para>
-        The examples in these sections assume that MySQL is installed
-        under the default location of <filename>C:\Program
-        Files\MySQL\MySQL Server &current-series;</filename>. Adjust the
-        pathnames shown in the examples if you have MySQL installed in a
-        different location.
-      </para>
-
-      <para>
         Testing is best done from a command prompt in a console window
         (or <quote>DOS window</quote>). In this way you can have the
         server display status messages in the window where they are easy
@@ -4685,7 +4685,15 @@
 </programlisting>
 
       <para>
-        This invokes the MySQL administrative utility
+        <emphasis role="bold">Note</emphasis>: If the MySQL
+        <literal>root</literal> user account has a password, you need to
+        invoke <command>mysqladmin</command> with the
+        <option>-p</option> option and supply the password when
+        prompted.
+      </para>
+
+      <para>
+        This command invokes the MySQL administrative utility
         <command>mysqladmin</command> to connect to the server and tell
         it to shut down. The command connects as the MySQL
         <literal>root</literal> user, which is the default
@@ -4707,11 +4715,11 @@
       </para>
 
       <para>
-        The last option is to start <command>mysqld</command> with
-        <option>--standalone --debug</option>. In this case,
-        <command>mysqld</command> writes a log file
-        <filename>C:\mysqld.trace</filename> that should contain the
-        reason why <command>mysqld</command> doesn't start. See
+        The last option is to start <command>mysqld</command> with the
+        <option>--standalone</option> and <option>--debug</option>
+        options. In this case, <command>mysqld</command> writes a log
+        file <filename>C:\mysqld.trace</filename> that should contain
+        the reason why <command>mysqld</command> doesn't start. See
         <xref linkend="making-trace-files"/>.
       </para>
 
@@ -4740,10 +4748,10 @@
         The <command>Services</command> utility (the Windows
         <command>Service Control Manager</command>) can be found in the
         Windows Control Panel (under <guimenuitem>Administrative
-        Tools</guimenuitem> on Windows 2000, XP, and Server 2003). It is
-        advisable to close the <command>Services</command> utility while
-        performing server installation or removal operations from the
-        command line. This prevents a number of errors.
+        Tools</guimenuitem> on Windows 2000, XP, and Server 2003). To
+        avoid conflicts, it is advisable to close the
+        <command>Services</command> utility while performing server
+        installation or removal operations from the command line.
       </para>
 
       <para>
@@ -4759,15 +4767,15 @@
       <para>
         <emphasis role="bold">Note</emphasis>: If the MySQL
         <literal>root</literal> user account has a password, you need to
-        invoke this command as <command>C:\Program Files\MySQL\MySQL
-        Server &current-series;\bin\mysqladmin -u root -p
-        shutdown</command> and supply the password when prompted.
+        invoke this command as <command>mysqladmin</command> with the
+        <option>-p</option> option and supply the password when
+        prompted.
       </para>
 
       <para>
-        This invokes the MySQL administrative utility
-        <command>mysqladmin</command>, which connects to the server and
-        tells it to shut down. The command connects as the MySQL
+        This command invokes the MySQL administrative utility
+        <command>mysqladmin</command> to connect to the server and tell
+        it to shut down. The command connects as the MySQL
         <literal>root</literal> user, which is the default
         administrative account in the MySQL grant system. Note that
         users in the MySQL grant system are wholly independent from any
@@ -4779,28 +4787,18 @@
       </para>
 
 <programlisting>
-C:\&gt; <userinput>mysqld --install</userinput>
+C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld" --install</userinput>
 </programlisting>
 
       <para>
-        If you have problems installing <command>mysqld</command> as a
-        service using just the server name, try installing it using its
-        full pathname. For example:
+        The service-installation command does not start the server.
+        Instructions for that are given later in this section.
       </para>
 
-<programlisting>
-C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld" --install</userinput>
-</programlisting>
-
-      <remark>
-        I commented this out because no instructions were given how to
-        "fix" the path. - PD
-      </remark>
-
       <para>
-        You can also add the path to the mysql <filename>bin</filename>
-        directory to your Windows system <literal>PATH</literal>
-        environment variable:
+        To make it easier to invoke MySQL programs, you can add the
+        pathname of the MySQL <filename>bin</filename> directory to your
+        Windows system <literal>PATH</literal> environment variable:
       </para>
 
       <itemizedlist>
@@ -4815,10 +4813,10 @@
 
         <listitem>
           <para>
-            Next select, the <guimenuitem>Advanced</guimenuitem> tab
-            from the <guimenu>System Properties</guimenu> menu that
-            appears, and click the <guibutton>Environment
-            Variables</guibutton> button.
+            Next select the <guimenuitem>Advanced</guimenuitem> tab from
+            the <guimenu>System Properties</guimenu> menu that appears,
+            and click the <guibutton>Environment Variables</guibutton>
+            button.
           </para>
         </listitem>
 
@@ -4837,7 +4835,7 @@
             space marked <guilabel>Variable Value</guilabel>. (Use the
             <keycap>End</keycap> key to ensure that your cursor is
             positioned at the very end of the text in this space.) Then
-            enter the complete path to your MySQL
+            enter the complete pathname of your MySQL
             <filename>bin</filename> directory (for example,
             <literal>C:\Program Files\MySQL\MySQL Server
             &current-series;\bin</literal>), Note that there should be a
@@ -4852,14 +4850,11 @@
             command-line utilities such as <command>mysqladmin</command>
             and <command>mysqldump</command>.
           </para>
-        </listitem>
 
-        <listitem>
           <para>
-            Note that you should not add the MySQL
-            <filename>bin</filename> directory to your Windows
-            <literal>PATH</literal> if you are running multiple MySQL
-            servers on the same machine.
+            You should not add the MySQL <filename>bin</filename>
+            directory to your Windows <literal>PATH</literal> if you are
+            running multiple MySQL servers on the same machine.
           </para>
         </listitem>
 
@@ -4868,18 +4863,13 @@
       <para>
         <emphasis role="bold">Warning</emphasis>: You must exercise
         great care when editing your system <literal>PATH</literal> by
-        hand; the accidentally deletion or modification of any portion
-        of the existing <literal>PATH</literal> value can leave you with
-        a malfunctioning or even unusable system.
+        hand; accidental deletion or modification of any portion of the
+        existing <literal>PATH</literal> value can leave you with a
+        malfunctioning or even unusable system.
       </para>
 
       <para>
-        The service-installation command does not start the server.
-        Instructions for that are given later in this section.
-      </para>
-
-      <para>
-        The following additional arguments are available in MySQL
+        The following additional arguments can be used in MySQL
         &current-series; when installing the service:
       </para>
 
@@ -4983,7 +4973,8 @@
       </para>
 
 <programlisting>
-C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld" --install MySQL --defaults-file=C:\my-opts.cnf</userinput>
+C:\&gt; <userinput>"C:\Program Files\MySQL\MySQL Server &current-series;\bin\mysqld"</userinput>
+          <userinput>--install MySQL --defaults-file=C:\my-opts.cnf</userinput>
 </programlisting>
 
       <para>
@@ -4994,7 +4985,7 @@
         <literal>[mysqld]</literal> group from the standard option
         files. However, because the <option>--defaults-file</option>
         option is present, the server reads options from the
-        <literal>[mysqld]</literal> option group, but only from the
+        <literal>[mysqld]</literal> option group, and only from the
         named file.
       </para>
 
@@ -5008,8 +4999,8 @@
         Once a MySQL server has been installed as a service, Windows
         starts the service automatically whenever Windows starts. The
         service also can be started immediately from the
-        <command>Services</command> utility, or by using the command
-        <command>NET START MySQL</command>. The <command>NET</command>
+        <command>Services</command> utility, or by using a <command>NET
+        START MySQL</command> command. The <command>NET</command>
         command is not case sensitive.
       </para>
 
@@ -5028,9 +5019,9 @@
         When a MySQL server has been installed as a service, and the
         service is running, Windows stops the service automatically when
         Windows shuts down. The server also can be stopped manually by
-        using the <literal>Services</literal> utility, the command
-        <command>NET STOP MySQL</command>, or the command
-        <command>mysqladmin shutdown</command>.
+        using the <literal>Services</literal> utility, the <command>NET
+        STOP MySQL</command> command, or the <command>mysqladmin
+        shutdown</command> command.
       </para>
 
       <para>
@@ -5106,8 +5097,8 @@
         rather than TCP/IP by specifying the <option>--pipe</option> or
         <option>--protocol=PIPE</option> option, or by specifying
         <literal>.</literal> (period) as the host name. Use the
-        <option>--socket</option> option to specify the name of the
-        pipe.
+        <option>--socket</option> option to specify the name of the pipe
+        if you do not want to use the default pipe name.
       </para>
 
     </section>

Thread
svn commit - mysqldoc@docsrva: r1137 - in trunk: . refman-4.1 refman-5.0 refman-5.1paul30 Jan