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 Ksi is not a Guile ;-)

Please send bug reports to ksion@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

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


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.

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, *.ko --- run-time support for Ksi.
	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.
	(The present release doesn't include complete documentation.)

example: Some examples.

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

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, gcc
	* Windows (XP), Visual C 6.0

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

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