These tools and programs are still in flux. They only work in a cygwin environment (see www.cygwin.com). 

Directories:
build - makefiles, etc for how to make things
include - include files to libs, etc
lib - where the libraries are
progs - programs for testing, fun, etc
tools - tools that compile, dump, etc h8300s code
utils - some utilities

Progs - 
Almost all progs are built as .boot files. These files are loaded into the Cybiko during boot time and run until the Cybiko is reset. You will need the Cybiko SDK to get the console program that does the loading. There is a prog called loaderdemo that will load a program in to flash WIPING OUT CYOS. You will have to reflash your Cybiko to get CyOs so be careful trying loaderdemo unless you know what you are doing.

Libraries -
If you change something in a library, you must rebuild the library. Change to lib and type make. All out of date libraries will be remade and copied to the lib dir. Programs that used these libraries must be rebuilt as well since these libaries are static. 
The libary files are split into individual files because when you do a link only the needed files will be added to the .boot file. If all functions were in one file, then all functions would be included even if only one function was needed. When this all becomes a library put in flash, all functions will be included anyways, but for now it makes .boot files as small as posible.

** Things You must do to use these tools: **
If you have a V2 cybiko classic with a 1.1.7 ROM then in cyborn.mk in build dir: BOOTROM_VERSION = 117  If you dont have this, then set the 117 to none or the version that you do have.

The top directory - this one - can be anywhere. You must set CYBORNPATH equal to this directory so that the tools, etc can be found. I have mine on a server and then map that directory on my machine and set the path like this: 

export CYBORNPATH=/cygdrive/v/projects/cyborn

now when I change into a prog and type 'make' make knows where things are.

