X-Git-Url: http://git.kpe.io/?p=clsql.git;a=blobdiff_plain;f=tests%2FREADME;h=d5d78ef546896cf1023a6e00fac88459060fc0b3;hp=c20387ab300b9b9c316d6c423093c4e23e3e8fd9;hb=23a10375f83c89c138369e05c8f57f679bb43ec9;hpb=7f0e4a65d1b425f2fa58fc7cce8296c1a6c52c2f

diff --git a/tests/README b/tests/README
index c20387a..d5d78ef 100644
--- a/tests/README
+++ b/tests/README
@@ -1,3 +1,22 @@
+* RUNNING THE REGRESSION SUITE
+
+This test suite looks for a configuration file named
+".clsql-test.config" located in the users home directory. This file
+contains a single assoc-list that specifies the connection specs for
+each database type to be tested. There is an example file in
+contained in CLSQL's examples directory.
+
+These tests require the downloading of the rt package from
+http://files.b9.com/.
+
+Load clsql.asd or put it somewhere where ASDF can find it
+and call:
+
+(asdf:oos 'asdf:test-op 'clsql)
+
+The test suite will then automatically run on all of the backends that
+you have defined in .clsql-test.config
+
 * REGRESSION TEST SUITE GOALS
 
 The intent of this test suite is to provide sufficient coverage for
@@ -8,7 +27,7 @@ the system to support the following:
 Refactoring and redesign efforts are normally restricted to a single
 subsystem, or perhaps to interdependent subsystems.  In such cases, a
 set of regression tests which excercise the existing interface of the
-rest of USQL to the changing subsystems should be in place and passing
+rest of CLSQL to the changing subsystems should be in place and passing
 before the coding starts.
 
 ** Ensuring portability and Supporting new ports.
@@ -22,9 +41,9 @@ informal coordination between the mintainers of the various ports.
 
 ** Adding new RDBMS backends
 
-The entire USQL DBMS interface needs to be excercised by the test
+The entire CLSQL DBMS interface needs to be excercised by the test
 suite, such that a new RDBMS backend that passes all the tests can be
-reasonably assured of working with the USQL layers above that.  These
+reasonably assured of working with the CLSQL layers above that.  These
 tests should also serve as impromptu documentation for the details of
 that interface and what it expects frothe RDBMS driver layers.
 
@@ -42,7 +61,7 @@ spend finding the bug prior to fixing it.
 
 ** Multiple RDBMS Issues
 
-USQL supports several RDBMS backends, and it should be possible to run
+CLSQL supports several RDBMS backends, and it should be possible to run
 every test against all of them.  However, there are some features
 which we want tests for but which are not implemented on several of
 the backends.  
@@ -107,4 +126,4 @@ will be run.
   *** Object Create/Modification/Deletion in a context -- partly covered already
   *** Interaction of multiple contexts
   *** Schema manipulation within a context
-  *** Rollback and error handling within a context
\ No newline at end of file
+  *** Rollback and error handling within a context