Copyright 1988, 1989 Hans-J. Boehm, Alan J. Demers Copyright (c) 1991-1995 by Xerox Corporation. All rights reserved. Copyright (c) 1996-1999 by Silicon Graphics. All rights reserved. Copyright (c) 1999 by Hewlett-Packard. All rights reserved. THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED OR IMPLIED. ANY USE IS AT YOUR OWN RISK. Permission is hereby granted to use or copy this program for any purpose, provided the above notices are retained on all copies. Permission to modify the code and to distribute modified code is granted, provided the above notices are retained, and a notice that the code was modified is included with the above copyright notice. For more details and the names of other contributors, see the README file and gc.h. This file describes typical use of the collector on a machine that is already supported. INSTALLATION: Under UN*X, type "make test". Under OS/2 or Windows NT, copy the appropriate makefile to MAKEFILE, read it, and type "nmake test". Read the machine specific README if one exists. The only way to develop code with the collector for Windows 3.1 is to develop under Windows NT, and then to use win32S. If you wish to use the cord (structured string) library type "make cords". (This requires an ANSI C compiler. You may need to redefine CC in the Makefile.) If you wish to use the collector from C++, type "make c++". These add further files to gc.a and to the include subdirectory. See cord/cord.h and gc_c++.h. TYPICAL USE: Include "gc.h" from this directory. Link against the appropriate library ("gc.a" under UN*X). Replace calls to malloc by calls to GC_MALLOC, and calls to realloc by calls to GC_REALLOC. If the object is known to never contain pointers, use GC_MALLOC_ATOMIC instead of GC_MALLOC. Define GC_DEBUG before including gc.h for additional checking.