Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 113 lines (69 sloc) 2.939 kb
40b960b @richhickey Edited README.txt via GitHub
authored
1 Note - the contrib libs have moved to individual repos under Clojure org - [https://github.com/clojure]
2
2984bb0 @stuartsierra Clean up headings in README
stuartsierra authored
3 = Clojure-contrib =
bb83d87 @scgilardi Resolve issue 31: Maven patch / build on CI Server, from Howard Lewis…
scgilardi authored
4
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
5 The user contributions library, clojure.contrib, is a collection of
6 namespaces each of which implements features that we believe may be
889f591 @stuartsierra Clean up URLs and add link to package downloads in README
stuartsierra authored
7 useful to a large part of the Clojure community.
bb83d87 @scgilardi Resolve issue 31: Maven patch / build on CI Server, from Howard Lewis…
scgilardi authored
8
f3826fa @stuartsierra Reformat README to 70-chars-per-line
stuartsierra authored
9 Clojure-contrib is open source under the Eclipse Public License and is
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
10 copyrighted by Rich Hickey and the various contributors.
11
d52942f @stuartsierra Describe where to get development snapshots in README
stuartsierra authored
12 Download releases from
889f591 @stuartsierra Clean up URLs and add link to package downloads in README
stuartsierra authored
13 http://code.google.com/p/clojure-contrib/downloads
c8e18d5 @tomfaulhaber More cross references in the README
tomfaulhaber authored
14
d52942f @stuartsierra Describe where to get development snapshots in README
stuartsierra authored
15 The official source repository for clojure-contrib is
16 http://github.com/richhickey/clojure-contrib
17
889f591 @stuartsierra Clean up URLs and add link to package downloads in README
stuartsierra authored
18 Documentation and APIs are available at
f3826fa @stuartsierra Reformat README to 70-chars-per-line
stuartsierra authored
19 http://richhickey.github.com/clojure-contrib/
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
20
889f591 @stuartsierra Clean up URLs and add link to package downloads in README
stuartsierra authored
21 Issues are maintained in the Assembla space at
22 http://www.assembla.com/spaces/clojure-contrib
23
24 General discussion occurs in the Clojure Google group at
25 http://groups.google.com/group/clojure
26 and developer discussions are in the Clojure Dev Google group at
27 http://groups.google.com/group/clojure-dev
c8e18d5 @tomfaulhaber More cross references in the README
tomfaulhaber authored
28
d52942f @stuartsierra Describe where to get development snapshots in README
stuartsierra authored
29 Compiled JARs of development snapshots are available at
30 http://build.clojure.org/
31
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
32
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
33
2984bb0 @stuartsierra Clean up headings in README
stuartsierra authored
34 = Building Clojure-contrib =
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
35
d52942f @stuartsierra Describe where to get development snapshots in README
stuartsierra authored
36 If you downloaded a release distribution or pre-compiled JAR, you
37 don't need to do anything.
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
38
c45e453 @stuartsierra Describe setting clojure.version in README
stuartsierra authored
39 If you downloaded the sources from Github, you will need Apache Maven
40 (2.0 or higher) to run the build. See http://maven.apache.org/
889f591 @stuartsierra Clean up URLs and add link to package downloads in README
stuartsierra authored
41
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
42 Run the following command in this directory:
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
43
889f591 @stuartsierra Clean up URLs and add link to package downloads in README
stuartsierra authored
44 mvn package
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
45
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
46 This will produce the file target/clojure-contrib-${VERSION}.jar that
47 you can add to your Java classpath.
48
49 Additional build commands are available:
50
51 mvn clojure:repl
52 To start a Clojure REPL (Read-Eval-Print Loop)
53
54 mvn compile
5bed152 @stuartsierra Correct README typo
stuartsierra authored
55 To compile sources without building a JAR
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
56
57 mvn test
58 To run unit tests
59
60 mvn assembly:assembly
61 To build ZIP/tar distributions containing source and JARs
62
c45e453 @stuartsierra Describe setting clojure.version in README
stuartsierra authored
63 To skip the testing phase when building, add "-Dmaven.test.skip=true"
64 to the mvn command line.
65
18584a4 @stuartsierra Add instructions for building with local Clojure
stuartsierra authored
66
67
db9bedf @stuartsierra Describe "local" build in POM
stuartsierra authored
68 == Compiling with Local clojure.jar ==
18584a4 @stuartsierra Add instructions for building with local Clojure
stuartsierra authored
69
db9bedf @stuartsierra Describe "local" build in POM
stuartsierra authored
70 If you want to compile/build with a customized clojure.jar file, use
71 the following command:
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
72
9aecba5 @stuartsierra README: remove -o from maven command line for local build
stuartsierra authored
73 mvn package -Dclojure.jar=/path/to/clojure.jar
18584a4 @stuartsierra Add instructions for building with local Clojure
stuartsierra authored
74
9aecba5 @stuartsierra README: remove -o from maven command line for local build
stuartsierra authored
75 The /path/to/clojure.jar MUST be an absolute path.
76
77 Maven will still download other dependencices,
78 such as clojure-maven-plugin.
18584a4 @stuartsierra Add instructions for building with local Clojure
stuartsierra authored
79
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
80
81
2984bb0 @stuartsierra Clean up headings in README
stuartsierra authored
82 = Clojure-contrib Versions =
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
83
9baad3c @stuartsierra Describe version numbering corresponding to Clojure versions
stuartsierra authored
84 Versions of clojure-contrib are matched to versions of Clojure.
85
86 If you are using Clojure 1.0, use clojure-contrib 1.0.*
87
88 If you are using Clojure 1.1, use clojure-contrib 1.1.*
89
90 If you are using Clojure from the "master" branch on Github, use
91 clojure-contrib from the "master" branch on Github.
92
93 If you are using Clojure from the "new" branch on Github, use
94 clojure-contrib from the "new" branch on Github.
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
95
96
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
97
2984bb0 @stuartsierra Clean up headings in README
stuartsierra authored
98 = Clojure-contrib Committers =
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
99
100 The following people are committers to the official clojure-contrib
101 repositiory:
102
1bffd84 @stuartsierra Add additional mvn build commands to README
stuartsierra authored
103 Tom Faulhaber
104 Stephen Gilardi
105 Christophe Grand
106 Rich Hickey
107 Konrad Hinsen
108 Stuart Holloway
109 Chris Houser
110 David Miller
111 Stuart Sierra
61d9b32 @tomfaulhaber Fleshed out the README with a bunch of important info that should be …
tomfaulhaber authored
112 Frantisek Sodomka
Something went wrong with that request. Please try again.