diff --git a/README b/README
index 72751038..a303e593 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-eekboard - a virtual keyboard for GNOME -*- outline -*-
+eekboard - an easy to use virtual keyboard library -*- outline -*-
 
 eekboard is a virtual keyboard software package which ships with a
 standalone virtual keyboard application ("eekboard"), and a library to
@@ -6,24 +6,28 @@ create keyboard-like UI ("libeek").
 
 * Requirements
 
-  * GLib2, GTK2, Cairo, Pango, Libxklavier...
+  * GLib2, GTK, GConf2, PangoCairo, libxklavier, libfakekey, libnotify, CSPI
   * Clutter (optional)
   * Clutter-Gtk (optional)
+  * Vala (optional)
+  * gobject-introspection (optional)
 
 * How to test
 
-If you build from git repo:
+Build from git repo:
 
   $ git clone git://github.com/ueno/eekboard.git
   $ cd eekboard
   $ ./autogen.sh --prefix=/usr --enable-gtk-doc
 
-Otherwise start from here:
+Build from tarball:
 
   $ ./configure
   $ make
   $ sudo make install
   $ eekboard
 
-*NOTE* some version combination of Clutter & Clutter-Gtk does not
-cooperate well.  Try "EEKBOARD_DISABLE_CLUTTER=1 eekboard"
+* Documentation
+
+<file:docs/reference/eek/html/index.html>
+