--- a/EventListener.st	Tue Aug 29 19:46:11 1995 +0200
+++ b/EventListener.st	Wed Aug 30 01:43:11 1995 +0200
@@ -25,13 +25,23 @@
 
 version
 "
-$Header: /cvs/stx/stx/libview2/EventListener.st,v 1.4 1995-08-29 17:43:34 claus Exp $
+$Header: /cvs/stx/stx/libview2/EventListener.st,v 1.5 1995-08-29 23:43:11 claus Exp $
 "
 !
 
 documentation
 "
-    abstract class for event listeners. See example use in ActiveHelp.
+    abstract class for event listeners. EventListeners can be used to intercept
+    incoming events (keyboard & mouse) directly from a sensor, or even
+    for a complete display device.
+    One application is the automatic help, which tracks entering/leaving
+    views, to popup some help message. See concrete code in ActiveHelp.
+    For each intercepted event, a corresponding method is called for in instances
+    of myself - these should return true, if the event is to be ignored (i.e.
+    assumed to be processed and consumed by the reader, or false, if the normal
+    event procedure should be performed. Since this is an abstract class,
+    all of my intercept methods return false. They are meant to be redefined
+    in concrete subclasses.
 "
 !