boehm-gc/README.QUICK

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