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; — after all, it was your
idea.
- </para>
+ </para-->
+
+ <para>
+ You have a chance to help create an important piece of
+ MySQL documentation — 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/userguide | plavin | 17 Sep |