#OTHER by cg
authorClaus Gittinger <cg@exept.de>
Fri, 14 Oct 2016 00:09:31 +0200
changeset 20628 8679e14fa67d
parent 20627 47ed4d83bc81
child 20629 0fc29277f896
#OTHER by cg docu
Bag.st
--- a/Bag.st	Fri Oct 14 00:09:21 2016 +0200
+++ b/Bag.st	Fri Oct 14 00:09:31 2016 +0200
@@ -38,30 +38,30 @@
 
 documentation
 "
-    Bag implements collections whose elements are unordered and have no
-    external key. Elements may occur more than once in a bag. There is no defined
-    order within a bag.
-    The default implementation uses a dictionary to store each objects occurrence
-    count, using the object itself as key (i.e. using = and hash for inclusion
-    tests).
+    Bags are collections where the elements are unordered and have no external key. 
+    Elements may occur more than once in a bag. 
+    There is no defined order within a bag.
+    The default implementation uses a dictionary to store each object's occurrence count, 
+    using the object itself as key 
+    (i.e. using = and hash for inclusion tests).
 
-    There is also an instance creation variant (#identityNew:) creating a
+    There is also an instance creation variant (#identityNew:) which creats a
     bag which compares using #== and hashes using #identityHash.
-    (I'd say that an IdentityBag was a better thing to implement ...
+    (I'd say that instantiating an IdentityBag explicitly is better,
      ... but for compatibility ... we do it here as well)
 
     [Instance variables:]
 
-	contents        <Dictionary>    for each element, the number of occurrences
+        contents        <Dictionary>    for each element, the number of occurrences
 
 
     [author:]
-	Claus Gittinger
+        Claus Gittinger
 
     [See also:]
-	Set IdentitySet
-	Dictionary IdentityDictionary
-	OrderedCollection Array
+        Set IdentitySet
+        Dictionary IdentityDictionary
+        OrderedCollection Array
 "
 ! !