--- a/Stack.st	Wed Jun 11 10:08:35 2003 +0200
+++ b/Stack.st	Wed Jun 11 10:37:18 2003 +0200
@@ -11,7 +11,10 @@
 
 documentation
 "
-    a simple implementation of a Stack.
+    A simple implementation of a Stack.
+    Notice, this is simply syntactic sugar - all functionality is
+    already provided by the OrderedCollection class 
+    (addLast <==> push / removeLast <==> pop / last <==> top)
 
     [author:]
         Stefan Vogel
@@ -71,7 +74,8 @@
 !
 
 pop: numElem 
-    "Pop and discard top numElems and answer receiver"
+    "Pop and discard top numElems and answer the receiver.
+     Caveat: pop: is a misleading name; should propably be called drop:"
 
     self removeLast:numElem
 !
@@ -105,5 +109,5 @@
 !Stack class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic2/Stack.st,v 1.5 2003-05-20 14:59:26 stefan Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic2/Stack.st,v 1.6 2003-06-11 08:36:55 cg Exp $'
 ! !