X-Git-Url: http://git.kpe.io/?p=clsql.git;a=blobdiff_plain;f=README;h=8fdfd89788b7aa24018534db65295363c7f604ab;hp=6fc8d7ac38bec8c77271f07aeef6241ffc9b581f;hb=f67c4e2a4e5b8371a1b7c1629828999ff909f538;hpb=7b9b150cf1be6c4a52855c1a8004673cac1beaa0 diff --git a/README b/README index 6fc8d7a..8fdfd89 100644 --- a/README +++ b/README @@ -1,18 +1,43 @@ -CLSQL is a Common Lisp to SQL engine interface written by Kevin M. +CLSQL is a Common Lisp to SQL engine interface by Kevin M. Rosenberg. It includes both functional and object oriented subsystems for data definition and manipulation as well as an integrated symbolic -SQL syntax. +SQL syntax. -CLSQL supports a number of RDBMS and uses the UFFI (http://uffi.b9.com) +CLSQL supports a number of RDBMS and uses the UFFI (http://uffi.kpe.io) library for compatibility with Allegro CL, Lispworks, CMUCL, SBCL and OpenMCL. -CLSQL is based on Pierre R. Mai's excellent MaiSQL package and -UncommonSQL developed at onShore Development Inc. +CLSQL has incorporated code from the following projects. At this point +in 2004, development of has stopped on these incorporated projects. + - Pierre Mai's MaiSQL + - onShore Development's UncommonSQL + - Paul Meurer's SQL/ODBC + - Cadabra's Oracle interface -CLSQL's home is http://clsql.b9.com. +CLSQL's home is http://clsql.kpe.io. Documentation is available as a PDF file in doc/clsql.pdf and as HTML files in doc/html.tar.gz. +CONTRIBUTING +------------ + +If you would like to report a bug please do so through the clsql +mailing list. http://lists.kpe.io/mailman/listinfo/CLSQL + +Patches are welcome. It will be much easier for us to incorporate if +you use [git](http://git-scm.com/). Please keep distinct changes in +seperate patches as it makes it much easier to review. If you have +something small to to send to the mailing list `git format-patch` is +your friend. + +If you have a bigger set of patches then I recommend creating a fork +on github from https://github.com/UnwashedMeme/clsql. Once your +patches are available there either issue a pull request or let us know +about it on the mailing list. + +* http://help.github.com/ has some excellent tutorials on getting + started. +* http://git-scm.com/book is an excellent in depth tutorial on how to + use git effectively.