X-Git-Url: http://git.kpe.io/?p=clsql.git;a=blobdiff_plain;f=doc%2Fintro.xml;h=465c95f7ea3317a89f9238724c6d396d221969af;hp=7b7dec07c67adb0159fc335995a933898c9bffa9;hb=fd2493718d0e1114fcbe3dd578dab658ea383e81;hpb=a45ef0dbfaf9b1d726380561d8e4da9305a5895e diff --git a/doc/intro.xml b/doc/intro.xml index 7b7dec0..465c95f 100644 --- a/doc/intro.xml +++ b/doc/intro.xml @@ -14,7 +14,7 @@ linkend="gloss-sql">SQL databases. A number of Common Lisp implementations and SQL databases are supported. The general structure of &clsql; is based on the &commonsql; package by - Xanalys. + LispWorks Ltd. @@ -42,7 +42,8 @@ Optimized loading of integer and floating-point fields. - Additional database backends: &odbc;, &aodbc;, and &sqlite;. + Additional database backends: &odbc;, &aodbc;, &sqlite; + and &sqlite3;. A compatibility layer for &cmucl; specific code. @@ -95,7 +96,7 @@ &md5; &clsql;'s postgresql-socket interface uses Pierre Mai's - md5 + md5 module. @@ -106,8 +107,8 @@ implementations of &uffi;. The following implementations are supported: - &acl; v6.2 and 7.0b on Debian Linux x86 & - x86_64 & PowerPC, FreeBSD 4.5, and Microsoft Windows + &acl; v6.2 and 7.0b on Debian Linux x86 & + x86_64 & PowerPC, FreeBSD 4.5, and Microsoft Windows XP. &lw; v4.3 on Debian Linux and Microsoft Windows XP. @@ -131,7 +132,9 @@ &postgresql; v7.4 with both direct API and TCP socket connections. &sqlite;. + &sqlite3;. Direct &odbc; interface. + &oracle; OCI. Allegro's DB interface (&aodbc;). @@ -190,7 +193,7 @@ - Load &uffi; + Add &uffi; path Unzip or untar the &uffi; distribution which creates a directory for the &uffi; files. Add that directory to &asdf;'s asdf:*central-registry*. @@ -200,12 +203,11 @@ directory. (push #P"/usr/share/lisp/uffi/" asdf:*central-registry*) -(asdf:operate 'asdf:load-op :uffi) - Load &md5; module + Add &md5; path If you plan to use the clsql-postgresql-socket interface, you must load the md5 module. Unzip or untar the cl-md5 @@ -217,13 +219,12 @@ /usr/share/lisp/cl-md5/ directory. (push #P"/usr/share/lisp/cl-md5/" asdf:*central-registry*) -(asdf:operate 'asdf:load-op :md5) - Load &clsql; modules + Add &clsql; path and load module Unzip or untar the &clsql; distribution which creates a directory for the &clsql; files. Add that directory to &asdf;'s @@ -231,28 +232,23 @@ 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. The below example show loading - all &clsql; systems. + to load the clsql system. (push #P"/usr/share/lisp/clsql/" asdf:*central-registry*) (asdf:operate 'asdf:load-op 'clsql) ; main CLSQL package -(asdf:operate 'asdf:load-op 'clsql-mysql) ; MySQL interface -(asdf:operate 'asdf:load-op 'clsql-postgresql) ; PostgreSQL interface -(asdf:operate 'asdf:load-op 'clsql-postgresql-socket) ; Socket PGSQL interface -(asdf:operate 'asdf:load-op 'clsql-odbc) ; ODBC interface -(asdf:operate 'asdf:load-op 'clsql-sqlite) ; SQLite interface -(asdf:operate 'asdf:load-op 'clsql-aodbc) ; Allegro ODBC interface - Run test suite + Run test suite (optional) - After loading &clsql;, you can execute the test suite. A - configuration file named + The test suite can be executed using the &asdf; + test-op operator. If &clsql; has not been + loaded with asdf:load-op, the + asdf:test-op operator will automatically load + &clsql;. A configuration file named .clsql-test.config must be created in your home directory. There are instructures on the format of that file in the tests/README. After