10-README.txt Popforth 4.0a 20101212 DAW

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.

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.

You don't HAVE to do this if you are not interested in testing the kernel. 
Most users can skip it, we post it so you know what we do

11-readme.txt       -  readme for regression section
12-PropForthCore.f  -  this contain the forth definitions for the minimal propforth kernel
                       PropForthCore.f	is the highlevel forth code which define the kernel functions                        
13-spinmaker.f      -  this set of functions make a new propforth.spin source code.
                      spinmaker.f	is used to generate new spin code, used to build a new core
                      Notice -  this isnot the FULL propforth.spin, you still have to do some editing
                      That bit is explained elsewhere in the documentatin (correct reference to be added later)
                      spinmaker.f taqkes whatever is in the currently running propforth dictionary,
                      and TRANSLATES those forth dictionary entries into SPIN CODE.  
PropForth.spin		  - spin file, load this into eeprom.  The output of spinmake gets pasted into propforth.spin
                      between line 838 ForthDictStart and line 5307 ForthMemoryEnd   

Standard regression test process:

1. Connect Propclip to the Spinneret Board and load Propforth.spin into eeprom.
2. Connect PropClip to the Prototype Board and laod Propforth.spin into eeprom.

THIS SET OF TESTS ALL RUN ON THE Proto Board

3. start teraterm, 57kB not other setting change necessary
4. hit enter, words <enter> make sure forth is alive
5. paste contents of PropForthCore.f into teraterm
6. paste the contents of spinmaker.f into teraterm
7. run spinmaker
8. compare the output of spinamker to PropForth.spin (where the dictionary starts, I use windiff)
	(should be no differences) this verifies the PropForthCore.f code base is reproducable

NOTE ADDED to ORIGINAL 4.0 README.txt 
The above used jhigh level forth definitions to re-create the spin code that make up propforth.
These replace the lines in propforth.spin between 
line 838 ForthDictStart    
and 
line 5307 ForthMemoryEnd   

This is also the method to MODIFY the kernel.  
You can modify the high level forth definitions in PropforthCore.f
Or you can directly modifiy the spin code in Propforth.spin

In ether case, if you can use spinmaker, paste the output into propforth.spin, and   
and get the same results twice in a row, you are probably successful.
If you cannot get the same results twice in a row, 
please post on the parallax forums to let us know what is going on if you want help.  
