diff --git a/Language/Nock5K.hs b/Language/Nock5K.hs
--- a/Language/Nock5K.hs
+++ b/Language/Nock5K.hs
@@ -1,5 +1,16 @@
-module Language.Nock5K (Noun(..), Nock, nock, noun, repl) where
+-- | Implementation of the Nock 5K spec.
+module Language.Nock5K (
+ -- * Structures
+ Noun(..),
+ Nock,
+ -- * Reduction
+ nock,
+ -- * Parser
+ noun,
+ -- * REPL
+ repl
+ ) where
-import Language.Nock5K.Parse (noun)
-import Language.Nock5K.Repl (repl)
-import Language.Nock5K.Spec (Noun(..), Nock, nock)
+import Language.Nock5K.Parse
+import Language.Nock5K.Repl
+import Language.Nock5K.Spec
diff --git a/README b/README
--- a/README
+++ b/README
@@ -1,6 +1,7 @@
-Usage:
-./hsnock.lhs
+Try: ./hsnock.lhs
+Install: cabal install hsnock
+
Try forms like:
[42 1 0]
[42 0 1]
@@ -8,6 +9,3 @@
[42 [8 [1 0] 8 [1 6 [5 [0 7] 4 0 6] [0 6] 9 2 [0 2] [4 0 6] 0 7] 9 2 0 1]]
[[42 43] [8 [1 0] [8 [1 [6 [5 [0 6] [0 14]] [1 0] [6 [5 [0 6] [0 15]] [1 1] [9 2 [[0 2] [4 0 6] [0 7]]]]]] [9 2 0 1]]]]
[[43 42] [8 [1 0] [8 [1 [6 [5 [0 6] [0 14]] [1 0] [6 [5 [0 6] [0 15]] [1 1] [9 2 [[0 2] [4 0 6] [0 7]]]]]] [9 2 0 1]]]]
-
-See also:
-http://www.urbit.org/2013/08/22/Chapter-2-nock.html
diff --git a/hsnock.cabal b/hsnock.cabal
--- a/hsnock.cabal
+++ b/hsnock.cabal
@@ -1,11 +1,23 @@
name : hsnock
-version : 0.5.0
+version : 0.5.1
category : Language
license : PublicDomain
synopsis : Nock 5K interpreter.
author : Steven Dee
maintainer : mrdomino@gmail.com
homepage : https://github.com/mrdomino/hsnock/
+description :
+ This is an implementation of the Nock 5K spec with an accompanying
+ interpreter.
+ .
+ Nock is a tiny stateless virtual machine that can be thought of
+ as a functional assembly language. Nock is the lowest layer in
+ the Urbit stack. On top of it rests the Hoon language, in which
+ the Arvo OS is written.
+ .
+ More on Urbit:
+ .
+ More on Nock:
build-type : Simple
cabal-version : >=1.8