1 files changed, 14 insertions, 2 deletions

diff --git a/README b/README
index 05a40e1..dfdd7bf 100644
--- a/README
+++ b/README
@@ -1,4 +1,16 @@
 grail - Gesture Recognition And Instantiation Library
 
-This code defines an interface and tools for handling recognized
-gestures.
+This tree consists of an interface and tools for handling gesture
+recognition and gesture instantiation.
+
+When a multitouch gesture is performed on a device, the recognizer
+emits one or several possible gestures. Once the context of the
+gesture is known, i.e., in what window the touches land and what
+gestures the clients of that window listens to, the instantiator
+delivers the matching set of gestures.
+
+The library handles tentative getures, i.e., buffering of events for
+several alternative gestures until a match is confirmed.
+
+Enjoy,
+Henrik