--- a/CascadingNotification.st	Sat Aug 24 14:24:21 2013 +0200
+++ b/CascadingNotification.st	Sat Aug 24 14:24:42 2013 +0200
@@ -39,10 +39,10 @@
     A CascadingNotification behaves much like a regular notification,
     in that if no handler is present, execution proceeds after the raise.
     However, iff a handler is present, all other outer handlers are still called,
-    unless that handler does an explicit return or proceed.
-    I.e. the default behavior of a handler is not to proceed, but to reject,
-    iff there is another outer handler. For the very outermost handler, the default
-    is to proceed.
+    if the handles simply fall through
+    I.e. the default behavior of a handler is not to proceed or return, but to reject,
+    iff there is another outer handler. 
+    For the very outermost handler, the default is to proceed.
 
     This is used to allow for notifier-hooks to be stacked upon each other.
     For now, the one and only use is the aboutToOpenBox notifier, which can be used
@@ -193,7 +193,7 @@
 !CascadingNotification methodsFor:'default actions'!
 
 doCallHandler:aHandlerBlock
-    "call the handler proper
+    "call the handler proper - if the handler falls through, reject and try more handlers.
      - an extra method is needed to have a raise-marked context around.
        (see implementation of #reject and #proceed)."
 
@@ -218,11 +218,11 @@
 !CascadingNotification class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/CascadingNotification.st,v 1.2 2013-08-22 13:03:15 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/CascadingNotification.st,v 1.3 2013-08-24 12:24:42 cg Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libbasic/CascadingNotification.st,v 1.2 2013-08-22 13:03:15 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/CascadingNotification.st,v 1.3 2013-08-24 12:24:42 cg Exp $'
 ! !