diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# sync-mht
+
+[![Build Status](https://travis-ci.org/ekarayel/sync-mht.svg?branch=master)](https://travis-ci.org/ekarayel/sync-mht)
+
+## Synopsis
+Fast incremental file transfer using Merkle-Hash-Trees
+
+## Description
+A command line tool that can be used to incrementally synchronize a directory hierarchy with a
+second one. It is using a Merkle-Hash-Tree to compare the folders, such that the synchronization
+time and communication (round) complexity grows only logarithmically with the size of the
+directories (assuming the actual difference of the directories is small).
+
+The communication happens through standard streams between parent and child processes, which can
+easily be routed through remote command execution tools.
+
+## Examples
+The following command
+
+    sync-mht -s foo/ -d bar
+
+will synchronize the local folder bar/ with the local folder foo/, but
+
+    sync-mht -s foo/ -d remote:/bar -r "ssh fred@example.org sync-mht"
+
+will synchronize the folder bar/ in the home directory of the user fred on the host machine
+example.org with the local folder foo/.
+
+It is also possible to use it with docker, e.g.
+
+    sync-mht -s foo/ -d remote:/bar -r "docker run -i --volumes-from bar ekarayel/sync-mht sync-mht"
+
+to synchronize the folder /bar (of the container named bar) with the local folder foo/.
+
diff --git a/sync-mht.cabal b/sync-mht.cabal
--- a/sync-mht.cabal
+++ b/sync-mht.cabal
@@ -1,36 +1,39 @@
--- This .cabal file was generated by src/build/hs/CabalTemplate.hs
+-- This .cabal file was generated by configure.hs
 name: sync-mht
-version: 0.2.1.0
-synopsis: 
-    Fast incremental file transfer using Merke-Hash-Trees
-    
-description: 
-    A command line tool that can be used to incrementally synchronize a directory hierarchy with a
-    second one. It is using a Merkle-Hash-Tree to compare the folders, such that the synchronization
-    time and communication (round) complexity grows only logarithmically with the actual size of the
-    directories (assuming the actual difference of the directories is small).
-    
-    The communication happens through standard streams between parent and child processes, which can
-    easily be routed through remote command execution tools.
-    
 license: MIT
 license-file: LICENSE
 author: Emin Karayel <me@eminkarayel.de>
 maintainer: Emin Karayel <me@eminkarayel.de>
-package-url: https://github.com/ekarayel/sync-mht
 category: Utility
-build-type: Simple
+extra-doc-files: README.md
 cabal-version: >=1.10
+build-type: Simple
+version: 0.2.1.1
+homepage: https://github.com/ekarayel/sync-mht
+bug-reports: https://github.com/ekarayel/sync-mht/issues
+package-url: https://github.com/ekarayel/sync-mht
+synopsis:
+    Fast incremental file transfer using Merkle-Hash-Trees
+    
+description:
+    A command line tool that can be used to incrementally synchronize a directory hierarchy with a
+    second one. It is using a Merkle-Hash-Tree to compare the folders, such that the synchronization
+    time and communication (round) complexity grows only logarithmically with the size of the
+    directories (assuming the actual difference of the directories is small).
+    .
+    The communication happens through standard streams between parent and child processes, which can
+    easily be routed through remote command execution tools.
+    .
 source-repository head
     type: git
-    location: https://github.com/ekarayel/sync-mht
+    location: https://github.com/ekarayel/sync-mht --recursive
 source-repository this
     type: git
-    tag: 0.2.1.0
-    location: https://github.com/ekarayel/sync-mht
+    tag: 0.2.1.1
+    location: https://github.com/ekarayel/sync-mht --recursive
 executable sync-mht
     main-is: Main.hs
-    other-modules: 
+    other-modules:
         Sync.MerkleTree.Analyse
         Sync.MerkleTree.Client
         Sync.MerkleTree.CommTypes