#lang scribble/doc @; $Id: sicp.scrbl,v 1.39 2009/05/17 22:38:28 neilpair Exp $ @(require scribble/manual) @title[#:version "1.10"]{@bold{SICP} Support in PLT Scheme} @author{Neil Van Dyke} @section[#:tag "introduction"]{Introduction} @emph{NOTE: This version of this package is a work-in-progress, and is not yet intended for use by arbitrary students. The goal of this version is to permit the more adventurous to help test and polish this package, so that in the future it can provide a smooth experience for students. Please direct feedback to @link["http://www.neilvandyke.org/"]{Neil Van Dyke} (neil AT neilvandyke DOT org). Regression tests based on code from the SICP book or from exercises, like is shown in file @tt{test-ch-1.ss}, are also welcome.} This package implements support in @link["http://www.plt-scheme.org/"]{PLT Scheme} to permit students of Abelson and Sussman's @link["http://mitpress.mit.edu/sicp/"]{@emph{Structure and Interpretation of Computer Programs}} (@as-index{SICP}) textbook to use PLT Scheme tools for the programming assignments. The main reason students may wish to use this package is so that they can use PLT Scheme's @link["http://plt-scheme.org/tour.html"]{DrScheme} programming environment. Note that this package is not a project of the PLT organization. PLT has a related textbook, @link["http://htdp.org/"]{@emph{How to Design Programs}} (@as-index{HtDP}), with a different emphasis and a different pedagogic approach. A comparison of the two textbooks is beyond the scope of this document. A 2004 paper by some PLT members, ``@link["http://www.ccs.neu.edu/scheme/pubs/jfp2004-fffk.pdf"]{The Structure and Interpretation of the Computer Science Curriculum}'' [PDF], provides a PLT perspective on the differences. The official Web page for this package is: @link["http://www.neilvandyke.org/sicp-plt/"]{http://www.neilvandyke.org/sicp-plt/} @section[#:tag "installation"]{Installation} Installing this package consists simply of @tt{require}-ing it from the Internet-based PLaneT software repository, and then restarting DrScheme. The steps in detail for how a beginner may do this through DrScheme are: @itemize[ @item{0. If you a previous verson of this package from PLaneT installed, remove it. If the version is 1.9 or later, go to the @onscreen{Interactions} subwindow in @onscreen{SICP} language, and evaluate the command @scheme[(uninstall-sicp)]. If you have an older version installed, use the @tt{planet show} and @tt{planet remove} operating system command-line commands to remove it.} @item{1. Make sure that the computer connected to the Internet.} @item{2. Start DrScheme.} @item{3. Change the DrScheme Language to @onscreen{Module}. Specifically, select @menuitem["Language" "Choose Language..."] to get the @onscreen{Choose Language} dialog, then select @onscreen{Module} and click @onscreen{OK}.} @item{4. In the top @onscreen{Definitions} subwindow, change the contents to read: @verbatim[ "#lang planet neil/sicp\n" ]} @item{5. Click the @onscreen{Run} toolbar button.} @item{6. Wait for the @onscreen{>} prompt to appear in the @onscreen{Interactions} subwindow, which may take a few minutes, due to compiling PLT documentation. Then quit DrScheme and start it again.} ] @section[#:tag "usage"]{Usage} There are two separate ways to specify use of the SICP Language in DrScheme: @itemize[ @item{Change the Language to @onscreen{SICP}, such as by using @menuitem["Language" "Choose Language..."]. This is the normal way.} @item{When using the @onscreen{Module} language, begin the Scheme file with the line: @verbatim[ "#lang planet neil/sicp\n" ]} ] This package uses the @link["http://planet.plt-scheme.org/display.ss?package=sicp.plt&owner=soegaard"]{soegaard/sicp} PLaneT package by Mike Sperber and Jens Axel Soegaard to implement the SICP Picture Language. Note that you should @emph{not} use the @tt{require} form shown in the documentation for that package --- this package provides the SICP Picture Language implicitly. @section[#:tag "history"]{History} Note that PLaneT package version numbers of @tt{neil/sicp} are used, rather than maintaning separate version numbers. @itemize[ @item{Version 1.10 -- 2009-05-17 Fixed packaging problem and documentation problem.} @item{Version 1.9 -- 2009-05-17 Made @tt{cons-stream} use immutable pairs. (Thanks to Vinay Sachdev for reporting the @tt{cons-stream} problem affecting SICP sec. 3.5.1.) Added documentation about installing prior versions before installing. Added @tt{uninstall-sicp} procedure. Changed @tt{info.ss} to permit multiple versions to be installed simultaneously. Added @tt{sicp-small.png} icon. Improved installation documentation.} @item{Version 1.8 -- 2009-05-16 Added @tt{random} procedure for SICP Exercise 1.22. Finished first pass of @tt{test-ch-1.ss}.} @item{Version 1.7 -- 2009-05-15 Added @tt{check-expect} syntax, for test suites. Added @tt{inc} and @tt{dec} procedures for SICP sec. 1.2.1 Exercises. Added @tt{random} procedure for SICP sec. 1.2.6. When using this package from a normal PLT collection, rather than from PLaneT, the language name is now @onscreen{SICP} rather than @onscreen{SICP (Non-PLaneT)}. Added partial test suite for SICP ch. 1. Minor documentation changes.} @item{Version 1.6 -- 2009-05-05 Installation documentation change.} @item{Version 1.5 -- 2009-05-05 Installation documentation change.} @item{Version 1.4 -- 2009-05-05 Changes to work correctly with PLaneT and cause fewer conflicts from mixing multiple versions in @tt{PLTCOLLECTS} and PLaneT cache at once.} @item{Version 1.3 -- 2009-05-04 PLaneT packaging corrections and addition of index entries.} @item{Version 1.2 -- 2009-05-04 PLaneT packaging correction.} @item{Version 1.1 -- 2009-05-04 PLaneT packaging corrections. Also switched to using PLaneT package version numbers.} @item{Version 1.0 -- 2009-05-04 Documentation added. First public release.} @item{No Version -- 2009-04 Initial version by Neil Van Dyke. Uses Sperber and Soegaard's Picture Language implementation by @tt{require}-ing from PLaneT. Non-public distribution.} ] @section[#:tag "legal"]{Legal} Copyright (c) 2009 Neil Van Dyke. This program is Free Software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License (LGPL 3), or (at your option) any later version. This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See http://www.gnu.org/licenses/ for details.