diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+hpg
+===
+
+The hpg utility creates passwords of different sizes, between 1 and 2^16.
+Please note that a length of < 8 is not very secure and should be avoided.
+That is why the default value is 16 if the command is called without any
+options. The default entropy contains [a-zA-Z0-9].
+
+-l          Use lower case.
+
+-n          Use numbers.
+
+-s          Use symbols.
+
+-u          Use upper case.
+
+-x          Use another length, as the default one.
+
+EXAMPLES
+--------
+
+Create a new random password:
+  
+	$ hpg -lnsu -x 32
+
diff --git a/hpg.cabal b/hpg.cabal
--- a/hpg.cabal
+++ b/hpg.cabal
@@ -2,7 +2,7 @@
 -- see http://haskell.org/cabal/users-guide/
 
 name:                hpg
-version:             0.3
+version:             0.4
 synopsis:            no
 description:         the haskell password generator.
 homepage:            https://git.alokat.org/hpg
@@ -13,7 +13,8 @@
 -- copyright:           
 category:            System
 build-type:          Simple
--- extra-source-files:  
+extra-source-files:
+  README.md  
 cabal-version:       >=1.10
 source-repository head
   type:     git