Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Added instructions to README

  • Loading branch information...
1 parent f916c65 commit d2966c611d730e4fdec8ff80a75ea542a72a8bea @pmbauer pmbauer committed
Showing with 51 additions and 4 deletions.
  1. +51 −4 README.markdown
55 README.markdown
@@ -1,7 +1,54 @@
-Benchmark (and regression) suite for Clojure
-Copyright (c) Rich Hickey.
+## Getting Started
+### Requirements
+* JDK with java/javac on path -
+* maven -
+* add the following to your ~/.m2/settings.xml file
+ <activeProfiles>
+ <activeProfile>clojure-dev</activeProfile>
+ </activeProfiles>
-License and CA same as Clojure. See epl-v10.html at the root of the
-project for details.
+ <profiles>
+ <profile>
+ <id>clojure-dev</id>
+ <activation> <activeByDefault>false</activeByDefault> </activation>
+ <repositories>
+ <repository>
+ <id>clojars</id>
+ <url></url>
+ </repository>
+ </repositories>
+ </profile>
+ ...
+ </profiles>
+ ...
+### Building
+git clone
+cd test.benchmark
+mvn test
+### Misc
+# starts a swank server
+mvn clojure:swank
+### Running a benchmark (e.g. alioth.thread-ring)
+script/run alioth.thread-ring 1000
+### Contributing
+There are a number of completed benchmarks, but there is a lot more left to do.
+Andy Fingerhut has a suit of benchmarks tailored for Clojure 1.2 and need updated or redone for Clojure 1.3 (
+A good general approach is to examine the fastest alioth implementations, usually Java or C, and write a Clojure port.
+Idiomatic Clojure typically shows poorly in the benchmarks. Liberal use of primitive arrays, type hinting, and iteration apply.
+Long term goal is a performance regression test suit ...
+Alioth Benchmark site is here:
+Work on the benchmarks is tracked here:

0 comments on commit d2966c6

Please sign in to comment.
Something went wrong with that request. Please try again.