This is propforth Version 4.0a this work started 20101212-1219 
It is an update of v4.0 to re organize the source and documentation and fix typos

The files are numbers so they appear in the sequence they are used.
00-, 01-, 02- are the initial setup.
11-, 12-, 13-, are the regression tes / regenerate spin section
20-, 21-, ..., 29- are the examples using the EEPROM file system
30-, 33-,  ..., 39- are the same exa,ples with out the EEPROM file system

NOTE: another section 40- etc will be added (maybe for release Propforth4.0B)
that used demoboard hardware, time permitting

There are no significant changes to version 4.0 from 2010 Nov 29
But the instructions should be easier to follow. 

Braino

VERSION 4.0 - RELEASE

QA 2010 NOV 29

Some changes from the 3.x code stream.

1. The IO structure has been completeley regularized. It was ok in 3.6, but as more peripherals were added,
they were somewhat divergent from the regular structure. Cogs now all adhere to the same IO structure, which makes it
very easy to connect IO.

2. The core is now a minimum, almost. PropForthPart1.f and PropForthPart2.f have been replaced with PropForthCore.f.
The forth is a subset. Load in the file PropForth.f and do a saveforth to get a fuller forth.

3. An optional load structure [if   ] has been added for configuration management reasons.

4. A very simple file system for the 64Kx8 eeproms has been added. Thisa allows saving files to the upper part of
eeprom not used by the propeller. Can extend to use mulitiple 64kx8 eeproms, tested up to 3 64kx8 eeproms. fs.f

5. The data area size for each cog has bee shrunk to 224 bytes.

6. Only one forth cog now starts up, COG 6, it then starts everything else. This make initialization much simpler. 
COG 6 now starts up the default serial cog. As a resultit is very easy to add additional serial cogs.
All cogs are started now by the default routine.

7. fl was changed to load the file as it comes in. This takes advantage of the regular IO structure, where a COG
reads the input, and routes it to another cog. A change in behaviour, the cog which compiles the code is not the 
cog the fl command was executed on. Only important when modifying cog specific variables.

8. Free cogs are now deemed to be any with no IO connected.

9. Regular structure established for cog status, any non forth cogs must adhere to this.

CONTENTS of this release

PropForth.spin		- spin file, load this into eeprom 
spinmaker.f		    - used to generate new spin code, used to build a new core
PropForthCore.f		- the forth code which is necessary to run and rebuild worth
PropForth.f		    - the additional forth words 
LogicAnalyzer.f		- a very simple and effective Logic Analyzer, used to look as signals
norom.f		      	- a set of routines which emulate an eeprom, and allow the booting of a slave chip
com.f		        	- a high speed synchrounous set of IO channels between 2 props, uses only 2 pins
comnorom.f		    - combines norom & com, to boot a chip with no eeprom or XTAL, and then uses the pins
            			  normally used for the eeprom to provide 8 synchronous channels
asm.f			        - an assembler 
snet.f			      - configuration to drive the Spinneret board
fs.f			        - the file system
README.txt	      - this file
spinneret_eth.f		- beginnings of a new ethernet driver for PropForth, will use this as a development example, function first,
			              verification, followed by optimization

 The code and documentation have been oreorganized as follows:

Section 0 - the overview section 

The 01-readme.txt file (this file) and the other files with 0x- numbering
The 02-propforth.spin - use proptool to load this into EEPROM for a minimal kernel

Section 1 - regression test

The regression test is used to verify that all the propforth functions still work.  
The method is to use propforth to re-create propforth.spin

The idea is that if propforth can create an identical copy of itself, it probably works. 
This is not garanteed to catch all errors, but it is cost effective and generally does the job.

11-readme-regression.txt       - readme for regression section

Section 2 - EEPROM mini file system 

PropForth should run on just about any configuration. 
The mini file system requires 64k of greater EEPROM
So it pretty much work on anything except the demo board. 
If you have a demo board, please see the addendum which does not use the fs.f EEPROM mini file system  
The addendum will be released later time permitting


PropForth.spin	- spin file, load this into eeprom 
PropForth.f		  - the additional forth words 
LogicAnalyzer.f	- a very simple and effective Logic Analyzer, used to look as signals
norom.f			    - a set of routines which emulate an eeprom, and allow the booting of a slave chip
com.f           - a high speed synchrounous set of IO channels between 2 props, uses only 2 pins
comnorom.f		  - combines norom & com, to boot a chip with no eeprom or XTAL, and then uses the pins
          			normally used for the eeprom to provide 8 synchronous channels
asm.f - an assembler -not used in this set of instructions 
snet.f          - configuration to drive the Spinneret board
fs.f            - the EEPROM mini file system (64K or greater EEPROM Required)
README.txt	    - this file
spinneret_eth.f - beginnings of a new ethernet driver for PropForth, 
                will use this as a development example, function first,
                verification, followed by optimization
