--- a/ArrayedCollection.st Wed Nov 26 09:42:56 2014 +0100
+++ b/ArrayedCollection.st Wed Nov 26 09:45:13 2014 +0100
@@ -38,27 +38,27 @@
"
ArrayedCollection is an abstract superclass for all collections where
the elements can be accessed via an integer index,
- AND the collection is a fixed size collection.
+ AND the collection is a fixed size collection.
+
Those fixed size collections cannot easily grow, since they store the
elements directly within the object and a grow operation can only be done
by #becoming another object.
- (other collections keep a reference to the physical container, which
- can be easily replaced)
+ (many other collections keep a reference to the physical container,
+ which can be easily replaced)
[Warning:]
currently, ST/X supports growing fix-size collections
- (such as Arrays, ByteArrays and Strings). However, this
- is done in a very slow way (using #become).
- Become is a very slow operation in a direct-pointer smalltalk
- system.
- \
+ (such as Arrays, ByteArrays and Strings).
+ However, this is done in a very slow way (using #become).
+ Become is a very slow operation in a direct-pointer Smalltalk system
+ (which ST/X and many other 'modern' Smalltalks are).
+
Therefore, you SHOULD rewrite any application that does this,
- to make use of OrderedCollections or any other collection which
- can grow faster.
+ to make use of OrderedCollections or any other collection which can grow fast.
To remind you of that, a warning message is sent to the
standard error whenever such an operation is performed (see #grow).
- \
- Also note, that some other smalltalk systems do NOT allow
+
+ Also note, that some other Smalltalk systems do NOT allow
fix size collection to change their size, and that future
ST/X versions may be changed to trigger an error (instead of a
warning) in those situations.
@@ -502,6 +502,6 @@
!ArrayedCollection class methodsFor:'documentation'!
version
- ^ '$Header: /cvs/stx/stx/libbasic/ArrayedCollection.st,v 1.66 2014-07-09 15:05:51 cg Exp $'
+ ^ '$Header: /cvs/stx/stx/libbasic/ArrayedCollection.st,v 1.67 2014-11-26 08:45:13 cg Exp $'
! !