zephyr/libdyn/README

   1 libdyn.a -- Release 1.0
   2
   3 A C Dynamic Object is an array that takes care of resizing itself as
   4 elements are added and deleted from it.  It can be of any type for
   5 which sizeof is defined and for which an address of a variable of that
   6 type can be passed to a function.
   7
   8 To build libdyn.a, simply type "make depend all" (if you don't have
   9 the program makedepend, of course, leave out the "depend" part).  If
  10 your system's bcopy() cannot handle overlapping regions, you'll need
  11 to write one that can.  (Left as an excercise for the reader..)
  12
  13 The library should compile and work without modification on a vast
  14 number of systems.  It only uses 5 external functions: malloc,
  15 realloc, free, bcopy, and fprintf (to stderr).  Of these, only bcopy
  16 should need to be changed for other systems (such as MS-DOS) and it
  17 could probably be done with a -D flag to the compiler.
  18
  19 The test/demo program is built by "make all".  This program produces
  20 the library's debugging output (to stderr) as well as some of its own
  21 output (to stdout).
  22
  23 The library has been tested (with test.c) on a VAX VSII, VAXstation
  24 3100, DECstation 3100, and IBM RT all running BSD4.3 (except for the
  25 DECstation, which was running Ultrix V2.1).
  26
  27 An earlier version of this library was posted to alt.sources.  This
  28 version contains one new function (DynInsert) and slightly cleaner
  29 code, but no bugfixes (no bugs were found).
  30
  31 Author: Barr3y Jaspan, Student Information Processing Board (SIPB) and
  32 MIT-Project Athena, bjaspan@athena.mit.edu, 1990