svn commit - mysqldoc@docsrva: r8555 - in trunk: . dynamic-docs/changelog mysqltest

[paul]

Author: paul
Date: 2007-11-06 18:17:53 +0100 (Tue, 06 Nov 2007)
New Revision: 8555

Log:
 r32399@polar:  paul | 2007-11-06 11:13:26 -0600
 mysql-test-run.pl now allows suite name prefix in test name arguments.
 (Bug#31400)


Modified:
   trunk/dynamic-docs/changelog/mysqld.xml
   trunk/mysqltest/programs.xml

Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:32366
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:26562
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:32399
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:26562
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-11-06 16:29:54 UTC (rev 8554)
+++ trunk/dynamic-docs/changelog/mysqld.xml	2007-11-06 17:17:53 UTC (rev 8555)
Changed blocks: 1, Lines Added: 30, Lines Deleted: 0; 1120 bytes

@@ -141449,4 +141449,34 @@
 
   </logentry>
 
+  <logentry entrytype="feature">
+
+    <tags>
+      <manual type="mysql-test-run.pl"/>
+    </tags>
+
+    <bugs>
+      <fixes bugid="31400"/>
+    </bugs>
+
+    <versions>
+      <version ver="5.1.23"/>
+    </versions>
+
+    <message>
+
+      <para>
+        <command>mysql-test-run.pl</command> now allows a suite name
+        prefix to be specified in command-line arguments that name test
+        cases. The test name syntax now is
+       
<literal>[<replaceable>suite_name</replaceable>.]<replaceable>test_name</replaceable>[.<replaceable>suffix</replaceable>]</literal>.
+        For example, <command>mysql-test-run.pl binlog.mytest</command>
+        runs the <filename>mytest.test</filename> test in the
+        <literal>binlog</literal> test suite.
+      </para>
+
+    </message>
+
+  </logentry>
+
 </changelog>


Modified: trunk/mysqltest/programs.xml
===================================================================
--- trunk/mysqltest/programs.xml	2007-11-06 16:29:54 UTC (rev 8554)
+++ trunk/mysqltest/programs.xml	2007-11-06 17:17:53 UTC (rev 8555)
Changed blocks: 1, Lines Added: 38, Lines Deleted: 0; 2116 bytes

@@ -1566,6 +1566,44 @@
         </para>
 
         <para>
+          If no suffix is given for the test name, a suffix of
+          <filename>.test</filename> is assumed. Any leading pathname is
+          ignored. These commands are equivalent:
+        </para>
+
+<programlisting>
+shell&gt; <userinput>mysql-test-run.pl mytest</userinput>
+shell&gt; <userinput>mysql-test-run.pl mytest.test</userinput>
+shell&gt; <userinput>mysql-test-run.pl t/mytest.test</userinput>
+</programlisting>
+
+        <para>
+          As of MySQL 5.1.23, a suite name can be given as part of the
+          test name. That is, the syntax for naming a test is:
+        </para>
+
+<programlisting>
+[<replaceable>suite_name</replaceable>.]<replaceable>test_name</replaceable>[.<replaceable>suffix</replaceable>]
+</programlisting>
+
+        <para>
+          If a suite name is given, <command>mysql-test-run.pl</command>
+          looks in that suite for the test. With no suite name,
+          <command>mysql-test-run.pl</command> looks in the default list
+          of suites for a match and runs the test in any suites where it
+          finds the test. Suppose that the default suite list is
+          <literal>main</literal>, <literal>binlog</literal>,
+          <literal>rpl</literal>, and that a test
+          <filename>mytest.test</filename> exists in the
+          <literal>main</literal> and <literal>rpl</literal>
suites.
+          With an argument of <literal>mytest</literal> or
+          <literal>mytest.test</literal>,
+          <command>mysql-test-run.pl</command> will run
+          <filename>mytest.test</filename> from the
+          <literal>main</literal> and <literal>rpl</literal>
suites.
+        </para>
+
+        <para>
           To run a family of test cases for which the names share a
           common prefix, use the
          
<option>--do-test=<replaceable>prefix</replaceable></option>