use md5sum-string instead of md5sum-sequence to adjust to upstream changes
[clsql.git] / README
diff --git a/README b/README
index a112f9d645af2ffe7df3b82094c5914b3fe26933..3caff9f6076f1c81d267ba25bf115233c8314212 100644 (file)
--- 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
 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.b9.com)
 library for compatibility with Allegro CL, Lispworks, CMUCL, SBCL and
 OpenMCL.
 
 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.b9.com.
 
-Documentation is availabe as a PDF file in doc/clsql.pdf and as HTML
+Documentation is available as a PDF file in doc/clsql.pdf and as HTML
 files in doc/html.tar.gz.
 
 
 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.