List:Internals« Previous MessageNext Message »
From:jon Date:August 6 2005 6:27am
Subject:bk commit - mysqldoc@docsrva tree (jon:1.3186)
View as plain text  
Below is the list of changes that have just been committed into a local
mysqldoc repository of jon. When jon does a push these changes will
be propagated to the main repository and, within 24 hours after the
push, to the public repository.
For information on how to access the public repository
see http://www.mysql.com/doc/I/n/Installing_source_tree.html

ChangeSet
  1.3186 05/08/06 16:27:23 jon@stripped +6 -0
  Documented SHOW TABLE STATUS changes for Cluster in 5.0.3.
  
  Fixed wrong xref and xinclude pointers
  in refman-5.0 files.
  
  Restored missing 5.0 Makefile.

  refman-5.0/Makefile
    1.1 05/08/06 16:27:21 jon@stripped +253 -0
    New BitKeeper file ``refman-5.0/Makefile''

  refman-common/news-5.0.xml
    1.23 05/08/06 16:27:21 jon@stripped +26 -12
    Added info about SHOW TABLE STATUS 
    support in Cluster-5.0.3.

  refman-5.0/sql-syntax.xml
    1.3 05/08/06 16:27:21 jon@stripped +12 -0
    Fixed pointer to wrong news file.
    
    Added info about SHOW TABLE STATUS 
    support in Cluster-5.0.3.

  refman-5.0/news.xml
    1.2 05/08/06 16:27:21 jon@stripped +1 -1
    Fixed pointer to wrong news file.

  refman-5.0/introduction.xml
    1.3 05/08/06 16:27:21 jon@stripped +3 -6
    Fixed pointer to wrong news file.

  refman-5.0/installing.xml
    1.3 05/08/06 16:27:21 jon@stripped +3 -3
    Fixed pointer to wrong news file.

  refman-5.0/Makefile
    1.0 05/08/06 16:27:21 jon@stripped +0 -0
    BitKeeper file /home/jon/bk/mysqldoc/refman-5.0/Makefile

# This is a BitKeeper patch.  What follows are the unified diffs for the
# set of deltas contained in the patch.  The rest of the patch, the part
# that BitKeeper cares about, is below these diffs.
# User:	jon
# Host:	gigan.
# Root:	/home/jon/bk/mysqldoc
--- New file ---
+++ refman-5.0/Makefile	05/08/06 16:27:21
# Makefile for MySQL Reference Manual

# Formats we need for docsrva
# chm
# html-chapter
# html-section
# html-web
# html (using html-dir)
# info
# pdf-a4
# pdf
# txt
# xhtml (using xhtml-dir)
# fragment files

# Location of repository root relative to current directory
REPO_ROOT = ..

# Location of directory containing Makefile components
MAKE_DIR = $(REPO_ROOT)/make.d

all::
	@echo "You must say what you want to do."
	@echo "Some commands supported by this Makefile:"
	@echo "  make clean"
	@echo "  make doc_name.html"
	@echo "  make doc_name.pdf"
	@echo "  make doc_name.txt"

# Dependency list for MySQL Reference Manual

MANUAL_SRCS = \
	manual.xml \
	preface.xml \
	introduction.xml \
	installing.xml \
	tutorial.xml \
	using-mysql-programs.xml \
	mysql-database-administration.xml \
	replication.xml \
	mysql-optimization.xml \
	client-side-scripts.xml \
	language-structure.xml \
	reservedwords.xml \
	charset.xml \
	column-types.xml \
	functions.xml \
	sql-syntax.xml \
	storage-engines.xml \
	innodb.xml \
	ndbcluster.xml \
	images/cluster-components-1.png \
	images/multi-comp-1.png \
	maxdb.xml \
	spatial-extensions-in-mysql.xml \
	stored-procedures.xml \
	triggers.xml \
	views.xml \
	information-schema.xml \
	precision-math.xml \
	mysql-apis.xml \
	mysql-connectors.xml \
	images/myarchitecture.png \
	images/mydsn-icon.png \
	images/mydsn.png \
	images/mydsn-setup.png \
	images/mydsn-example.png \
	images/mydsn-test-success.png \
	images/mydsn-test-fail.png \
	images/mydsn-options.png \
	images/mydsn-icon.png \
	images/mydsn.png \
	images/mydsn-trace.png \
	images/myaccess.png \
	images/myaccess-odbc.png \
	images/mydsn-trace.png \
	images/mydll-properties.png \
	images/mydsn-options.png \
	images/myflowchart.png \
	error-handling.xml \
	errmsgs-server.xml \
	errmsgs-client.xml \
	extending-mysql.xml \
	problems.xml \
	credits.xml \
	news.xml \
	refman-common/news-5.0.xml \
	porting.xml \
	environment-variables.xml \
	regexp.xml \
	limits.xml \
	restrictions.xml \
	refman-common/gpl-license.xml \
	refman-common/mysql-floss-license-exception.xml

manual-prepped.xml: $(MANUAL_SRCS)

# Overrides for generic rules

