This is a Ksi (Ksi Scheme Interpreter), a portable,
embeddable Scheme implementation written in C.

Ksi provides a machine independent execution platform that
can be linked in as a library when building extensible programs.
And what is more important it is not a Guile. :-)

Please send bug reports to demakov@users.sourceforge.net
---------------------------------------------------------


Homepage
========

Ksi home page: http://ksi.sourceforge.net


Obtaining Ksi
=============

Ksi source code:   http://download.sourceforge.net/ksi/ksi-X.Y.Z.tar.gz
Ksi language docs: http://download.sourceforge.net/ksi/ksi-lang-X.Y.Z.ps.gz

    where X.Y.Z is a version of ksi.


Mailing lists
=============

You can get info about using the mailing list by sending a message
with just the word `help' as subject or in the body, to:

    ksi-devel-request@lists.sourceforge.net
    ksi-user-request@lists.sourceforge.net


About Current Distribution
==========================

Building and installing this distribution gives you:

ksi --- a stand-alone interpreter for Ksi, usually installed in
	/usr/local/bin.  With no arguments, this is a simple
	interactive Scheme interpreter.  It can also be used as an
	interpreter for script files; see the `ksi.info' file for details.

ksi-config --- a Ksi script, usually installed in /usr/local/bin,
	which provides the information necessary to compile and link
	your own programs against the Ksi library.

libgc.a --- an object library that contains a Hans Boehm's conservative
	garbage collector for C and C++.

libksi.a --- an object library containing the Ksi interpreter,
	usually installed in /usr/local/lib/ksi.  You can use Ksi in
	your own programs by linking against this.

libksi.so --- a shared version of the above, usually installed in
	/usr/local/lib/ksi.  You can use it in your programs
	instead of the static version of the library.

*.h --- header files needed for using of the Ksi interpreter in your programs,
	usually installed in /usr/local/include/ksi.

*.scm --- run-time support for Ksi: the module system,
	klos system, some R5RS code and other infrastructure.
	Usually installed in /usr/local/share/ksi.


*** See INSTALL file for instruction about building and installing Ksi.

*** See COPYING file for copyright's and terms.


The Ksi source tree is laid out as follows:
===========================================

doc:	The Ksi documentations.  Currently a russian version only.
	(The present release doesn't include complete documentation.)
	
example: Some examples.

ext:	Various useful libraries, both in Scheme and C.

gc:	Hans Boehm's conservative garbage collector.

interp: Stand-alone executable you can run.

lib:	Ksi's initialization code, and other infrastructure.

si:	The sources of the ksi interpreter.


Ksi has been tested on the following platforms.
===============================================

    i386 family:
	* Linux (kernel 1.2.x), gcc 2.7.2, gcc 2.8.1
	* FreeBSD (2.2.x), gcc 2.7.2
	* Windows (95, 98, NT, win-32s), Watcom C/C++ 10.6
	* MS-DOS with DOS4GW dos-extender, Watcom C/C++ 10.6
	* Windows (95, 98, NT), Visual C/C++ 4.2, 5.0, 6.0

Known bugs.
===========

    * Dynamic loading and shared version of ksi library
      can work on FreeBSD-2.2.x only when you do not store garbage collected
      objects in static variables.