README.txt

= Clojure-contrib =
The user contributions library, clojure.contrib, is a collection of
namespaces each of which implements features that we believe may be
useful to a large part of the Clojure community.
Clojure-contrib is open source under the Eclipse Public License and is
copyrighted by Rich Hickey and the various contributors.
Download releases from
http://code.google.com/p/clojure-contrib/downloads
The official source repository for clojure-contrib is
http://github.com/richhickey/clojure-contrib
Documentation and APIs are available at
http://richhickey.github.com/clojure-contrib/
Issues are maintained in the Assembla space at
http://www.assembla.com/spaces/clojure-contrib
General discussion occurs in the Clojure Google group at
http://groups.google.com/group/clojure
and developer discussions are in the Clojure Dev Google group at
http://groups.google.com/group/clojure-dev
Compiled JARs of development snapshots are available at
http://build.clojure.org/
= Building Clojure-contrib =
If you downloaded a release distribution or pre-compiled JAR, you
don't need to do anything.
If you downloaded the sources from Github, you will need Apache Maven
(2.0 or higher) to run the build. See http://maven.apache.org/
Run the following command in this directory:
mvn package
This will produce the file target/clojure-contrib-${VERSION}.jar that
you can add to your Java classpath.
Additional build commands are available:
mvn clojure:repl
To start a Clojure REPL (Read-Eval-Print Loop)
mvn compile
To compile sources without building a JAR
mvn test
To run unit tests
mvn assembly:assembly
To build ZIP/tar distributions containing source and JARs
To skip the testing phase when building, add "-Dmaven.test.skip=true"
to the mvn command line.
== Compiling with Local clojure.jar ==
If you want to compile/build with a customized clojure.jar file, use
the following command:
mvn package -Dclojure.jar=/path/to/clojure.jar
The /path/to/clojure.jar MUST be an absolute path.
Maven will still download other dependencices,
such as clojure-maven-plugin.
= Clojure-contrib Versions =
Versions of clojure-contrib are matched to versions of Clojure.
If you are using Clojure 1.0, use clojure-contrib 1.0.*
If you are using Clojure 1.1, use clojure-contrib 1.1.*
If you are using Clojure from the "master" branch on Github, use
clojure-contrib from the "master" branch on Github.
If you are using Clojure from the "new" branch on Github, use
clojure-contrib from the "new" branch on Github.
= Clojure-contrib Committers =
The following people are committers to the official clojure-contrib
repositiory:
Tom Faulhaber
Stephen Gilardi
Christophe Grand
Rich Hickey
Konrad Hinsen
Stuart Holloway
Chris Houser
David Miller
Stuart Sierra
Frantisek Sodomka