List:Commits« Previous MessageNext Message »
From:plavin Date:September 17 2007 8:22pm
Subject:svn commit - mysqldoc@docsrva: r7879 - trunk/userguide
View as plain text  
Author: plavin
Date: 2007-09-17 22:22:38 +0200 (Mon, 17 Sep 2007)
New Revision: 7879

Log:
Clean up, remove some sections


Modified:
   trunk/userguide/about.xml
   trunk/userguide/installing.xml
   trunk/userguide/mysql-client-programs.xml
   trunk/userguide/mysql-server-programs.xml
   trunk/userguide/storage-engines.xml
   trunk/userguide/userguide.xml


Modified: trunk/userguide/about.xml
===================================================================
--- trunk/userguide/about.xml	2007-09-17 16:18:57 UTC (rev 7878)
+++ trunk/userguide/about.xml	2007-09-17 20:22:38 UTC (rev 7879)
Changed blocks: 3, Lines Added: 20, Lines Deleted: 13; 1949 bytes

@@ -123,10 +123,10 @@
     <para>
       The idea for a &userguide; came about as a response to the
       expressed needs of MySQL users and especially community comments
-      about the manuals. Find below some of those comments:
+      about the manuals. 
     </para>
 
-    <itemizedlist>
+    <!--itemizedlist>
 
       <listitem>
         <para>

@@ -229,16 +229,18 @@
         and now we would like you to respond to our request to
         help create a &userguide; &mdash; after all, it was your
         idea.
-       </para>
+       </para-->
+    
+     <para>
+       You have a chance to help create an important piece of 
+       MySQL documentation &mdash; The MySQL User Guide.
+       Part of the reason for the success of
+       open source projects is because 
+       submissions come from a variety of sources.
+       Help improve MySQL documentation by making a contribution.
+     </para>
 
       <para>
-        Part of the reason for the success of
-        open source projects is because 
-        submissions come from a variety of sources.
-        Help improve MySQL documentation by making a contribution.
-      </para>
-
-      <para>
         Contributors will receive credit for their submissions.
         For an example attribution see
         <xref linkend="userguide-mysql-client"/>.

@@ -418,9 +420,14 @@
         please see the MySQL Style Guide. [Link to be
         provided shortly.]
       </para>
-
-    </section>
-
+      
+      <para>
+        This publication is licenced under the GNU Free Documentation License
+        (GFDL). Any submissions are subject to the conditions outlined in this licence.
+        A copy is included in <xref linkend="gfdl"/>.
+      </para>
+      
+    </section>   
     
 
   </section>


Modified: trunk/userguide/installing.xml
===================================================================
--- trunk/userguide/installing.xml	2007-09-17 16:18:57 UTC (rev 7878)
+++ trunk/userguide/installing.xml	2007-09-17 20:22:38 UTC (rev 7879)
Changed blocks: 3, Lines Added: 4, Lines Deleted: 4; 791 bytes

@@ -71,13 +71,13 @@
       section that follows.
     </para>
 
-    <section id="installing-downloading-windows">
+    <!--section id="installing-downloading-windows">
 
       <title>Downloading MySQL for Microsoft Windows</title>
 
       <para></para>
 
-    </section>
+    </section-->
 
 <!-- END WINDOWS DOWNLOAD -->
 

@@ -99,7 +99,7 @@
 
     </section>
 
-    <section>
+    <!--section>
       
       <title>Checklist If Installer/RPM Not Used</title>
       

@@ -129,7 +129,7 @@
         
       </section>
       
-    </section>
+    </section-->
 
   </section>
 


Modified: trunk/userguide/mysql-client-programs.xml
===================================================================
--- trunk/userguide/mysql-client-programs.xml	2007-09-17 16:18:57 UTC (rev 7878)
+++ trunk/userguide/mysql-client-programs.xml	2007-09-17 20:22:38 UTC (rev 7879)
Changed blocks: 4, Lines Added: 6, Lines Deleted: 6; 1426 bytes

@@ -15,7 +15,7 @@
     
     <title>The MySQL Client Programs</title>
     
-    <para>
+    <!--para>
       promised not to mention OS-specific commands but if you are
       working on the a Unix platform you will want to refer to the
       manual and find out more about the <command>system</command> and

@@ -30,8 +30,8 @@
       passing arguments at the command line is cumbersome as with other
       utilities we'll see how common or default options can be added to
       a configuration file
-    </para>
-    
+      </para-->
+    <para></para>
   </section>
   
   <!-- End mysql client -->

@@ -50,7 +50,7 @@
         For more information see <ulink url="http://mysql.com"/>.
       </para>
       
-    </formalpara>  
+    </formalpara>
 
     <para>
       A number of client programs are packaged with the MySQL RDMS.

@@ -180,12 +180,12 @@
         <option>--port</option> options.
       </para>
       
-      <note>
+      <!--note>
         <para>
           When connecting to a MySQL server running on a Unix
           machine ...
         </para>
