Slightly more readable README
diff --git a/Makefile.am b/Makefile.am
index 92caab6..4ec13fc 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -14,13 +14,13 @@
SUBDIRS = lib
-localdoc_DATA = README.gz LICENSE.gz
+localdoc_DATA = README.rst.gz LICENSE.gz
DISTCLEANFILES = $(localdoc_DATA)
-EXTRA_DIST = README LICENSE
+EXTRA_DIST = README.rst LICENSE
-README.gz: $(top_srcdir)/README
+README.rst.gz: $(top_srcdir)/README.rst
-gzip -9 < $< > $@
LICENSE.gz: $(top_srcdir)/LICENSE
diff --git a/README b/README
deleted file mode 100644
index 8b192ec..0000000
--- a/README
+++ /dev/null
@@ -1,21 +0,0 @@
-erlang-bcrypt is a wrapper around the OpenBSD Blowfish password hashing
-algorithm, as described in "A Future-Adaptable Password Scheme" by Niels
-Provos and David Mazieres: http://www.openbsd.org/papers/bcrypt-paper.ps
-
-Basic build instructions:
-
-$ ./bootstrap
-$ ./configure \
- --with-erlang=R12B-4/lib/erlang/usr/include \
- --with-erl-interface=R12B-4/lib/erlang/lib/erl_interface-3.5.8
-$ make
-$ erl -pa lib/bcrypt/ebin
-
-Basic usage instructions:
-
-1> ok = crypto:start(), {ok, Pid} = bcrypt:start_link("lib/bcrypt/bcrypt").
-{ok, <0.39.0>}
-2> bcrypt:hashpw(Pid, "foo", bcrypt:gen_salt(Pid)).
-"$2...000"
-
-Authors: Hunter Morris (http://skarab.com/)
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..ae1a7e7
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,44 @@
+erlang-bcrypt
+=============
+
+erlang-bcrypt is a wrapper around the OpenBSD Blowfish password hashing
+algorithm, as described in `"A Future-Adaptable Password Scheme"`_ by Niels
+Provos and David Mazieres.
+
+.. _"A Future-Adaptable Password Scheme": http://www.openbsd.org/papers/bcrypt-paper.ps
+
+Basic build instructions
+------------------------
+
+1. Bootstrap `erlang-bcrypt`::
+
+ ./bootstrap
+
+2. Configure the project, specifying `--with-erlang` and `--with-erl-interface`::
+
+ ./configure \
+ --with-erlang=R12B-4/lib/erlang/usr/include \
+ --with-erl-interface=R12B-4/lib/erlang/lib/erl_interface-3.5.8
+
+3. Build it
+
+ make
+
+4. Run it
+
+ erl -pa lib/bcrypt/ebin
+
+Basic usage instructions
+------------------------
+
+1. Start the `gen_server` which manages the port::
+
+ 1> ok = crypto:start(), {ok, Pid} = bcrypt:start_link("lib/bcrypt/bcrypt").
+ {ok, <0.39.0>}
+
+2. Hash a password using a salt with the default number of rounds::
+
+ 2> bcrypt:hashpw(Pid, "foo", bcrypt:gen_salt(Pid)).
+ "$2...000"
+
+Authors: Hunter Morris (http://skarab.com/)
diff --git a/configure.ac b/configure.ac
index 3597461..9fef5be 100644
--- a/configure.ac
+++ b/configure.ac
@@ -16,7 +16,7 @@
AC_PREREQ([2.59])
-AC_CONFIG_SRCDIR([README])
+AC_CONFIG_SRCDIR([README.rst])
AC_CONFIG_AUX_DIR([build-aux])
AM_CONFIG_HEADER([config.h])
