r1779: *** empty log message ***
authorKevin M. Rosenberg <kevin@rosenberg.net>
Wed, 10 Apr 2002 04:57:28 +0000 (04:57 +0000)
committerKevin M. Rosenberg <kevin@rosenberg.net>
Wed, 10 Apr 2002 04:57:28 +0000 (04:57 +0000)
doc/intro.sgml
test-suite/tester-clsql.cl

index c7b2d18a1c9fa04e266283e69db6ff218b7e5550..5f0b76b81fb91fc1f413a324b83574d6d99b0d3e 100644 (file)
@@ -72,16 +72,6 @@ are zip files for Microsoft Windows systems and gzipped tar files for
 other systems.</para>
     </sect2>
 
-    <sect2>
-      <title>XPTest (optional)</title>
-      <para>The test suite for &clsql; uses the onShore Development's
-XPTest package. onShore has graciously put the package in the public
-domain. You can download the package from onShore's web <ulink
-url="http://alpha.onshored.com/lisp-software/"><citetitle>site</citetitle></ulink>.
-This package is not required except if you wish to run the &clsql;
-test suite.</para>
-    </sect2>
-
     <sect2>
       <title>Supported Common Lisp Implementation</title>
       <para>
@@ -188,6 +178,18 @@ the main <symbol>:clsql</symbol> system and at least one interface system.
       </para>
     </sect2>
 
+    <sect2>
+      <title>Run test suite</title>
+      <para>
+       After loading &clsql;, you can execute the test program in
+the directory <filename>./test-suite</filename>. The test file,
+<filename>tester-clsql</filename>
+has instructions for creating a <filename>test.config</filename>.
+After creating that file, simple load the test file with Lisp
+and the tests should automatically execute.
+      </para>
+    </sect2>
+
   </sect1>
 
 </chapter>
index bcc7f6d539f79c0e6fff4f7c9cf7664cb36aa5df..f3e6bef7f4dcf0dce5429e7527a0e1b586345e2a 100644 (file)
@@ -7,7 +7,7 @@
 ;;;; Programmer:    Kevin M. Rosenberg
 ;;;; Date Started:  Mar 2002
 ;;;;
-;;;; $Id: tester-clsql.cl,v 1.3 2002/04/08 03:50:00 kevin Exp $
+;;;; $Id: tester-clsql.cl,v 1.4 2002/04/10 04:57:28 kevin Exp $
 ;;;;
 ;;;; This file, part of CLSQL, is Copyright (c) 2002 by Kevin M. Rosenberg
 ;;;;
 ;;;; (http://opensource.franz.com/preamble.html), also known as the LLGPL.
 ;;;; *************************************************************************
 
+;;; This test suite looks for a configuration file named "test.config"
+;;; This file contains a single a-list that specifies the connection
+;;; specs for each database type to be tested. For example, to test all
+;;; platforms, a sample "test.config" may look like:
+;;;
+;;; ((:mysql ("localhost" "a-mysql-db" "user1" "secret"))
+;;;  (:aodbc ("my-dsn" "a-user" "pass"))
+;;;  (:paostgresql ("localhost" "another-db" "user2" "dont-tell"))
+;;;  (:postgresql-socket ("pg-server" "a-db-name" "user" "secret-password")))
+
+
 (declaim (optimize (debug 3) (speed 3) (safety 1) (compilation-speed 0)))
 (in-package :cl-user)