Chez Scheme Version 7.0 Distribution Contents and Installation Instructions Cadence Research Systems www.scheme.com Overview Chez Scheme is an efficient and robust implementation of Scheme with support for all required and optional features of the ANSI/IEEE Scheme Standard and the Revised^5 Reports on Scheme along with a number of language and programming environment extensions. Chez Scheme employs an incremental optimizing compiler that produces efficient code and does so quickly. Petite Chez Scheme is a complete Scheme system that is fully compatible with Chez Scheme but uses a fast interpreter in place of the compiler. It was conceived as a run-time environment for compiled Chez Scheme applications, but is also a stand-alone Scheme system. Programs written for Chez Scheme run unchanged in Petite Chez Scheme, as long as they do not depend specifically on the compiler, albeit not as quickly and without the debugging information generated by the compiler. In fact, Petite Chez Scheme is built from the same sources as Chez Scheme, with all but the compiler sources included. Complete online documentation for Chez Scheme and Petite Chez Scheme is available at www.scheme.com in the form of two books written by R. Kent Dybvig: The Scheme Programming Language, Third Edition and the Chez Scheme Version 7 User's Guide. Both systems are copyrighted by Cadence Research Systems and are distributed under license. Use of Chez Scheme requires a license fee, while use of Petite Chez Scheme does not. Petite Chez Scheme is freely redistributable, while Chez Scheme may not be redistributed in any form. The Scheme Widget Library (SWL) is a free windowing and graphics package. It includes an object system, a threaded windowing and graphics library, and various tools, including an editor and a window-based REPL (read-eval-print loop) window with tcsh-like history. It is distributed with online documentation in the form of the SWL Reference Manual, written by Oscar Waddell. SWL is copyrighted by Oscar Waddell. It is based on Tcl/Tk, which is copyrighted by the Regents of the University of California, Sun Microsystems, Inc., Scriptics Corporation, and other parties. SWL and Tcl/Tk are both open source and freely distributable. Details are contained within the SWL and Tcl/Tk distributions. Before you download install Chez Scheme, Petite Chez Scheme and/or SWL, please read the appropriate license agreement(s) below. * Chez Scheme license agreeement * Petite Chez Scheme license agreeement * SWL license agreeement Do not proceed with the installation unless you agree to the terms of the license agreement(s). Use of Chez Scheme, which is compiler-based, requires a license fee. It cannot be redistributed. Use of Petite Chez Scheme, which is interpreter-based, does not require a license fee, and it may be redistributed. Petite Chez Scheme may be used as a stand-alone Scheme system or as an application-delivery vehicle for compiled code produced by Chez Scheme. Please refer to the license agreements and to Section 2.7 of the Chez Scheme Version 7 User's Guide for details. Distribution Contents Release notes, etc. * ReadMe: Text version of distribution contents and installation instructions. * index.html: HTML version of distribution contents and installation instructions. * 7.0.pdf: release notes for Version 7.0. Chez Scheme (as licensed) * csv70.exe: Chez Scheme and Petite Chez Scheme self-extracting .exe for Windows 95/98/ME/NT/2000/XP. * ChezScheme-7.0-1.i386.rpm: Chez Scheme RPM for Intel Linux. * ChezScheme-7.0-1.src.rpm: Chez Scheme source RPM for Intel Linux. * csv7.0-i3le.tar.gz: Chez Scheme and Petite Chez Scheme for Intel Linux. * csv7.0-1.pkg.tar.gz: Chez Scheme PKG for Apple PowerPC Mac OS X. * csv7.0-ppcosx.tar.gz: Chez Scheme for Apple PowerPC Mac OS X. * csv7.0-sps2.tar.gz: Chez Scheme and Petite Chez Scheme for Sparc Solaris 2.x (32-bit). * csv7.0-sp64.tar.gz: Chez Scheme and Petite Chez Scheme for Sparc Solaris 2.x (64-bit). * tcsv70.exe: Chez Scheme and Petite Chez Scheme self-extracting .exe for Windows 95/98/ME/NT/2000/XP (threaded). * csv7.0-ti3le.tar.gz: Chez Scheme and Petite Chez Scheme for Intel Linux (threaded). * csv7.0-tsps2.tar.gz: Chez Scheme and Petite Chez Scheme for Sparc Solaris 2.x (32-bit threaded). * csv7.0-tsp64.tar.gz: Chez Scheme and Petite Chez Scheme for Sparc Solaris 2.x (64-bit threaded). Petite Chez Scheme * pcsv70.exe: Petite Chez Scheme self-extracting .exe for Windows 95/98/ME/NT/2000/XP. * PetiteChezScheme-7.0-1.i386.rpm: Petite Chez Scheme RPM for Intel Linux. * PetiteChezScheme-7.0-1.src.rpm: Petite Chez Scheme source RPM for Intel Linux. * pcsv7.0-i3le.tar.gz: Petite Chez Scheme for Intel Linux. * pcsv7.0-1.pkg.tar.gz: Petite Chez Scheme PKG for Apple PowerPC Mac OS X. * pcsv7.0-ppcosx.tar.gz: Petite Chez Scheme for Apple PowerPC Mac OS X. * pcsv7.0-sps2.tar.gz: Petite Chez Scheme for Sparc Solaris 2.x (32-bit). * pcsv7.0-sp64.tar.gz: Petite Chez Scheme for Sparc Solaris 2.x (64-bit). * tpcsv70.exe: Petite Chez Scheme self-extracting .exe for Windows 95/98/ME/NT/2000/XP (threaded). * pcsv7.0-ti3le.tar.gz: Petite Chez Scheme for Intel Linux (threaded). * pcsv7.0-tsps2.tar.gz: Petite Chez Scheme for Sparc Solaris 2.x (threaded 32-bit). * pcsv7.0-tsp64.tar.gz: Petite Chez Scheme for Sparc Solaris 2.x (threaded 64-bit). Scheme Widget Library (SWL) * Under Windows, the Chez Scheme and Petite Chez Scheme installers automatically install SWL. * SWL-0.9z-1.i386.rpm: Scheme Widget Library RPM for Intel Linux. * SWL-0.9z-1.src.rpm: Scheme Widget Library source RPM for Intel Linux. * swl0.9z-1.pkg.tar.gz: Scheme Widget Library PKG for Apple PowerPC Mac OS X. * swl0.9z-src.tar.gz: Scheme Widget Library source. Tcl/Tk (required by SWL) * Under Windows, the Chez Scheme and Petite Chez Scheme installers automatically install Tcl/Tk. * tcl-8.3.3-62.i386.rpm: Tcl RPM for Intel Linux. Check www.rpmfind.net for the latest version. * tk-8.3.3-62.i386.rpm: Tk RPM for Intel Linux. Check www.rpmfind.net for the latest version. * tcl8.4.4.pkg.tar.gz: Tcl PKG for Apple PowerPC Mac OS X. Check tcl.sourceforge.net/ for the latest version. * tk8.4.4.pkg.tar.gz: Tk PKG for Apple PowerPC Mac OS X. Check tcl.sourceforge.net/ for the latest version. * tcl8.3.3.tar.gz: Tcl source. Check www.scriptics.com for the latest version. * tk8.3.3.tar.gz: Tk source. Check www.scriptics.com for the latest version. Installation Instructions Windows 95/98/ME/NT/2000/XP installation To install both Chez Scheme and Petite Chez Scheme under Windows, run csv70.exe. To install Petite Chez Scheme only (e.g., for home use or as part of a delivered application), run pcsv70.exe. Both also install SWL. Chez Scheme, Petite Chez Scheme, and SWL can be uninstalled via the add/remove programs icon in the control panel. Linux RPM installation The easiest way to install Chez Scheme under linux is via RPM if you have it. To use RPM, run rpm -i ChezScheme-7.0-1.i386.rpm To install Petite Chez Scheme under Linux, run rpm -i PetiteChezScheme-7.0-1.i386.rpm To install SWL under Linux, run rpm -i SWL-0.9z-1.i386.rpm You will first need to install Tcl/Tk 8.3 or later, as well as Chez Scheme, if not already installed. By default, the rpms do not build heap files. Heap files reduce startup times and increase sharing, but sometimes cause problems due to the inability of the system to allocate the required absolute address range. To force the rpms to build heaps, set the environment variable BUILDHEAPS to some non-zero value before running rpm. Chez Scheme, Petite Chez Scheme, and SWL can be uninstalled with rpm -e package-name. Source RPMS for both Chez Scheme and Petite Chez Scheme (containing RPM SPEC and binary tar.gz files) are provided to allow the binary RPM to be rebuilt (via rpmbuild --rebuild) in case of incompatibility with installed libraries. Debian users may be able to install the Linux RPMs using alien, e.g., alien -cd PetiteChezScheme-7.0-1.i386.rpm Mac OS X installation To install Chez Scheme under Mac OS X, unpack csv7.0-1.pkg.tar.gz and click on the pkg file. To install Petite Chez Scheme, use pcsv7.0-1.pkg.tar.gz instead. You will need the root (administrator) password to perform the installation. The package file installs an executable as /usr/bin/scheme (or /usr/bin/petite), which you can run in a new shell window by typing just scheme (petite), and a manual page, which you can access in a shell window by typing man scheme (man petite). To install SWL, you must first install Tcl and Tk by unpacking tcl8.4.4.pkg.tar.gz and tk8.4.4.pkg.tar.gz and clicking on the pkg files. Then unpack swl0.9z-1.pkg.tar.gz and click on the pkg file. This will install the SWL application (in the finder, select Go, then Applications, then SWL) and also the executable /usr/bin/swl in case you prefer to run SWL from a shell window. To uninstall Chez Scheme, remove /usr/lib/csv7.0, /usr/bin/petite, /usr/bin/scheme, /usr/man/man1/petite.1, /usr/man/scheme.1, and /Library/Receipts/pcsv7.0-1.pkg. To uninstall SWL, remove /usr/lib/swl0.9z, /usr/bin/swl, /Applications/swl.app, and /Library/Receipts/swl0.9z-1.pkg. Tarball installation To install Chez Scheme and/or Petite Chez Scheme from a .tar.gz file, first unpack the .tar.gz file. This will produce the directory csv7.0 containing the software. The file csv7.0/ReadMe contains installation instructions, but generally the following suffices: cd csv7.0/custom ./configure make install The configure script recognizes several options. To build the threaded version, if available, pass the --threads option to configure; to build the 64-bit Sparc version, if available, pass the --64 option. To force relinking of the executable image against local libraries, use --force-relink. To force heaps to be build, use --build-heaps. Run ./configure --help for more options. If you want to test the build before installation, consult the file csv7.0/ReadMe for instructions. To install both Chez Scheme and Petite Chez Scheme, use csv7.0-machine-type.tar.gz. To install only Petite Chez Scheme, use pcsv7.0-machine-type.tar.gz instead. For multiple .tar.gz files, it is safe and often desirable to unpack them into the same directory. You must run 'make distclean' between makes, then rerun './configure' for different machine types, however. To install SWL, unpack swl0.9z-src.tar.gz, which will produce the directory swl0.9z. Edit Mf-install if necessary to change installation target directories. Finally, run make install in swl0.9z. You will first need to install Tcl/Tk 8.3 or later, as well as Chez Scheme, if not already installed. NOTE: You must be running Chez Scheme, not just Petite Chez Scheme, to install SWL from source, since rebuilding SWL requires the compiler. Run 'make uninstall' to see uninstallation instructions (this will not actually do the uninstallation) for Chez Scheme or Petite Chez Scheme. To unistall SWL, remove /usr/bin/swl and /usr/lib/swl0.9z.