--- a/PopUpMenu.st	Wed Aug 28 14:02:52 2013 +0200
+++ b/PopUpMenu.st	Wed Aug 28 14:11:55 2013 +0200
@@ -38,14 +38,18 @@
 
 documentation
 "
+    Warning: this is a very old class which was written well before many improved
+    successors and tools were added. A lot of stuff you find here is kept for backward
+    compatibility.
+
     This class provides PopUpMenu functionality;
     -> Actually, this class only provides the popup and shadow functionality 
        and wraps ANOTHER view, which shows the actual menu-list 
-       (usually an instance of MenuView).
+       (usually an instance of MenuView, but in theory, other views could be wrapped as popup).
 
     PopUpMenus are usually created with a list of labels, selectors and a
-    receivier. Once activated, the specified receiver will be sent a
-    'selector'-message.
+    receiver. 
+    Once activated, the specified receiver will be sent a 'selector'-message.
 
     PopupMenus may be either assigned statically to a view (via the #middleButtonMenu:
     message) or created dynamically as required.
@@ -1671,10 +1675,10 @@
 !PopUpMenu class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libwidg/PopUpMenu.st,v 1.112 2013-06-17 14:26:45 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/PopUpMenu.st,v 1.113 2013-08-28 12:11:55 cg Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libwidg/PopUpMenu.st,v 1.112 2013-06-17 14:26:45 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/PopUpMenu.st,v 1.113 2013-08-28 12:11:55 cg Exp $'
 ! !