From: jon
Date: January 12 2007 9:02am
Subject: svn commit - mysqldoc@docsrva: r4462 - in trunk: refman-4.1 refman-5.0 refman-5.1
List-Archive: http://lists.mysql.com/commits/18010
Message-Id: <200701120902.l0C92u3t019041@docsrva.mysql.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Author: jstephens
Date: 2007-01-12 10:02:55 +0100 (Fri, 12 Jan 2007)
New Revision: 4462

Log:

Some wording fixes, including the infamous "will must". (Thanks, J?\195?\182rg!)



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


Modified: trunk/refman-4.1/installing.xml
===================================================================
--- trunk/refman-4.1/installing.xml	2007-01-12 05:00:19 UTC (rev 4461)
+++ trunk/refman-4.1/installing.xml	2007-01-12 09:02:55 UTC (rev 4462)
Changed blocks: 1, Lines Added: 5, Lines Deleted: 6; 1147 bytes

@@ -8648,12 +8648,11 @@
 <programlisting>shell&gt; bkf changes -vvr<replaceable>CSETID</replaceable></programlisting>
 
           <para>
-            If you see some funny diffs or code that you have a question
-            about, do not hesitate to send email to the MySQL
-            <literal>internals</literal> mailing list. See
-            <xref linkend="mailing-lists"/>. Also, if you think you have
-            a better idea on how to do something, send an email message
-            to the list with a patch.
+            If you see diffs or code that you have a question about, do
+            not hesitate to send email to the MySQL Internals mailing
+            list. (See <xref linkend="mailing-lists"/>.) Also, if you
+            think you have a better idea on how to do something, send an
+            email message to the list with your proposed patch.
           </para>
         </listitem>
 


Modified: trunk/refman-5.0/installing-cs.xml
===================================================================
--- trunk/refman-5.0/installing-cs.xml	2007-01-12 05:00:19 UTC (rev 4461)
+++ trunk/refman-5.0/installing-cs.xml	2007-01-12 09:02:55 UTC (rev 4462)
Changed blocks: 1, Lines Added: 5, Lines Deleted: 6; 1156 bytes

@@ -7749,12 +7749,11 @@
 <programlisting>shell&gt; bkf changes -vvr<replaceable>CSETID</replaceable></programlisting>
 
           <para>
-            If you see some funny diffs or code that you have a question
-            about, do not hesitate to send email to the MySQL
-            <literal>internals</literal> mailing list. See
-            <xref linkend="mailing-lists"/>. Also, if you think you have
-            a better idea on how to do something, send an email message
-            to the list with a patch.
+            If you see diffs or code that you have a question about, do
+            not hesitate to send email to the MySQL Internals mailing
+            list. (See <xref linkend="mailing-lists"/>.) Also, if you
+            think you have a better idea on how to do something, send an
+            email message to the list with your proposed patch.
           </para>
         </listitem>
 


Modified: trunk/refman-5.1/installing.xml
===================================================================
--- trunk/refman-5.1/installing.xml	2007-01-12 05:00:19 UTC (rev 4461)
+++ trunk/refman-5.1/installing.xml	2007-01-12 09:02:55 UTC (rev 4462)
Changed blocks: 8, Lines Added: 29, Lines Deleted: 32; 6382 bytes

@@ -9310,11 +9310,11 @@
 
       <para>
         <emphasis role="bold">Note</emphasis>: The instructions here are
-        strictly for users who want to test MySQL on Windows from the
-        latest source distribution or from the BitKeeper tree. For
-        production use, MySQL AB does not advise using a MySQL server
-        built by yourself from source. Normally, it is best to use
-        precompiled binary distributions of MySQL that are built
+        strictly for users who want to test MySQL on Microsoft Windows
+        from the latest source distribution or from the BitKeeper tree.
+        For production use, MySQL AB does not advise using a MySQL
+        server built by yourself from source. Normally, it is best to
+        use precompiled binary distributions of MySQL that are built
         specifically for optimal performance on Windows by MySQL AB.
         Instructions for installing a binary distributions are available
         in <xref linkend="windows-installation"/>.

@@ -9329,7 +9329,7 @@
 
         <listitem>
           <para>
-            CMake. It can be downloaded from
+            CMake, which can be downloaded from
             <ulink url="http://www.cmake.org">http://www.cmake.org</ulink>.
             After installing, modify your path to include the cmake
             binary.

@@ -9338,33 +9338,31 @@
 
         <listitem>
           <para>
