Here is a short list of all directories and what you can find
there:

src
    This directory contains the source for Crystal Space.
    It has (almost) everything you need to compile and run Crystal Space.
    In 'src' there are seven directories for the seven different layers:

    - geometry		basic 3D and 2D geometry stuff
    - util		utility classes
	- gfx		graphics related utility classes
	- input		input handling classes (system-independent)
    - engine		the portal based engine
	- basic		some imporant base classes for the engine
	- light		lighting system
	- objects	things and sprites
	- polygon	polygon related stuff
	- 2d		2D stuff (currently 2D sprites)
    - render		the renderer
	- software	stuff for the software renderer
	- softw16	stuff for the 16-bit software renderer
	- direct3d	the Direct3D hardware accelerated version
    - scripts		scripting system
    - general		general Crystal Space stuff
	- mazed		Crystal Space level editor (unfinished work!)
	- walktest	Crystal Space test program
	- cswstest	Test for CS Window System
	- simple	A simple example of a CS using program
    - system		system dependent stuff
	- def_sys	default implementations for system dependent routines
	- amiga, djgpp, maclib, svgalib, wcc, win32, xlib, os2, libggi
    - csws		First version of the CS window system

data
    Data directory for the Crystal Space executable. Here are all the
    levels that you can try (every level is a ZIP file).
    'large.zip' is the default level (see 'cryst.cfg').

csdoc
    Automatically generated documentation. This documentation is generated
    directly from the source code using Doc++. Open 'aindex.html' as the
    starting page for this documentation.

zlib
    A compression/decompression library. This is a seperate product
    from Crystal Space. You need to compile it first before trying
    to compile Crystal Space.
    There is a configure script that you can run.

libpng
    A library for reading PNG files. Normally Crystal Space requires this
    although you can disable it in 'cs.mak'. Compile this before
    compiling Crystal Space but after compiling zlib.
    Choose the right makefile for compiling.

libjpeg
    A library for reading JPEG files. Normally Crystal Space requires this
    allthough you can disable it in 'cs.mak'. Compile this before
    compiling Crystal Space.
    There is a configure script that you can run.

contrib
    Contributed code and utilities related to Crystal Space.

    - config
	This is a utility for easier editing of the 'cryst.cfg'
	file. It is currently for Windows and DOS only.

    - varia
	Here you can find contributed source code which has not
	yet been integrated into Crystal Space.
	- File.zip		Graphics file loading routines.
	- Mixing.zip		Soundblaster library.
	- Vm.zip		Virtual machine for scripting.
	- dj_joy.c		Joystick example code for DJGPP (DOS).
	- lin_joy.cpp		Joystick example code for Linux.
	- wcc_joy.*		Joystick example code for Watcom (DOS).

    - wcc_make.tgz
        This archive contains two fixed makefiles for zlib and libpng
        for Watcom.

docs
    Various documents describing Crystal Space and general
    mathematical stuff.

    - document.txt (RECOMMENDED READING!)
	Document describing how Crystal Space works in general with
	an introduction to portal rendering.

    - config.txt
	An explanation about all configuration file options ('cryst.cfg').

    - console.txt
	An explanation about all console commands.

    - keys.txt
	An explanation about all keys that you can use while the engine
	is running.

    - display.txt
	A small document explaining all the different Crystal Space display
	and texture modes.

    - cam_matr.txt
	Technical document describing how camera transformation
	works in Crystal Space.

    - texmap.txt
	Technical document on how the texture mapping equations work
	inside Crystal Space.

    - warping.txt
	Technical document on how space warping and mirrors work.

    - history.txt
	The developers history. What and when was this feature introduced
	and when was that bug fixed?

    - interface_cpp.txt
    - interface_h.txt
	Example code for porting to a new system (a bit outdated now).

    - light.txt
	Some ideas for dynamic lighting (not implemented in Crystal
	Space).

    - scripting.txt
	A proposal for a general scripting language system (this has
	more or less been implemented).

    - walkthru.txt
	A walk through of the rendering code. To make things easier if
	you want to learn how Crystal Space works.

    - whatsnew.txt
	What's new from 0.05 to 0.06 (see the history for things that
	have changed in beta 0.07).

    - worldfmt.txt
	First try at making a document for the world format. This
	file only contains a syntax with little explanation currently.
	More will be coming.

    - faq.html
	General questions.

    - todo.html
	What still needs to be done. If you're bored, why not read this
	file and try to fix all the things in there :-)

    - who.html
	Who is doing what. Always check this file before you start doing
	something (if 'something' has to do with Crystal Space of
	course :-)

attic
    This directory contains old code and algorithms which
    I find interesting but are not used (any more) by Crystal
    Space. I don't like to throw it away though. It may come in
    handy later.

