home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / resources / libraries / libcoll.940510.README < prev    next >
Encoding:
Text File  |  1994-06-06  |  4.6 KB  |  128 lines
  1. GNU Objective-C Collection Library
  2. **********************************
  3.  
  4. The GNU Objective-C Collection Class Library, `libcoll' version
  5. 940510, is now available.
  6.  
  7. Where can you get it?  How can you compile it?
  8. ==============================================
  9.  
  10.    The library is available by anonymous ftp at
  11.      ftp.cs.rochester.edu:pub/objc/libcoll-940510.tar.gz
  12.  
  13.    The library requires gcc 2.5.8 or higher.  The library does not work
  14. with the NEXTSTEP 3.2 compiler because NeXT's cc cannot handle nested
  15. functions; the next version of NEXTSTEP will, however, and this version
  16. of libcoll is already running internally at NeXT.  See the `INSTALL'
  17. file for more instructions about compiling and installing the library.
  18.  
  19.    The `.tar' file is compressed with GNU gzip.  It can be obtained by
  20. anonymous ftp at any one of the GNU archive sites.  For example:
  21.      ftp.uu.net:systems/gnu/gzip-1.2.4.tar
  22.      gatekeeper.dec.com:pub/GNU/gzip-1.2.4.tar
  23.      prep.ai.mit.edu:pub/gnu/gzip-1.2.4.tar
  24.  
  25.    For info about FTP via email, send email to `ftpmail@decwrl.dec.com'
  26. with no subject line, and two-line body with line one `help' and line
  27. two `quit'.
  28.  
  29. What is the Collection library?
  30. ===============================
  31.  
  32.    It's a library of Objective-C objects with similar functionality to
  33. Smalltalk's Collection objects.  It includes: Set, Bag, Array,
  34. CircularArray, GapArray, Queue, Stack, Heap, LinkedList, BinaryTree,
  35. SplayTree, RBTree, Dictionary, MappedCollector, EltNodeCollector and
  36. DelegateList.
  37.  
  38.    Outside of its main heirarchy `libcoll' also includes List,
  39. HashTable, Storage and NXStringTable objects compatible with NeXT's
  40. objects of the same name.
  41.  
  42.    As an extra plus, the library includes classes Magnitude and Time.
  43.  
  44.    Preliminary documentation is available via `texinfo' in the files
  45. `libcoll.info' and `libcoll.texi'.  The info file was created from the
  46. texi file using an modified version of `makeinfo' available by
  47. anonymous ftp from `iesd.auc.dk:pub/ObjC'.
  48.  
  49.    Here is the object inheritance heirarchy.  All protocols end with
  50. "ing"; all collection protocols end with "Collecting".  All collection
  51. abtract superclasses (classes which are not usable without subclassing)
  52. end with "Collection";
  53.  
  54.         Collection <Collecting>
  55.             Set
  56.                 Bag
  57.             KeyedCollection <KeyedCollecting>
  58.                 Dictionary
  59.                 MappedCollector
  60.                 IndexedCollection <IndexedCollecting>
  61.                     Array
  62.                         Stack
  63.                         GapArray
  64.                         CircularArray
  65.                             Queue
  66.                         Heap
  67.                     LinkedList
  68.                     BinaryTree
  69.                     RBTree
  70.                     EltNodeCollector
  71.                     String
  72.          DelegateList
  73.      
  74.          LinkedListNode
  75.              LinkedListEltNode
  76.          BinaryTreeNode
  77.              BinaryTreeEltNode
  78.          RBTreeNode
  79.              RBTreeEltNode
  80.      
  81.          HashTable
  82.          List
  83.          Storage
  84.          NXStringTable
  85.  
  86. Noteworthy changes in verion 940510
  87. ===================================
  88.  
  89.    * A NeXT-compatible NXStringTable object, thanks to Adam Fedor
  90.      <adam@bastille.rmnug.org>.
  91.  
  92.    * SplayTree and RBTree classes now operational.  More methods in Time
  93.      class implemented.
  94.  
  95.    * Some API cleanup:  -delegateListList changed to
  96.      -delegateListCollection.  -includesSameContents: changed to
  97.      -contentsEqual:.  -insertObject:atKey: changed to
  98.      -putObject:atKey:.  See the ChangeLog for more detail.
  99.  
  100.    * Configuration by autoconf in the self-tests directory.
  101.  
  102.    * Bug fixes: BinaryTree rotate methods fixed.  Fixed the way
  103.      `ifNone:' and `ifAbsent:' functions were called.  Fixed the way
  104.      long elements are printed.  Added methods for preventing memory
  105.      leaks by unfinished enumerations: `-newEnumState' and
  106.      `-freeEnumState:'.  Several bug fixes in List, and changes for
  107.      better NeXT-compability.  Better compatibility in Storage class.
  108.      And more.
  109.  
  110. How can you help?
  111. =================
  112.  
  113.    * Read the questions in the `TODO' file.  If you have any useful
  114.      comments mail them to me!
  115.  
  116.    * Give me feedback!  Tell me what you like, tell me what you think
  117.      could be better.  Send me bug reports.
  118.  
  119.    * Donate classes.  If you write classes that fit in the libcoll
  120.      framework, I'd be happy to include them.
  121.  
  122.      ------------------------------------------------------------------
  123.      R. Andrew McCallum            ARPA: mccallum@cs.rochester.edu
  124.      Computer Science Department   UUCP: uunet!cs.rochester.edu!mccallum
  125.      University of Rochester       VOX: (716) 275-2527
  126.      Rochester, NY  14627-0226     FEET: CSB  Rm. 625
  127.  
  128.