diff --git a/README.md b/README.md
index d2ea991..6027e6c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,8 @@
 # hs9001
+hs90001 (history search 9001) is an easy, quite simple bash history enhancement. It simply writes all
+your bash commands into an sqlite database. You can then search this database.
+
+
 ## Setup
 ```
 go build
@@ -14,11 +18,23 @@ if [ -n "$PS1" ] ; then
     PROMPT_COMMAND='hs9001 add "$(history 1)"'
 fi
 ```
+By default, every system user gets his own database. You can override this by overriding the environment variable
+for all users that should write to your unified database.
+
+```
+export HS9001_DB_PATH="/home/db/history.sqlite"
+```
 
 ## Usage
 ### Search
+
 ```
 hs9001 search "term"
 ```
 
-Is is recommended to create an aias for search to make life easier. 
+It is recommended to create an alias for search to make life easier, e. g.:
+
+```
+alias searchh='hs9001 search'
+```
+