--- a/WarningBox.st	Thu Nov 15 22:03:07 2001 +0100
+++ b/WarningBox.st	Thu Nov 15 22:03:22 2001 +0100
@@ -43,8 +43,8 @@
         In the meantime, the DialogBox class (and therefore its alias: Dialog)
         is going to duplicate most funcionality found in these classes.
 
-        In the future, those existing subclasses' functionality is going to
-        be moved fully into Dialog, and the subclasses will be replaced by dummy
+        In the future, those existing subclasses' functionality might
+        be moved fully into Dialog, and the subclasses be replaced by dummy
         delegators. (They will be kept for backward compatibility, though).
 
 
@@ -83,6 +83,17 @@
 
 examples
 "
+    Notice, the preferred use is via the DialogBox class messages,
+    such as 
+                                                                        [exBegin]
+        Dialog warn:'Coffee or tee ?'
+                                                                        [exEnd]
+    these (DialogBox) mesages are compatible with VW and should therefore
+    be used for portability.
+
+    Direct reference to WarnBox is only required for highly specialized boxes.
+
+
     standard warning dialogs
     (recommended, since these are ST-80 compatible interfaces)
                                                                         [exBegin]
@@ -210,5 +221,5 @@
 !WarningBox class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libwidg/WarningBox.st,v 1.28 2001-05-17 12:17:46 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/WarningBox.st,v 1.29 2001-11-15 21:03:22 cg Exp $'
 ! !