X-Git-Url: http://git.kpe.io/?p=clsql.git;a=blobdiff_plain;f=README;h=3caff9f6076f1c81d267ba25bf115233c8314212;hp=1e0895d31203c1fc8da0898a2736d9090fa9c73f;hb=906d7a71b35ee1cd6d281623694bc90ced22c339;hpb=8213ff48f5362c3d4792444c929f50bd128bd044 diff --git a/README b/README index 1e0895d..3caff9f 100644 --- a/README +++ b/README @@ -1,11 +1,43 @@ -CLSQL is a Common Lisp to SQL engine interface written by Kevin M. -Rosenberg. It is based Pierre R. Mai's excellent MaiSQL package. It -uses the UFFI (http://uffi.med-info.com) library for compatibility -with Allegro CL, Lispworks, and CMUCL. +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. -CLSQL's home is http://clsql.med-info.com. +CLSQL supports a number of RDBMS and uses the UFFI (http://uffi.b9.com) +library for compatibility with Allegro CL, Lispworks, CMUCL, SBCL and +OpenMCL. -Documentation is availabe as a PDF file in doc/clsql.pdf and -as HTML files in doc/html/. +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. +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.b9.com/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.