svn commit - mysqldoc@docsrva: r1488 - in trunk: refman-5.1 refman-common

[jon]

Author: jstephens
Date: 2006-03-02 11:58:02 +0100 (Thu, 02 Mar 2006)
New Revision: 1488

Log:

Bug #17501: The TYPE option is restored in 5.1.8 but will be removed in 5.2.



Modified:
   trunk/refman-5.1/sql-syntax.xml
   trunk/refman-common/news-5.1.xml

Modified: trunk/refman-5.1/sql-syntax.xml
===================================================================
--- trunk/refman-5.1/sql-syntax.xml	2006-03-02 10:42:24 UTC (rev 1487)
+++ trunk/refman-5.1/sql-syntax.xml	2006-03-02 10:58:02 UTC (rev 1488)
@@ -2348,6 +2348,20 @@
         &current-series;, a warning occurs if the storage engine
         specification is not honored.
       </para>
+      
+      <para>
+        <emphasis role="bold">Note</emphasis>: The older
+        <literal>TYPE</literal> option was synomous with 
+        <literal>ENGINE</literal>. <literal>TYPE</literal> has been 
+        deprecated since MySQL 4.0 but is still supported for backwards
+        compatibility in MySQL 5.1 (excepting MySQL 5.1.7). Since MySQL
+        5.1.8, it produces a warning. It is scheduled for removal in
+        MySQL 5.2. <emphasis>You should not use <literal>TYPE</literal>
+        in any new applications, and you should immediately begin
+        conversion of existing applications to use
+        <literal>ENGINE</literal> instead</emphasis>. (See
+        <xref linkend="news-5-1-8"/>.)
+      </para>
 
       <para>
         The other table options are used to optimize the behavior of the

Modified: trunk/refman-common/news-5.1.xml
===================================================================
--- trunk/refman-common/news-5.1.xml	2006-03-02 10:42:24 UTC (rev 1487)
+++ trunk/refman-common/news-5.1.xml	2006-03-02 10:58:02 UTC (rev 1488)
@@ -88,6 +88,29 @@
       
       <listitem>
         <para>
+          In order not to break legacy applications, support for
+          <literal>TYPE =
+          <replaceable>engine_name</replaceable></literal> has been
+          restored, but now generates a warning.
+        </para>
+        
+        <para>
+          <emphasis role="bold">Important</emphasis>: This option has
+          been deprecated since MySQL 4.0. <emphasis>Beginning with
+          MySQL 5.2, <literal>TYPE =
+          <replaceable>engine_name</replaceable></literal> will no
+          longer be available and will produce a syntax
+          error</emphasis>. <emphasis>You should not use
+          <literal>TYPE</literal> in any new applications, and you
+          should immediately begin conversion of existing applications
+          to use the <literal>ENGINE =
+          <replaceable>engine_name</replaceable></literal> syntax
+          instead</emphasis>. (Bug #17501)  
+        </para>
+      </listitem>
+      
+      <listitem>
+        <para>
           The <literal>cluster_replication</literal> database has been renamed
           to <literal>cluster</literal>. This will effect replication between
           MySQL Clusters where one cluster is running MySQL 5.1.8 or later, and