--- a/OrdColl.st	Tue Mar 19 14:20:42 1996 +0100
+++ b/OrdColl.st	Tue Mar 19 17:54:04 1996 +0100
@@ -49,15 +49,25 @@
 !OrderedCollection class methodsFor:'instance creation'!
 
 new
-    "create a new OrderedCollection"
+    "create a new, empty OrderedCollection"
 
     ^ (self basicNew) initContents:10
+
+    "Modified: 19.3.1996 / 17:53:12 / cg"
 !
 
 new:size
-    "create a new OrderedCollection"
+    "create a new, empty OrderedCollection with a preallocated physical
+     size. 
+     NOTICE: 
+        the logical size of the returned collection is 0 (i.e. it is empty).
+        This may be confusing, in that it is different from what Array>>new:
+        returns.
+     "
 
     ^ (self basicNew) initContents:(size max:3)
+
+    "Modified: 19.3.1996 / 17:53:47 / cg"
 ! !
 
 !OrderedCollection methodsFor:'accessing'!
@@ -1143,5 +1153,5 @@
 !OrderedCollection class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/Attic/OrdColl.st,v 1.41 1996-03-08 10:02:11 ca Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/Attic/OrdColl.st,v 1.42 1996-03-19 16:54:04 cg Exp $'
 ! !