Microsoft Windows 6.001 MIT Scheme Release Notes 3 February 1997 This note describes how to install the MIT Scheme 6.001 system under Microsoft Windows 95, Microsoft Windows 3.1 or Microsoft Windows NT. There is no Macintosh version. Read the instructions through carefully before proceeding. These instructions are written assuming that most people are running Windows 95 or Windows NT 4.0. If you are running Windows 3.1 or Windows NT 3.51 be sure to read the sections for these operating systems. System Requirements ___________________ . An Intel 486 based PC with VGA (or preferably SVGA) display card and monitor. . Microsoft Windows 95, Microsoft Windows 3.1 (not 3.0) or Microsoft Windows NT. Windows 3.1 emulation under OS2 will *not* work. . 8 Megabytes of physical (RAM) memory, with 16 Megabytes or more strongly recommended. . About 14 MB free hard drive space for the installation. MIT Scheme will require about 10 MB of space, after you delete the installation files. . If your computer is not networked, you will also need a 3.5" high density floppy disk drive and up to four formatted floppy disks to transfer files to your computer. What you need to download _________________________ There are seven files in the distribution. Which ones you need depends on your version of windows and whether you need to use floppy disks. Most people will need just the first three. README.TXT These instuctions. You will need them. UNZIP.EXE There are many version of unzip and not all of them do the right thing. Use this one. 6001DIST.ZIP (4MB) MIT Scheme. This ZIP file unpacks into two directory trees. 6001DIST.1 6001DIST.2 6001DIST.3 For people who want to install MIT Scheme on a computer that is not networked, 6001DIST.ZIP has been split into files that fit on a 1.4MB floppy disk. Note that README.TXT (this file), UNZIP.EXE and 6001DIST.1 all fit on one floppy disk. PW1118.EXE This is Microsoft's WIN32S compatibility software that allows Windows 3.1 to run 32 bit programs. You need this *only* if you are running Windows 3.1 Example 1: For Windows NT running on a networked computer with a web browser, you need just: README.TXT, UNZIP.EXE and 6001DIST.EXE Example 2: For a Windows 3.1 running on a stand-alone PC, you need to to use another computer to copy: README.TXT, UNZIP.EXE and 6001DIST.1 to floppy disk #1 6001DIST.2 to floppy #2 6001DIST.3 to floppy #3 PW1118.EXE to floppy #4 Downloading the software ________________________ The system is available from two sources: the 6.001 course page and the 6.001 Athena locker. If you have neither an internet connection nor an Athena account then you should contact the Head Lab Assistant. First, create a directory called C:\DOWNLOAD. To simplify the installation, all the files that you download should go in this directory. * From the 6.001 Course Page Use your web browser to go to the 6.001 course page (http://www.swiss.ai.mit.edu/~u6001). Follow the link called `Windows version of Scheme'. Get the files you need (e.g. in Netscape, hold down the Shift key and click the file name). Make sure that they are downloaded into the C:\DOWNLOAD directory. * From Athena You should copy the files from the win32 directory in the 6.001 Athena locker. The course notes explain how to connect to the 6.001 locker. One way to do this (if your computer is connected to MITNet) is to ftp the files into your computer: cd \download ftp ftp.dialup.mit.edu ftp> quote atch 6.001 ; same as attach 6.001 on athena ftp> cd /mit/6.001/win32 ftp> bin ; goes into binary mode ftp> get README.TXT ftp> get UNZIP.EXE ftp> get 6001DIST.ZIP Installation ____________ Make sure that all the files are in the C:\DOWNLOAD directory. Installation has three steps: . Installing the WIN32S system (Windows 3.1 only, described in a separate section) . Installing the Scheme system . Configuring the system Each step must be completed successfully before the next step will work. * Installing the Scheme system You will need 6001DIST.ZIP. The software occupies about 10MB of disk space. You need about 14MB free on your C: drive to install it. . Start up an MS-DOS command prompt. . Type in the following commands at the MS-DOS prompt: c: cd \ \download\unzip \download\6001dist.zip This creates two directory hierarchies, C:\SCHEME-7.4\ and C:\U6001\ . You may now delete c:\download and its contents. (There is a copy of UNZIP.EXE in \SCHEME-7.4\BIN which you might need for getting problem set code.) * Configuration: Windows 95 and Windows NT 4.0 MIT Scheme takes a lot of command line arguments. The easiest way to avoid having to remember these is to create some shortcuts in the Start menu. First add a new submenu to the Programs menu: 1. Right-click on the `Start' button and then click `Open' 2. Double-click the `Programs' folder 3. Click the `File' menu and point to `New' 4. Click `Folder' and type in `6.001' 5. Press the Enter key and double-click on the folder you just made. Now create shortcuts for Scheme and the documentation files as follows: 1. In the new 6.001 folder click on the `File' menu and point to `New' 2. Click on `Shortcut'. This will start the `Create Shortcut wizard' 3. Enter the following command line (all on one line). c:\scheme-7.4\bin\scheme -library c:\scheme-7.4\lib -heap 500 -band 6001.com -eval (edit) 4. Click the `Next>' button. 5. Enter `Scheme' for the name and click `Finish' Create shotcuts for the documentation files the same way, but enter different command lines and names: Reference Manual: Command Line: winhelp c:\scheme-7.4\doc\scheme.hlp Name: MIT Scheme Reference Manual User's Manual: Command Line: winhelp c:\scheme-7.4\doc\user.hlp Name: MIT Scheme User Manual R4RS: Command Line: winhelp c:\scheme-7.4\doc\r4rs.hlp Name: Revised^4 Report Finally, the Scheme shortcut needs a refinement: 1. Single click the Scheme shortcut. 2. Select the `Properties' item in the `File' menu. 3. Select the `Shortcut' panel 4. Change the `Start in' line to: c:\u6001\work When you follow the Start button menu to Programs, 6.001, Scheme you should get an Edwin screen like in the 6.001 Lab. * Configuration: Windows 3.1 and Windows NT 3.51 In Windows 3.1 or Windows NT 3.51 you can create a Program Manager group containing icons to click to start Scheme or read the documentation. . In the Program Manager, use the File|New menu item to create a new Program Group. Call it `6.001'. . Create a Program Item with the following properties: Description: Scheme Command Line: c:\scheme-7.4\bin\scheme -library c:\scheme-7.4\lib -heap 500 -band 6001.com -eval (edit) (all on one line) Working Dir.: c:\u6001\work Run Minimized: check . For the documentation, create Program Items with these properties: Description: MIT Scheme Reference Manual Command Line: winhelp c:\scheme-7.4\doc\scheme.hlp Description: MIT Scheme User Manual Command Line: winhelp c:\scheme-7.4\doc\user.hlp Description: Revised^4 Report Command Line: winhelp c:\scheme-7.4\doc\r4rs.hlp When you click on the 6.001 Scheme icon you should get an Edwin screen like in the 6.001 Lab. Notes on running Scheme _______________________ If you get the error message "procedure string-allocate failed to ..." or something similar you can increase the size of the `-heap' parameter to `-heap 1000' to tell Scheme to allocate more memory. This should make the problem go away, but it will cause Scheme to slow down considerably due to paging if your computer has just 8 or 12 MB of memory. For the curious, the `-heap' parameter is described in the Users Manual. Using Floppies ______________ If your computer is not networked you can install Scheme by using an Athena or a friend's computer to copy the files onto floppy disks. Then copy files from the floppies into the C:\DOWNLOAD directory. Now reconstruct the 6001DIST.ZIP file by entering the following commands at an MS-DOS prompt: c: cd \download copy /b 6001dist.? 6001dist.zip You can now delete the 6001DIST.? files. Continue with the main installation. 6.001 Problem sets __________________ We will make problems sets available for Windows users as they are prepared by 6.001 staff. Problem sets will be made available in the 6.001 locker. Generally, they will consist of .scm files. There should be a probsets.scm file, and other .scm files. The probsets.scm file should replace your current probsets.scm file (which will be in c:\u6001\psets). The other .scm files should be placed in the c:\6001\psets\ps? directory (where ? is the number of the problem set). You may have to create this directory. There may be additional instructions associated with installing some problem sets in the 6.001 locker. You may see problem sets in the 6.001 locker before they have been handed out in class. You should not download the problem set files until after the problem sets have been handed out. Early versions of a problem set may be incomplete or not fully debugged. Installing the WIN32S system for Windows 3.1 ____________________________________________ This step is required only for Windows 3.1. Do not do this step if you are running Windows 95 or Windows NT goto step 2. To install WIN32S you will need the PW1118.EXE file. . Start an MS-DOS window. Use the MS-DOS window to enter the commands in the rest of these instructions. . Enter the following instructions. They create a directory called C:\DOWNLOAD\WIN32 and run PW1118.EXE in that directory. c: cd \download mkdir win32s copy pw1118.exe win32s cd win32s pw1118.exe . Follow Microsoft's instructions in C:\DOWNLOAD\WIN32S\README.TXT . When the setup program asks if you want to install the Freecell game, answer `Yes'. When installation is complete, run the Freecell game (it is a card game). Hopefully it will work. If the system will not run the game then neither will it run MIT Scheme. If Freecell won't run we cannot help. You might try removing drivers from your AUTOEXEC.BAT and CONFIG.SYS files. It is possible that WIN32S is already installed on your computer. If this is the case the installation process will tell you. General Questions _________________ If you have any questions or problems with this installation, send email to 6001-head-la@ai.mit.edu. Reporting Bugs ______________ Bug reports should be sent to bug-cscheme-win32@zurich.ai.mit.edu Do not send bug reports to any other address. When reporting bugs be as specific as possible. General or vague descriptions are not very helpful. Use these headings as examples to guide your report: You: you@Athena Problem set: ps4 OS: Windows 3.1 or NT Hardware: Dell 466ME, 32MB Ram, 486DX2, Description: An _exact_ description of what happens. Example: Try to narrow it down to a repeatable small example, like a small file that always causes the problem when loaded into the system straight after startup. If the 6.001 Lab computers do the same thing it is not a bug, or at least not a bug in the Windows port. Differences between this version and 6.001 Lab version ______________________________________________________ . On starting up Scheme there is no login screen with the options to work from your floppy. You are responsible for ensuring that the files that you edit are saved. We suggest that you always copy your work onto your floppy as this will enable you to work both on your PC and in the 6.001 Lab. . Debugging information for the runtime system is not available, so you will not be able to pretty-print system code. Other Notes ___________ It is easiest to leave the files where they are installed by the instructions above, but if you need to move the files around on your PC here are some details. MIT Scheme does not have to be installed on drive C: If you want to install it on another drive, change the drive letters appropriately. If you want to move the u6001 directory, for example, to D:\CLASSES\U6001, you will need to do the following: . Make scheme start up in the right place my changing the shortcut `Start in' item to, e.g., d:\classes\u6001\work . Tell Scheme where it is before you use M-x load-problem-set, for example: (set-u6001-dir! "d:/classes/u6001") Note the forward slashes. (You might want to investigate doing this automatically in an initialization file. See the User's Manual for details.) Debugging information for the standard procedures is available if you also download W32RTBCI.ZIP. The debugging information allows you to pretty-print the standard procedures. Start a command shell window and use it to enter the following commands: c: cd \scheme-7.4\lib mkdir SRC cd SRC c:\scheme-7.4\bin\unzip c:\download\w32rtbci If you do this be sure to increase the `-heap 500' to at least 1000 to make room for the debugging information Printing Scheme Graphics ________________________ The 6.001 Lab command M-x print-graphics does not exists on the PC version. Instead, use the following incantation to save the graphics window as a bitmap (.BMP) file: (graphics-operation g1 'save-bitmap "c:/temp/foo.bmp") Now print the bitmap using your favourite software, for example the Paintbrush program.