misc/README

   1 This directory contains miscellaneous files related to Gambit-C.
   2
   3 SHELL SCRIPTS
   4 -------------
   5
   6 The following shell scripts are provided to configure the system for
   7 compiling with various C compilers under Windows-NT/95 and MSDOS:
   8
   9   "conf_msc" for the Microsoft Visual C++ 4.0 compiler
  10   "conf_bor" for the Borland C++ 5.0 compiler
  11   "conf_wat" for the Watcom C/C++ 11.0 compiler
  12   "conf_dj" for the DJGPP system v2.0 (a port of gcc for MSDOS)
  13
  14 For all these scripts it is assumed that the MKS toolkit 5.1 is
  15 installed (the scripts and makefiles may need to be modified for other
  16 toolkits).  Scripts must be called from the main distribution
  17 directory, such as "misc/conf_msc".  A "make -r" (or "make -r
  18 FORCE_STATIC_LINK=yes") after that will build the system.  Because of
  19 a bug in MKS the "-r" flag is required when you invoke "make"
  20
  21 The following files will be built: the interpreter in "gsi/gsi.exe",
  22 the compiler in "gsc/gsc.exe" and the runtime library in
  23
  24   - for DJGPP: "lib/libgambc.a"
  25   - for others when statically linked: "lib/libgambc.lib"
  26   - for others when dynamically linked: "lib/gambc.dll"
  27     ("lib/gambc.lib" is the corresponding import library)
  28
  29 By default, the executables created by these scripts are console
  30 applications.  Windowed applications for Windows-NT/95 can be created
  31 with the Watcom C/C++ compiler by calling up the script with
  32 "WINDOWED=yes misc/conf_wat".
  33
  34 Normally the sources are compiled as C source code.  If you want to
  35 force a C++ compilation, prefix the configuration command with
  36 CPLUSPLUS=yes as in "CPLUSPLUS=yes misc/conf_msc".
  37
  38 IDE PROJECTS
  39 ------------
  40
  41 To build the Gambit-C system using an IDE (Integrated Development
  42 Environment) you can use the following files which contain projects
  43 for building the interpreter and the compiler as statically linked
  44 applications.
  45
  46   "proj_msc.zip" for the Microsoft Visual C++ 4.0 compiler
  47   "proj_bor.zip" for the Borland C++ 5.0 compiler
  48   "proj_wat.zip" for the Watcom C/C++ 11.0 compiler
  49   "proj_cw.hqx" for the Macintosh CodeWarrior C/C++ compiler
  50                 version 11, Pro 1, Pro 2 or Pro 3
  51
  52 After decompressing these files, move the appropriate project file to
  53 the main distribution directory, load the appropriate project file in
  54 the IDE and build the project.
  55
  56 On the Macintosh the distribution file should be decompressed with the
  57 following Macintosh utilities: MacGzip 1.0 and suntar 2.1.
  58
  59 The interpreter and compiler can be compiled as 68k native or PowerPC
  60 native applications on the Macintosh.  The PowerPC version of the
  61 compiler can dynamically compile Scheme files (using the
  62 "compile-file" procedure) and load the resulting object file (using
  63 the "load" procedure).  This is done by sending AppleEvents to the
  64 CodeWarrior IDE (version 1.7.4, 2.0, 2.1 or 3.0), which must be currently
  65 running when "compile-file" is called.  Moreover the project files
  66 "compile-file.*" and the "gambit.h" header file must be installed in
  67 the "Gambit installation directory" (the folder "gambc" in the folder
  68 "Gambit-C" in the "Preferences" folder).  In order to compile some of
  69 the larger C files the memory setting of the CodeWarrior IDE should be
  70 increased by at least 3MB and virtual memory should be turned on.
  71 The compiler and interpreter now contain a friendly user interface with
  72 online help system and an integrated editor.
  73
  74 BENCHMARKS
  75 ----------
  76
  77 "bench.tgz" is a compressed (gzip) "tar" archive containing many
  78 Scheme benchmarks and a shell script to test these benchmarks on
  79 several different Scheme implementations.