Author: paul
Date: 2007-10-29 21:07:10 +0100 (Mon, 29 Oct 2007)
New Revision: 8395
Log:
r31931@polar: paul | 2007-10-29 15:06:48 -0500
Documented bugfixes:
Bug#30164: Using client side macro inside server side comments generates broken queries
Modified:
trunk/dynamic-docs/changelog/mysqld.xml
trunk/refman-4.1/client-utility-programs.xml
trunk/refman-4.1/language-structure.xml
trunk/refman-5.0/client-utility-programs.xml
trunk/refman-5.0/language-structure.xml
trunk/refman-5.1/client-utility-programs.xml
trunk/refman-5.1/language-structure.xml
trunk/refman-5.2/client-utility-programs.xml
trunk/refman-5.2/language-structure.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:31929
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:26290
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:21581
+ 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:31931
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:26290
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:21581
Modified: trunk/dynamic-docs/changelog/mysqld.xml
===================================================================
--- trunk/dynamic-docs/changelog/mysqld.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/dynamic-docs/changelog/mysqld.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 1, Lines Added: 33, Lines Deleted: 0; 1142 bytes
@@ -139163,4 +139163,37 @@
</logentry>
+ <logentry entrytype="bug">
+
+ <tags>
+ <manual type="parser"/>
+ <manual type="comments"/>
+ <manual type="mysql commands"/>
+ </tags>
+
+ <bugs>
+ <fixes bugid="30164"/>
+ </bugs>
+
+ <versions>
+ <version ver="5.0.50"/>
+ <version ver="5.1.23"/>
+ </versions>
+
+ <message>
+
+ <para>
+ Short-format <command>mysql</command> commands embedded within
+ <literal>/*! ... */</literal> comments were parsed incorrectly
+ by <command>mysql</command>, which discarded the rest of the
+ comment including the terminating <literal>*/</literal>
+ characters. The result was a malformed (unclosed) comment. Now
+ <command>mysql</command> does not discard the
+ <literal>*/</literal> characters.
+ </para>
+
+ </message>
+
+ </logentry>
+
</changelog>
Modified: trunk/refman-4.1/client-utility-programs.xml
===================================================================
--- trunk/refman-4.1/client-utility-programs.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-4.1/client-utility-programs.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 1, Lines Added: 5, Lines Deleted: 0; 705 bytes
@@ -5479,6 +5479,11 @@
</para>
<para>
+ The use of short-form commands within multi-line <literal>/*
+ ... */</literal> comments is not supported.
+ </para>
+
+ <para>
If you provide an argument to the <literal>help</literal>
command, <command>mysql</command> uses it as a search string
to access server-side help from the contents of the MySQL
Modified: trunk/refman-4.1/language-structure.xml
===================================================================
--- trunk/refman-4.1/language-structure.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-4.1/language-structure.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 2, Lines Added: 12, Lines Deleted: 0; 917 bytes
@@ -2141,6 +2141,10 @@
</programlisting>
<para>
+ Nested comments are not supported.
+ </para>
+
+ <para>
MySQL Server supports some variants of C-style comments. These
enable you to write code that includes MySQL extensions, but is
still portable, by using comments of the following form:
@@ -2212,6 +2216,14 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ The use of short-form commands such as <literal>\C</literal>
+ within multi-line <literal>/* ... */</literal> comments is not
+ supported.
+ </para>
+ </listitem>
+
</itemizedlist>
<indexterm>
Modified: trunk/refman-5.0/client-utility-programs.xml
===================================================================
--- trunk/refman-5.0/client-utility-programs.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-5.0/client-utility-programs.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 1, Lines Added: 5, Lines Deleted: 0; 705 bytes
@@ -5582,6 +5582,11 @@
</para>
<para>
+ The use of short-form commands within multi-line <literal>/*
+ ... */</literal> comments is not supported.
+ </para>
+
+ <para>
If you provide an argument to the <literal>help</literal>
command, <command>mysql</command> uses it as a search string
to access server-side help from the contents of the MySQL
Modified: trunk/refman-5.0/language-structure.xml
===================================================================
--- trunk/refman-5.0/language-structure.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-5.0/language-structure.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 2, Lines Added: 10, Lines Deleted: 0; 866 bytes
@@ -2286,6 +2286,10 @@
</programlisting>
<para>
+ Nested comments are not supported.
+ </para>
+
+ <para>
MySQL Server supports some variants of C-style comments. These
enable you to write code that includes MySQL extensions, but is
still portable, by using comments of the following form:
@@ -2329,6 +2333,12 @@
line.)
</para>
+ <para>
+ The use of short-form <command>mysql</command> commands such as
+ <literal>\C</literal> within multi-line <literal>/* ...
+ */</literal> comments is not supported.
+ </para>
+
</section>
</chapter>
Modified: trunk/refman-5.1/client-utility-programs.xml
===================================================================
--- trunk/refman-5.1/client-utility-programs.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-5.1/client-utility-programs.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 1, Lines Added: 5, Lines Deleted: 0; 705 bytes
@@ -5632,6 +5632,11 @@
</para>
<para>
+ The use of short-form commands within multi-line <literal>/*
+ ... */</literal> comments is not supported.
+ </para>
+
+ <para>
If you provide an argument to the <literal>help</literal>
command, <command>mysql</command> uses it as a search string
to access server-side help from the contents of the MySQL
Modified: trunk/refman-5.1/language-structure.xml
===================================================================
--- trunk/refman-5.1/language-structure.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-5.1/language-structure.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 2, Lines Added: 10, Lines Deleted: 0; 866 bytes
@@ -2633,6 +2633,10 @@
</programlisting>
<para>
+ Nested comments are not supported.
+ </para>
+
+ <para>
MySQL Server supports some variants of C-style comments. These
enable you to write code that includes MySQL extensions, but is
still portable, by using comments of the following form:
@@ -2676,6 +2680,12 @@
line.)
</para>
+ <para>
+ The use of short-form <command>mysql</command> commands such as
+ <literal>\C</literal> within multi-line <literal>/* ...
+ */</literal> comments is not supported.
+ </para>
+
</section>
</chapter>
Modified: trunk/refman-5.2/client-utility-programs.xml
===================================================================
--- trunk/refman-5.2/client-utility-programs.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-5.2/client-utility-programs.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 1, Lines Added: 5, Lines Deleted: 0; 705 bytes
@@ -5624,6 +5624,11 @@
</para>
<para>
+ The use of short-form commands within multi-line <literal>/*
+ ... */</literal> comments is not supported.
+ </para>
+
+ <para>
If you provide an argument to the <literal>help</literal>
command, <command>mysql</command> uses it as a search string
to access server-side help from the contents of the MySQL
Modified: trunk/refman-5.2/language-structure.xml
===================================================================
--- trunk/refman-5.2/language-structure.xml 2007-10-29 19:51:04 UTC (rev 8394)
+++ trunk/refman-5.2/language-structure.xml 2007-10-29 20:07:10 UTC (rev 8395)
Changed blocks: 2, Lines Added: 10, Lines Deleted: 0; 866 bytes
@@ -2633,6 +2633,10 @@
</programlisting>
<para>
+ Nested comments are not supported.
+ </para>
+
+ <para>
MySQL Server supports some variants of C-style comments. These
enable you to write code that includes MySQL extensions, but is
still portable, by using comments of the following form:
@@ -2676,6 +2680,12 @@
line.)
</para>
+ <para>
+ The use of short-form <command>mysql</command> commands such as
+ <literal>\C</literal> within multi-line <literal>/* ...
+ */</literal> comments is not supported.
+ </para>
+
</section>
</chapter>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r8395 - in trunk: . dynamic-docs/changelog refman-4.1 refman-5.0 refman-5.1 refman-5.2 | paul | 29 Oct |
