Toys and demos you can play with in this directory:

----------------------------------------------------------------------------
main.st

	is the jolt shell.  Just type 'make'.  Run it with './main' and type
	parse trees at the prompt.  See the next toy for more...

----------------------------------------------------------------------------
test.k

	is a small test script for jolt.  Type 'make run'.

----------------------------------------------------------------------------
boot.k
quasiquote.k
syntax.k
object.k

	boot.k loads up the other three files to create an environment within
	the jolt shell in which you can start to do interesting things.  Type

		./main boot.k -

	to load them all and drop into an interactive prompt.

----------------------------------------------------------------------------
input.k

	is an example of how a jolt script can yank control of its own parsing
	and evaluation away from the jolt shell during compilation.  Type

		./main boot.k < input.k

	to launch the example.  Then read and obey the comment in the input.k
	file.

----------------------------------------------------------------------------
test.st

	demonstrates some simple bindings to Xlib.  Run it with

		make test
		./test

	and then press the SHIFT key to cycle between the various demos.
	Note that many of the demos want you to click on things and/or drag
	the mouse around.

----------------------------------------------------------------------------
life

	is contains Conway's game of life running in an X11 window, ported
	from his Squeak version by Takashi Yamamiya.

----------------------------------------------------------------------------
test-widgets.st

	is a rough sketch of a 'widget' framework for the Xlib bindings.  Run it
	with

		make test-widgets
		./test-widgets

	and then try resizing the window, dragging the blue rectangle around,
	and editing the text inside it (the cursor keys should work).

----------------------------------------------------------------------------
cairo-app.st

	demonstrates the bindings to the Cairo (ne Xr) vector graphics library.
	Run it with

		make cairo-app
		./cairo-app

	and then try dragging the topmost circle around with the mouse.  Press
	ESCAPE when you're bored.

----------------------------------------------------------------------------
javascript
python

	contain totally fake versions of these scripting languages.  The surface
	syntax is similar but the semantics need a lot of work.

----------------------------------------------------------------------------
kgi.st
kgi.cgi

	demonstrates how to make jolt-based dynamic web content.  Build with

		make kgi

	then copy the four files kgi, kgi.cgi, mcoke.k and quasiquote.k to your
	web server's cgi directory (on Mac OS X this is probably
	/Library/WebServer/CGI-Executables/).  Make sure kgi and kgi.cgi are
	executable.

	Now point your web browser at 'http://localhost/cgi-bin/kgi.cgi'.

	Feel free to edit the script to do more exciting things.

----------------------------------------------------------------------------
coke-mode.el

	is for Emacs hackers who want prety colours when editing coke (.k)
	files.  If you don't know what any of that means, don't worry about it.
