Update README

2 files changed, 73 insertions, 8 deletions

diff --git a/README.mdwn b/README.mdwn
new file mode 100644
index 0000000..129a36e
--- /dev/null
+++ b/README.mdwn
@@ -0,0 +1,73 @@
+# Gitto
+
+For lack of a better title.
+
+My simple utility to keep track of all the git repositories I have on
+my computer(s). Also an experiment in writing scheme.
+
+Written for `guile` 2.0.x
+
+## Installation
+
+Installing `gitto` is not really necessary, but it *is* more
+convenient. In order to install it just run:
+
+    # make install
+
+This will install `gitto` to `/usr/local/`, if you would like it
+somewhere else you could use the `DESTDIR` variable:
+
+    # make install DESTDIR=/some/other/place
+
+This will install `gitto` to `/some/other/place/`.
+
+## Removal
+
+If you're fed up with `gitto` and want it gone, and I do mean **now**,
+you can run:
+
+    # make uninstall
+
+This will remove any `gitto` installed files from `/usr/local/`, if
+you used the `DESTDIR` variable during installation, you should give
+it the same value here, like:
+
+    # make uninstall DESTDIR=/some/other/place
+
+This will remove any `gitto` installed files from
+`/some/other/place/`.
+
+## Usage
+
+Usage is, hopefully, simple, first you have to register some repos:
+
+    $ gitto -r ~/projects/project1
+    $ gitto -r ~/projects/project2
+    $ gitto -r ~/projects/project3
+
+Then you can call `gitto` without any argument to see a list of your
+repos and their statuses:
+
+    $ gitto
+    project1:      0 to push, 0 to pull and is dirty
+    project2:      5 to push, 2 to pull and is not dirty
+    project3:      0 to push, 1 to pull and is not dirty
+
+If you're done with one of your projects and no longer wish to track
+their status you can unregister them:
+
+    $ gitto -R ~/projects/project1
+
+
+If you require further assistance:
+
+    $ gitto -h
+
+### `run-gitto`
+
+As I mentioned, it is not completely necessary to install gitto, I
+have added a utility to run it straight from je project directory,
+although mostly for testing purposes.
+
+Using `run-gitto` works exactly the same as using `gitto` when it is
+installed.
diff --git a/README.org b/README.org
deleted file mode 100644
index b76c1b6..0000000
--- a/README.org
+++ /dev/null
@@ -1,8 +0,0 @@
-* Gitto
-
-  For lack of a better title.
-
-  My simple utility to keep track of all the git repositories I have
-  on my computer(s). Also an experiment in writing scheme.
-
-  Written for ~guile~ 2.0.x