Introduction

This document describes how to install and use MIT Scheme, the UnCommon Lisp. It gives installation instructions for all of the platforms that we support; complete documentation of the command-line options and environment variables that control how Scheme works; and rudimentary descriptions of how to interact with the evaluator, compile and debug programs, and use the editor. The release notes are included as an appendix.

This document discusses many operating-system specific features of the MIT Scheme implementation. In order to simplify the discussion, we use abbreviations to refer to some operating systems. When the text uses the term unix, this means any of the unix systems that we support, including GNU/Linux, *BSD, HP-UX, Ultrix, NeXT, and SunOS. The term OS/2 means the IBM OS/2 operating system, version 2.1 or later. We use the term Windows to collectively refer to the Microsoft Windows operating systems: Windows 95, Windows 98, and Windows NT. We use the term PC to refer to any computer running OS/2 or Windows. Thus we consider a PC to be a system with a DOS-like file system, using backslashes for directory separators, drive letters, CR-LF line termination, and (potentially) the hideous 8.3 short filenames.

The primary distribution site for this software is

http://www.swiss.ai.mit.edu/ftpdir/scheme-7.5/ ftp://ftp.swiss.ai.mit.edu/pub/scheme-7.5/

Although our software is distributed from other sites and in other media, the complete distribution and the most recent release is always available at our site.

To report bugs, send email to `bug-cscheme@zurich.ai.mit.edu'. Please include the output of the identify-world procedure (see section 2.1 Basics of Starting Scheme), so we know what version of the system you are using.