-      </note>
+      </note-->
 
       <para>
         Since the <command>mysql</command> client program gives access


Modified: trunk/userguide/mysql-server-programs.xml
===================================================================
--- trunk/userguide/mysql-server-programs.xml	2007-09-17 16:18:57 UTC (rev 7878)
+++ trunk/userguide/mysql-server-programs.xml	2007-09-17 20:22:38 UTC (rev 7879)
Changed blocks: 6, Lines Added: 17, Lines Deleted: 13; 2860 bytes

@@ -86,7 +86,7 @@
 
       <listitem>
         <para>
-          <option>skip_show_databases</option>
+          <option>--skip_show_databases</option>
         </para>
       </listitem>
 

@@ -114,7 +114,7 @@
       digit day of the month and a four digit year separated by a
       forward slash use the following option:
       <literal>--date-format=`%m/%d/%Y`</literal>. For all the legal
-      formats see the xref ...
+      formats see <xref linkend="userguide-date-format-specifiers"/>.
     </para>
 
     <para>

@@ -135,10 +135,10 @@
       disable it.
     </para>
 
-    <para>
+    <!--para>
       server variables ======================== showing system vars h/t
       to check the user that mysqld is running as
-    </para>
+    </para-->
 
   </section>
 

@@ -162,14 +162,17 @@
     </para>
 
     <para>
-      Options in /etc/my.cnf and $MYSQL_HOME/my.cnf are processed before
-      command-line options, so it is recommended that you put a --user
-      option in /etc/my.cnf and specify a value other than root. The
-      option in /etc/my.cnf is found before any other --user options,
+      Options in <filename>/etc/my.cnf</filename> and 
+      <filename>$MYSQL_HOME/my.cnf</filename> are processed before
+      command-line options, so it is recommended that you put a <option>--user</option>
+      option in the configuration file and specify a value other than root. The
+      option in the configuration file is found before any other <option>--user</option> options,
       which ensures that the server runs as a user other than root, and
-      that a warning results if any other --user option is found. above
-      from
+      that a warning results if any other <option>--user</option> option is found. 
+      <remark>[PL]
+      Above from
       http://dev.mysql.com/doc/refman/5.0/en/server-options.html#optvar_user
+      </remark>
     </para>
 
     <para>

@@ -199,7 +202,7 @@
 
     <title>Changing Your Configuration File</title>
 
-    <para>
+    <!--para>
       This section shows a sample configuration file for the purpose of
       simplifying your interaction with MySQL and alerting you to some
       common settings that you may want to adjust. You have already

@@ -265,13 +268,14 @@
     <para>
       suppose that you incorrectly
       specify<literal>skip-show-databases</literal> rather than
-      <literal>skip-show-database</literal> you will gat a warning such
+      <literal>skip-show-database</literal> you will get a warning such
       as <literal>mysqld ended</literal>
     </para>
 
     <para>
       !includedir
-    </para>
+      </para-->
+    <para></para>
 
   </section>
 


Modified: trunk/userguide/storage-engines.xml
===================================================================
--- trunk/userguide/storage-engines.xml	2007-09-17 16:18:57 UTC (rev 7878)
+++ trunk/userguide/storage-engines.xml	2007-09-17 20:22:38 UTC (rev 7879)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 24; 748 bytes

@@ -5,34 +5,11 @@
 
   <title>MySQL Storage Engines</title>
 
-  <section id="storage-engines-myisam">
+  
 
-    <title>The MyISAM Storage Engine</title>
-
     <para></para>
 
-  </section>
 
-<!-- END MYISAM -->
-
-  <section id="storage-engines-innodb">
-
-    <title>The InnoDB Storage Engine</title>
-
-    <para></para>
-
-  </section>
-
-<!-- END TYPES -->
-
-  <section id="storage-engines-other">
-
-    <title>Other Storage Engines</title>
-
-    <para></para>
-
-  </section>
-
 <!-- END OTHER -->
 
 </chapter>


Modified: trunk/userguide/userguide.xml
===================================================================
--- trunk/userguide/userguide.xml	2007-09-17 16:18:57 UTC (rev 7878)
+++ trunk/userguide/userguide.xml	2007-09-17 20:22:38 UTC (rev 7879)
Changed blocks: 2, Lines Added: 5, Lines Deleted: 2; 765 bytes

@@ -520,10 +520,11 @@
 
         <title>Advanced Features of Previously Mentioned Utilities</title>
 
-        <para>
+        <!--para>
           using compression with mysqldump using FOREIGN_KEY_CHECKS with
           dump files
-        </para>
+          </para-->
+        <para></para>
 
       </section>
 

@@ -711,6 +712,8 @@
     </appendix>
 
     <xi:include href="glossary.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    
+    <xi:include href="gnu-fdl.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
   </part>
 
 </book>


Thread
svn commit - mysqldoc@docsrva: r7879 - trunk/userguideplavin17 Sep