SKETCHY LISP


	1) About

	| SketchyLISP
	| An interpreter for purely applicative Scheme
	|
	| Copyright (C) 2005,2006,2007 Nils M Holm. All rights reserved.
	|
	| See the file LICENSE for conditions of use.
	|
	| The official SketchyLISP web page is at:
	| http://www.t3x.org/sketchy/


	2) Latest News

	Added immutable vectors.

	Added Cygwin Makefile and sketchy.bat.

	Dropped CALL/CC. It is an interesting proof of concept, but of
	little real use in a purely functional interpreter.


	3) What is SketchyLISP?

	SketchyLISP is an embeddable interpreter for a purely
	applicative dialect of Scheme. It may be considered an
	implementation of pure LISP plus global definitions and
	some input/output functions.


	4) Supported Systems and Installation


	4.1 Supported Platforms

	The SketchyLISP core is written in pure ANSI C and hence
	compiles on any system providing an ANSI C (C89) compiler.


	4.2 Unix Installation

	If you are running FreeBSD, NetBSD, or Linux, you may use the
	supplied Makefile without modification:

	| make
	| make install  # root permissions required

	In case sketchy cannot find its shared library, you may have to
	run ldconfig(8) on /usr/local/lib (as root).

	If everything else fails, install sketchy-static instead.


	4.3 Cygwin Installation

	Just use the supplied Cygwin Makefile:

	| make -f Makefile.CYGWIN install

	You might have to add /usr/local/man to your MANPATH.

	You can use the batch file util/sketchy.bat to run SketchyLISP
	directly from the W*ndows desktop. Just place the file in a
	directory containing SKETCHY.EXE and the lib/, ext/, and src/
	subdirectories. Then edit the line containing

	| set PATH=%PATH%;C:\CYGWIN\BIN

	to include the directory holding the CYGWIN1.DLL file on your
	computer.

	CYGWIN1.DLL is part of Cygwin. It is not included in the
	SketchyLISP distribution, because it is licensed under the GPL,
	and I suspect that its source code is much larger than the
	SketchyLISP source code itself.


	4.4 Installation on other Systems

	If you plan to install SketchyLISP on systems that are not
	discussed here, you are currently on your own. That being said,
	the interpreter compiles fine using MinGW, Turbo C, and the
	Plan 9 ANSI/POSIX Environment (APE).


	4.5 Testing

	To test the interpreter, run

	| make test

	and/or

	| util/examine

	Note: On Cygwin util/examine will take some time.


	4.6 Configuration

	Finally, you should set the SKETCHYSRC environment variable to
	a colon-separated list of directories that contain packages and
	other frequently-used sources:

	| SKETCHYSRC=/usr/local/share/sketchy/ext:/usr/local/share/sketchy/src
	| export SKETCHYSRC


	5) Getting Started

	After installing SketchyLISP, the interpreter is started by
	typing

	| sketchy

	To get a list of meta commands (while running sketchy), type
	':help'.

	Typing

	| man sketchy

	at the Unix shell prompt will print the sketchy(1) man page.

	The location of the SketchyLISP reference manual depends on
	your environment. By default, documentation is located here:

	| /usr/local/share/doc/sketchy/index.html

	Example programs can be found here:

	| /usr/local/share/sketchy/src

	The library source code is here:

	| /usr/local/share/sketchy/lib
	| /usr/local/share/sketchy/ext


	6) Bugs

	There certainly are some.


	7) Contact

	Send your feedback to Nils M Holm <nmh@t3x.org>.

	If you want to support the author of SketchyLISP, consider
	buying a copy of

	"Sketchy LISP" (or another book of the same author) at

	| http://www.lulu.com/content/213736

	Thanks!