OS Notes:

This document is written with the Mac in mind. You will be installing DrRacket and additional files. On a Mac, DrRacket will go in the Applications folder; /Applications to be more precise. The equivalent directory on a PC is C:\Program Files (x86). Any reference to /Applications on the Mac in these directions should be translated to C:\Program Files (x86) on a PC. (NOTE: I am aware that not everyone uses the C: drive on a PC for applications. If you have customized your PC to use an unconventional way of organizing your content, that's great! Just use your own setup instead of C:\Program Files (x86) when it comes to installation.)

I haven't tried installation with Linux; my guess is that if you are motivated enough to use Linux, you'll figure this out. If not and you have Linux on a laptop, bring it to me at school and we will try to help you with your installation.

To install DrRacket on a Mac:

STEP 0

Download DrRacket from https://download.racket-lang.org/ and use the DMG file to install. Move the resulting folder into the Applications folder. (DrRacket makes this pretty obvious.) Please note that the installation takes a little bit of time--be patient!

 

STEP 1

To set up base Simply Scheme code with DrRacket :

1. Open DrRacket. Notice that in the interactions area (bottom half), there is a complaint that a language must be chosen. Note that there is a Languages menu; inside it will be no mention of Simply Scheme at this point.

2. Under the File menu, select Package Manager...

3. Click on the "Available from Catalog" button at the top center of the window.

4. Type in "simply-scheme" (without the quotes) into the filter. That will reduce the packages you can see to only ones with "dyoo" in them. (If you don't see simply-scheme listed, click the Update Package List button in the Package Manager.)

5. Quit DrRacket and reopen it.

6. Scroll down to the package "simply-scheme". Select it and click Install.

Installation may take up to a minute, depending on your Internet connection.

7. Quit DrRacket without saving.

8. Open DrRacket.

9. Under the Languages menu, select Choose Language. Simply Scheme should now appear under Teaching Languages. Select it and then click Run.

10. Test by typing “se” (without the quotes) in the interactions area (bottom half of the window). If it indicates that se is a procedure, everything is good. If an error is produced, then something went wrong during installation.

11. Rename the “Racket 6.9” (or whatever the most recent version is) folder in the /Applications folder to “Racket” (without the quotes).

STEP 2

If you are taking FOOP, do the following to get the other Simply Scheme files in place so they can be loaded when needed:

1. Get the scheme.zip file from http://paleyontology.com/scheme.zip, and extract it, producing a folder called "scheme". Put this folder into the Racket folder. Some load commands may not work without the scheme folder being inside the Racket folder.

2A. Test by typing the following in the definitions area:

(load “/Applications/Racket/scheme/ttt.scm”)

and then click Run.

2B. If you are on a PC, test by typing the following in the definitions area:

(load “C:\\Program Files (x86)\\Racket\\scheme\\ttt.scm”)

and then click Run. Note that the double-backslashes are needed. Also note that "C:\\Program Files (x86)" only applies if that is where you put your DrRacket folder. If you put it elsewhere, you need to type a path that takes you to the folder where you put Racket.

3. In the interactions window, type “ttt” without the quotes. If it indicates that ttt is a procedure, everything is good. If an error is produced, then the place where ttt.scm is located is not under
/Applications/Racket/scheme. Go back to step 2 and make sure that the Scheme folder is really
inside the Racket folder which should be inside the /Applications folder.

NOTE: As of this writing, random numbers using this Simply Scheme installation produce the same sequence of numbers. This is a known issue, and the author of the Simply Scheme content that goes with DrRacket is aware of it and working on it. (June 23, 2017)