This is a test suite for Kansas.  The intent is to cover 100% of Kansas'
functionality with these test.  Right now the suite falls far, far short
of that goal, however.

The tests can be used as a functional as examples on how to do things
with Kansas.  They are commented to explain what is going on and may prove
useful as a learning tool.  They, however, also, at times, do things
incorrectly or inadviseadly, in order to test how the library copes
with that sort of use, so follow what you find in the tests with care.

And yes, I know that this is an undesireable combination -- tests with
examples.  On the todo list is to seperate this out into a direct, simple
red/green style set of tests and a seperate set of examples.

Run an individual test with:

ruby -I.. TESTNAME

or run the whole suite with:

runtests.sh

I know that runtests.sh is a hack, and I'm sure that there is a better
way to do this.  I'll improve this in the next release.

I must credit Avi Bryant for much of what is in the current test suite.
Much of the core of the tests is an adaptation of what was found in the
examples/ directory of his original Kansas release.  


Kirk Haines
