Browse files

Address Laurent's comment regarding location of history in the README.

  • Loading branch information...
1 parent 54d0871 commit a5e77f41c8e02c6ca5d180292495a8946433f1a1 @Raynes committed Dec 20, 2012
Showing with 27 additions and 23 deletions.
  1. +27 −23 README.markdown
View
50 README.markdown
@@ -2,14 +2,40 @@
[![Build Status](https://secure.travis-ci.org/Raynes/bultitude.png)](http://travis-ci.org/Raynes/bultitude)
+Bultitude is a library for finding namespaces on the classpath.
+
+## Usage
+
+```clojure
+user=> (require '[bultitude.core :as b])
+nil
+user=> (take 10 (b/namespaces-on-classpath))
+(bultitude.core-test bultitude.core clojure.data clojure.string clojure.test clojure.xml clojure.inspector clojure.repl clojure.set clojure.test.junit)
+user=> (b/namespaces-on-classpath :prefix "bultitude")
+(bultitude.core-test bultitude.core)
+user=> (b/namespaces-on-classpath :prefix "bultitude" :classpath "src")
+(bultitude.core)
+user=> (b/namespaces-on-classpath :prefix "bultitude" :classpath "src:test")
+(bultitude.core bultitude.core-test)
+```
+
+Value for :classpath can either be a String containing paths (using the underlying operating system's path separator), or a collection of `File` objects.
+
+## The Name
+
+I don't know. You'd have to ask [Phil](https://github.com/technomancy)
+about that one.
+
+## History
+
This library is a library similar to `clojure.tools.namespace`. It is
designed to find namespaces on the classpath. This one was ripped from
Leiningen's core because we decided it should be publically available to
everyone.
This library was originally devised in Leiningen because Leiningen had a
few specific needs that `clojure.tools.namespace` did not provide.
-Furthermore, the library's author was, at the time, ignoring some issues with
+Furthermore, the library's author seems to be ignoring some issues with
the library (having declined a filed issue about it so far) that makes
the library explode when ran across a namespace with a namespace form
that the reader cannot read. We ran into this problem because
@@ -32,25 +58,3 @@ the issue. This library is still necessary and maintained because:
New features have been added to tools.namespace recently, and when I get some time I'll see
about porting them over.
-
-## Usage
-
-```clojure
-user=> (require '[bultitude.core :as b])
-nil
-user=> (take 10 (b/namespaces-on-classpath))
-(bultitude.core-test bultitude.core clojure.data clojure.string clojure.test clojure.xml clojure.inspector clojure.repl clojure.set clojure.test.junit)
-user=> (b/namespaces-on-classpath :prefix "bultitude")
-(bultitude.core-test bultitude.core)
-user=> (b/namespaces-on-classpath :prefix "bultitude" :classpath "src")
-(bultitude.core)
-user=> (b/namespaces-on-classpath :prefix "bultitude" :classpath "src:test")
-(bultitude.core bultitude.core-test)
-```
-
-Value for :classpath can either be a String containing paths (using the underlying operating system's path separator), or a collection of `File` objects.
-
-## The Name
-
-I don't know. You'd have to ask [Phil](https://github.com/technomancy)
-about that one.

0 comments on commit a5e77f4

Please sign in to comment.