-            If compiling from from a BitKeeper tree or doing changes to
-            the parser you need <literal>bison</literal> for Windows. It
-            can be downloaded from
-            <ulink
-  url="http://gnuwin32.sourceforge.net/packages/bison.htm">http://gnuwin32.sourceforge.net/packages/bison.htm</ulink>.
-            Download the <literal>Complete package, excluding
-            sources</literal> package. After installing, modify your
-            path to include the <literal>bison</literal> binary and
+            If compiling from from a BitKeeper tree or making changes to
+            the parser you need <literal>bison</literal> for Windows,
+            which can be downloaded from
+            <ulink url="http://gnuwin32.sourceforge.net/packages/bison.htm">http://gnuwin32.sourceforge.net/packages/bison.htm</ulink>.
+            Download the package labelled <quote>Complete package,
+              excluding sources</quote>. After installing, modify your
+            path to include the <command>bison</command> binary and
             ensure that this binary is accessible from Visual Studio.
           </para>
         </listitem>
 
         <listitem>
           <para>
-            Visual C++ 2005 Express Edition, Visual Studio .Net 2003
-            (7.1) or Visual Studio 2005 (8.0) compiler system.
+            Microsoft Visual C++ 2005 Express Edition, Visual Studio
+            .Net 2003 (7.1) or Visual Studio 2005 (8.0) compiler system.
           </para>
         </listitem>
 
         <listitem>
           <para>
-            If you are using Visual C++ 2005 Express Edition you will
-            must install an appropriate Platform SDK. More information
+            If you are using Visual C++ 2005 Express Edition you must
+            also install an appropriate Platform SDK. More information
             and links to downloads for various Windows platforms is
             available from
-            <ulink
-    url="http://msdn.microsoft.com/platformsdk/">http://msdn.microsoft.com/platformsdk/</ulink>.
+            <ulink url="http://msdn.microsoft.com/platformsdk/">http://msdn.microsoft.com/platformsdk/</ulink>.
           </para>
         </listitem>
 

@@ -9376,7 +9374,7 @@
 
         <listitem>
           <para>
-            Windows XP, Windows 2000 or higher.
+            Windows 2000, Windows XP, or newer version.
           </para>
         </listitem>
 

@@ -9407,9 +9405,8 @@
           <para>
             You can package a source distribution yourself from the
             latest BitKeeper developer source tree. For instructions on
-            pulling the latest source files see
-            <xref
-              linkend="installing-source-tree"/>.
+            pulling the latest source files, see
+            <xref linkend="installing-source-tree"/>.
           </para>
         </listitem>
 

@@ -9458,35 +9455,35 @@
             <listitem>
               <para>
                 <literal>WITH_INNOBASE_STORAGE_ENGINE</literal> - Enable
-                the InnoDB storage engine.
+                the <literal>InnoDB</literal> storage engine.
               </para>
             </listitem>
 
             <listitem>
               <para>
                 <literal>WITH_PARTITION_STORAGE_ENGINE</literal> -
-                Enable the Partition storage engine.
+                Enable user-defined partitioning.
               </para>
             </listitem>
 
             <listitem>
               <para>
                 <literal>WITH_ARCHIVE_STORAGE_ENGINE</literal> - Enable
-                the Archive storage engine.
+                the <literal>ARCHIVE</literal> storage engine.
               </para>
             </listitem>
 
             <listitem>
               <para>
                 <literal>WITH_BLACKHOLE_STORAGE_ENGINE</literal> Enable
-                the Blackhole storage engine.
+                the <literal>BLACKHOLE</literal> storage engine.
               </para>
             </listitem>
 
             <listitem>
               <para>
                 <literal>WITH_EXAMPLE_STORAGE_ENGINE</literal> - Enable
-                the Example storage engine.
+                the <literal>EXAMPLE</literal> storage engine.
               </para>
             </listitem>
 

@@ -9499,7 +9496,8 @@
 
             <listitem>
               <para>
-                <literal>__NT__</literal> - Enable named pipe support.
+                <literal>__NT__</literal> - Enable support for named
+                pipes.
               </para>
             </listitem>
 

@@ -9531,8 +9529,7 @@
           </para>
 
 <programlisting>
-win\configure WITH_INNOBASE_STORAGE_ENGINE WITH_PARTITION_STORAGE_ENGINE &raquo;
-   MYSQL_SERVER_SUFFIX=-pro  
+win\configure WITH_INNOBASE_STORAGE_ENGINE WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro  
 </programlisting>
         </listitem>