X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fintro.sgml;h=c00e3e275036d7a48281075ac8f01eb114b97e76;hb=f890314907bc4add4b0f24ad6883da9838a056b7;hp=4ee389efd7bb264db0537600f8b90353c089f74d;hpb=d211aedbcb8ab72a35ec8a457bba2e368da97ba3;p=clsql.git
diff --git a/doc/intro.sgml b/doc/intro.sgml
index 4ee389e..c00e3e2 100644
--- a/doc/intro.sgml
+++ b/doc/intro.sgml
@@ -37,6 +37,9 @@ are:
improved packages and symbol export.
+
+transaction support.
+
@@ -46,15 +49,9 @@ are:
&defsystem;
- &clsql; uses &defsystem to compile and load its
-components. &defsystem; is included in the &clocc; collection. The
-version in the pre-packaged distribution is rather old and
-may not function well. The version in CVS tree tree works quite
-well. For convenience, a copy of the latest &defsystem; at the FTP
-site
-of &clsql;.
+ &clsql; uses &asdf; to compile and load its
+components. &asdf; is included in the &cclan; collection.
@@ -73,26 +70,23 @@ other systems.
- XPTest (optional)
- 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 site.
-This package is not required except if you wish to run the &clsql;
-test suite.
-
-
+
&md5;
+ &clsql;'s postgresql-socket interface uses Pierre Mai's
+ md5 module. If you plan to use
+ this interface please download the md5 module from ftp://clsql.b9.com
Supported Common Lisp Implementation
The implementations that support &clsql; is governed by the supported
-implementations of &uffi;. At the time of the initial release of &clsql;,
-the following implementations are supported:
+implementations of &uffi;. The following implementations are supported:
- &acl; v6.1 on Redhat Linux 7.2 and Microsoft Windows.
- &lw; v4.2 on Redhat Linux 7.2 and Microsoft Windows.
- &cmucl; 18d on Redhat Linux 7.2.
+ &acl; v6.2 on Debian Linux, FreeBSD 4.5, and Microsoft Windows XP.
+ &lw; v4.2 on Debian Linux and Microsoft Windows XP.
+ &cmucl; 18d on Debian Linux, FreeBSD 4.5, and Solaris 2.8.
+ &sbcl; 0.7.14 on Debian Linux.
+ &scl; 1.1 on Debian Linux.
+ &openmcl; 0.13 on Debian Linux PowerPC.
@@ -102,9 +96,9 @@ the following implementations are supported:
Currently, &clsql; supports the following databases:
- &mysql; v3.23.49 on Redhat Linux 7.2 and Microsoft Windows.
- &postgresql; v7.1 on Redhat Linux 7.2. Support for both direct API connections and TCP socket connections.
- Allegro's ODBC interface (&aodbc;) on Redhat Linux 7.2 and Microsoft Windows.
+ &mysql; v3.23.51.
+ &postgresql; v7.2 with both direct API and TCP socket connections.
+ Allegro's ODBC interface (&aodbc;) using iODBC ODBC manager.
@@ -139,7 +133,10 @@ files for Microsoft Windows are supplied with the distribution.
To build the libraries on a GNU or Solaris, use the shell and
change to the root directory of &clsql;. You may need to edit the file
interfaces/mysql/Makefile to specify the location of your
-MySQL installation. Then, you can give the command
+MySQL installation. The default Makefiles are setup for shared library
+linking on Linux. If you are using FreeBSD or Solaris, you will need
+to change the linker setting as instructed in the Makefile.
+Then, you can give the command
make libs
@@ -153,14 +150,28 @@ in the root directory of &clsql; to build the libraries
Load &uffi;
Unzip or untar the &uffi; distribution which creates a directory
-for the &uffi; files. Add that directory to Defsystem's mk:*central-registry*.
-You can do that by either pushing the pathname of the directory onto this variable, or
-use the new add-registry-location present in the newest versions of
-&defsystem;. The following example code assumes the &uffi; files reside in the
-/usr/local/src/lisp/uffi directory.
+for the &uffi; files. Add that directory to Defsystem's asdf:*central-registry*.
+You can do that by pushing the pathname of the directory onto this variable.
+ The following example code assumes the &uffi; files reside in the
+/usr/share/lisp/uffi/ directory.
+
+(push #P"/usr/share/lisp/uffi/" asdf:*central-registry*)
+(asdf:oos 'asdf:load-op :uffi)
+
+
+
+
+ Load &md5; module
+
+ If you plan to use the clsql-postgresql-socket interface, you must load the md5 module.
+ Unzip or untar the cl-md5 distribution, which creates a directory for the cl-md5 files.
+ Add that directory to Defsystem's asdf:*central-registry*.
+ You can do that by pushing the pathname of the directory onto this variable.
+ The following example code assumes the cl-md5 files reside in the
+ /usr/share/lisp/cl-md5/ directory.
-(mk:add-registry-location #P"/usr/local/src/lisp/uffi")
-(mk:load-system :uffi)
+(push #P"/usr/share/lisp/cl-md5/" asdf:*central-registry*)
+(asdf:oos 'asdf:load-op :md5)
@@ -169,23 +180,35 @@ use the new add-registry-location present in the newest ver
Load &clsql; modules
Unzip or untar the &clsql; distribution which creates a directory
-for the &clsql; files. Add that directory to Defsystem's mk:*central-registry*.
-You can do that by either pushing the pathname of the directory onto this variable, or
-use the new add-registry-location present in the newest versions of
-&defsystem;. The following example code assumes the &clsql; files reside in the
-/usr/local/src/lisp/clsql directory. You need to load, at a minimum,
+for the &clsql; files. Add that directory to Defsystem's asdf:*central-registry*.
+You can do that by pushing the pathname of the directory onto this variable.
+ The following example code assumes the &clsql; files reside in the
+/usr/share/lisp/clsql/ directory. You need to load, at a minimum,
the main :clsql system and at least one interface system.
-(mk:add-registry-location #P"/usr/local/src/lisp/clsql")
-(mk:load-system :clsql) ; main clsql package
-(mk:load-system :clsql-mysql) ; MySQL interface
-(mk:load-system :clsql-postgresql) ; PostgreSQL interface
-(mk:load-system :clsql-postgresql-socket) ; Socket PGSQL interface
-(mk:load-system :clsql-aodbc) ; Allegro ODBC interface
+(push #P"/usr/share/lisp/clsql/" asdf:*central-repository*)
+(asdf:oos 'asdf:load-op :clsql-base) ; base clsql package
+(asdf:oos 'asdf:load-op :clsql-mysql) ; MySQL interface
+(asdf:oos 'asdf:load-op :clsql-postgresql) ; PostgreSQL interface
+(asdf:oos 'asdf:load-op :clsql-postgresql-socket) ; Socket PGSQL interface
+(asdf:oos 'asdf:load-op :clsql-aodbc) ; Allegro ODBC interface
+(asdf:oos 'asdf:load-op :clsql) ; main clsql package
+
+ Run test suite
+
+ After loading &clsql;, you can execute the test program in
+the directory ./test-suite. The test file,
+tester-clsql
+has instructions for creating a test.config.
+After creating that file, simple load the test file with Lisp
+and the tests should automatically execute.
+
+
+