manual.html-section: manual.html-section.d
	-$(RM) -r $</images
	mkdir $</images
	cp images/*.png $</images
	touch $@

manual.html-chapter: manual.html-chapter.d
	-$(RM) -r $</images
	mkdir $</images
	cp images/*.png $</images
	touch $@

manual.html-web: manual.html-web.d
	-$(RM) -r $</images
	mkdir $</images
	cp images/*.png $</images
	touch $@

manual.html-help: manual.html-help.d
	-$(RM) -r $</images
	mkdir $</images
	cp images/*.png $</images
	touch $@

manual.html-dir: manual.html-dir.d
	-$(RM) -r $</images
	mkdir $</images
	cp images/*.png $</images
	touch $@

manual.xhtml-dir: manual.xhtml-dir.d
	-$(RM) -r $</images
	mkdir $</images
	cp images/*.png $</images
	touch $@

mysql.info: manual.info
	cp manual.info mysql.info

# Fragment files that need to be generated for inclusion with
# MySQL distributions. Most depend on manual.txt, one depends on XML
# sources.

TEXT_FRAGMENT_FILES = \
	INSTALL-SOURCE \
	INSTALL-WIN-SOURCE \
	INSTALL-BINARY \
	COPYING \
	EXCEPTIONS-CLIENT \
	CHANGELOG \
	ReadMe.txt

HTML_FRAGMENT_FILES = \
	ReadMe.html

fragment-files: $(TEXT_FRAGMENT_FILES) $(HTML_FRAGMENT_FILES)

INSTALL-SOURCE: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"Installing MySQL" \
		"MySQL Tutorial" \
		> $@

INSTALL-WIN-SOURCE: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"Installing MySQL from Source on Windows" \
		"Post-Installation Setup and Testing" \
		> $@

INSTALL-BINARY: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"Installing MySQL on Other Unix-Like Systems" \
		"MySQL Installation Using a Source Distribution" \
		> $@

COPYING: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"GNU General Public License" \
		"MySQL FLOSS License Exception" \
		> $@

EXCEPTIONS-CLIENT: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"MySQL FLOSS License Exception" \
		> $@

CHANGELOG: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"MySQL Change History" \
		"Porting to Other Systems" \
		> $@

ReadMe.txt: manual.txt $(GT)
	perl -w $(GT) manual.txt \
		"Installing MySQL on Mac OS X" \
		"Installing MySQL on NetWare" \
		> $@

ReadMe.html: $(MANUAL_SRCS)
	$(CHAPTERFMT) --no-rebuild mac-os-x-installation.html
	mv mac-os-x-installation.html ReadMe.html
	#$(RM) mac-os-x-installation.*

clean::
	$(RM) $(TEXT_FRAGMENT_FILES)
	$(RM) $(HTML_FRAGMENT_FILES)
	$(RM) manual.txt

# Manual page generation
# "manual.man" target processes manual.xml and generates a bunch of
# xxx.man files in the current directory. These get copied to the
# manpages.d directory and post-processed by fix-manpages.pl.

.PRECIOUS: manpages.d

manpages: manpages.d
	touch $@

manpages.d: manual.man
	-$(RM) -r $@
	mkdir $@
	$(FIX_MANPAGES) --destdir=manpages.d *.man

clean::
	$(RM) *.man man
	$(RM) -r *.man manpages manpages.d

# Import standard variables and target rules

# Need xml-html-dir for formatting the manual itself into a subdir,
# but also need xml-html for formatting ReadMe.html

include $(MAKE_DIR)/vars-layout
include $(MAKE_DIR)/vars-shell
include $(MAKE_DIR)/vars-docbook
include $(MAKE_DIR)/xml-valid
include $(MAKE_DIR)/xml-format
include $(MAKE_DIR)/xml-useless
include $(MAKE_DIR)/xml-prep
include $(MAKE_DIR)/xml-html
include $(MAKE_DIR)/xml-html-dir
include $(MAKE_DIR)/xml-html-section
include $(MAKE_DIR)/xml-html-chapter
include $(MAKE_DIR)/xml-html-web
include $(MAKE_DIR)/xml-html-help
include $(MAKE_DIR)/xml-xhtml-dir
include $(MAKE_DIR)/xml-pdf
include $(MAKE_DIR)/xml-txt
include $(MAKE_DIR)/xml-texi
include $(MAKE_DIR)/texi-info
include $(MAKE_DIR)/xml-toc

CHAPTERFMT = ./chapterfmt.pl
GT = $(TOOLS_DIR)/generate-text-files.pl


--- 1.22/refman-common/news-5.0.xml	2005-08-06 08:55:12 +10:00
+++ 1.23/refman-common/news-5.0.xml	2005-08-06 16:27:21 +10:00
@@ -4688,22 +4688,22 @@
 
       <listitem>
         <para>
-          InnoDB: Introduced a compact record format that does not store
-          the number of columns or the lengths of fixed-size columns.
-          The old format can be requested by specifying
-          <literal>ROW_FORMAT=REDUNDANT</literal>. The new format
-          (<literal>ROW_FORMAT=COMPACT</literal>) is the default. The
-          new format typically saves 20 % of disk space and memory.
+          <literal>InnoDB</literal>: Introduced a compact record format 
+          that does not store the number of columns or the lengths of 
+          fixed-size columns. The old format can be requested by 
+          specifying <literal>ROW_FORMAT=REDUNDANT</literal>. The new 
+          format (<literal>ROW_FORMAT=COMPACT</literal>) is the default. 
+          The new format typically saves 20 % of disk space and memory.
         </para>
       </listitem>
 
       <listitem>
         <para>
-          InnoDB: Setting the initial <literal>AUTO_INCREMENT</literal>
-          value for an <literal>InnoDB</literal> table using
-          <literal>CREATE TABLE ... AUTO_INCREMENT =
-          <replaceable>n</replaceable></literal> now works, and
-          <literal>ALTER TABLE ... AUTO_INCREMENT =
+          <literal>InnoDB</literal>: Setting the initial 
+          <literal>AUTO_INCREMENT</literal> value for an 
+          <literal>InnoDB</literal> table using <literal>CREATE TABLE 
+          ... AUTO_INCREMENT = <replaceable>n</replaceable></literal> 
+          now works, and <literal>ALTER TABLE ... AUTO_INCREMENT =
           <replaceable>n</replaceable></literal> resets the current
           value.
         </para>
@@ -4850,7 +4850,21 @@
           so you can't replicate such statements from a 5.0.3 master to
           pre-5.0.3 slaves.
         </para>
-      </listitem>
+        </listitem>
+  
+        <listitem>
+          <para>
+            <literal>NDB Cluster</literal>: When using this storage 
+            engine, the output of <literal>SHOW TABLE STATUS</literal> 
+            now displays properly-calculated values in the 
+            <literal>Avg_row_length</literal> and 
+            <literal>Data_length</literal> columns. (Note that 
+            <literal>BLOB</literal> columns are not yet taken into 
+            account.) In addition, the number of replicas is now shown 
+            in the <literal>Comment</literal> column (as 
+            <literal>number_of_replicas</literal>).
+          </para>
+        </listitem>
 
     </itemizedlist>
 

--- 1.2/refman-5.0/installing.xml	2005-08-06 08:55:11 +10:00
+++ 1.3/refman-5.0/installing.xml	2005-08-06 16:27:21 +10:00
@@ -12057,9 +12057,9 @@
 
         <listitem>
           <para>
-            Read the MySQL 5.1 change history to see what significant 
-            new features you can use in 5.1. See
-            <xref linkend="news-5-1-x"/>.
+            Read the MySQL 5.0 change history to see what significant 
+            new features you can use in 5.0. See
+            <xref linkend="news-5-0-x"/>.
           </para>
         </listitem>
 

--- 1.2/refman-5.0/introduction.xml	2005-08-06 08:55:11 +10:00
+++ 1.3/refman-5.0/introduction.xml	2005-08-06 16:27:21 +10:00
@@ -1795,11 +1795,8 @@
 
     <para>
       Active MySQL development currently is taking place in the MySQL
-      5.1 release series, this means that new features are being added
-      there.
-
-<!--
-   MySQL 5.1 is available in alpha status.
+      5.0 release series, this means that new features are being added
+      there. Currently, MySQL 5.1 is available in alpha status.
    -->
     </para>
 
@@ -1987,7 +1984,7 @@
 
       <para>
         The News section of this manual includes a more in-depth list of
-        features. See <xref linkend="news-5-1-x"/>.
+        features. See <xref linkend="news-5-0-x"/>.
       </para>
 
       <para>

--- 1.1/refman-5.0/news.xml	2005-08-06 03:11:26 +10:00
+++ 1.2/refman-5.0/news.xml	2005-08-06 16:27:21 +10:00
@@ -70,7 +70,7 @@
       entity reference in titles.ent and use this for the title text.
 -->
 
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="refman-common/news-5.1.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="refman-common/news-5.0.xml"/>
 
 
   <section id="myodbc-news">

--- 1.2/refman-5.0/sql-syntax.xml	2005-08-06 08:55:12 +10:00
+++ 1.3/refman-5.0/sql-syntax.xml	2005-08-06 16:27:21 +10:00
@@ -14350,8 +14350,20 @@
           TABLE</literal>, but provides a lot of information about each
           table. You can also get this list using the <command>mysqlshow
           --status <replaceable>db_name</replaceable></command> command.
+        </para>
+        <para>
           As of MySQL 5.0.1, this statement also displays information
           about views.
+        </para>
+        <para>
+          Beginning with MySQL 5.0.3, for <literal>NDB Cluster</literal> 
+          tables, the output of this statement shows appropriate values 
+          for the <literal>Avg_row_length</literal> and 
+          <literal>Data_length</literal> columns, with the exception 
+          that <literal>BLOB</literal> columns are not yet taken into 
+          account. In addition, the number of replicas is now shown 
+          in the <literal>Comment</literal> column (as 
+          <literal>number_of_replicas</literal>).
         </para>
 
         <para>
Thread
bk commit - mysqldoc@docsrva tree (jon:1.3186)jon6 Aug