List:Commits« Previous MessageNext Message »
From:paul Date:November 9 2007 8:17pm
Subject:svn commit - mysqldoc@docsrva: r8636 - in trunk: . mysqltest
View as plain text  
Author: paul
Date: 2007-11-09 21:17:41 +0100 (Fri, 09 Nov 2007)
New Revision: 8636

Log:
 r32590@polar:  paul | 2007-11-09 14:16:50 -0600
 Add test case naming conventions for usernames, database names. (Ingo)


Modified:
   trunk/mysqltest/tutorial.xml

Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:32587
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:26803
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:32590
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:26803
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:21581


Modified: trunk/mysqltest/tutorial.xml
===================================================================
--- trunk/mysqltest/tutorial.xml	2007-11-09 19:31:04 UTC (rev 8635)
+++ trunk/mysqltest/tutorial.xml	2007-11-09 20:17:41 UTC (rev 8636)
Changed blocks: 1, Lines Added: 27, Lines Deleted: 4; 1955 bytes

@@ -506,16 +506,39 @@
 
       <para>
         It is possible to run test cases against a production server.
-        (Generally, we will not do that, but our customers might.) To
-        reduce the risk that running the test suite alters or destroys
-        important tables, views, or other objects, you should create
-        them using the following naming conventions:
+        (Generally, we will not do that, but our customers might,
+        perhaps accidentally.) Try to write test cases in a way that
+        reduces the risk that running tests will alter or destroy
+        important tables, views, or other objects. (<literal>DROP
+        DATABASE</literal> statements are particularly dangerous if
+        written using names that could exist on a customer's machine.)
+        To avoid such problems, you should use the following naming
+        conventions:
       </para>
 
       <itemizedlist>
 
         <listitem>
           <para>
+            Usernames: Usernames should begin with <quote>mysql</quote>
+            (for example, <literal>mysqluser1</literal>,
+            <literal>mysqluser2</literal>)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Database names: For tests that need to operate outside the
+            <literal>test</literal> database, database names should
+            contain <quote>test</quote> and/or begin with
+            <quote>mysql</quote> (for example,
+            <literal>mysqltest1</literal>,
+            <literal>mysqltest2</literal>)
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
             Table names: <literal>t1</literal>, <literal>t2</literal>,
             <literal>t3</literal>, ...
           </para>


Thread
svn commit - mysqldoc@docsrva: r8636 - in trunk: . mysqltestpaul9 Nov