--- a/Notification.st	Sat Oct 04 10:42:34 2008 +0200
+++ b/Notification.st	Sat Oct 04 10:42:47 2008 +0200
@@ -9,8 +9,6 @@
  other person.  No title to or ownership of the software is
  hereby transferred.
 "
-
-
 "{ Package: 'stx:libbasic' }"
 
 GenericException subclass:#Notification
@@ -40,11 +38,17 @@
 documentation
 "    
     Notification is the superclass of all notification exceptions in the system.
-    Notifications are ignored, if no handler is present.
-    In this case a default value is returned.
+    contrast to regular exceptions, Notifications are ignored, if no handler is present
+    and a default value is returned from the raise.
     When a handler finishes, the do-block is proceeded with the exception handlers value
     (an Exception does a return in this case.).
 
+    Thanks to proceedable exceptions, Notifications allow for non-GUI model code to provide
+    user notifications which are optionally shown.
+    Very useful, for example to provide progress information from a method which can be
+    invoked both from a GUI-Tool (where notifications are wanted) and also from the system,
+    where such notifications are not desired.
+
     [author:]
         Stefan Vogel
 
@@ -317,7 +321,7 @@
 !Notification class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/Notification.st,v 1.20 2005-04-04 19:00:22 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/Notification.st,v 1.21 2008-10-04 08:42:47 cg Exp $'
 ! !
 
 Notification initialize!