Re: [Flashforth-devel] Elements of FlashForth tutorial

[Mikael N. <mik...@pp...>]

On 06/04/2013 05:37 PM, Peter Jacobs wrote:
> Michael, Peter Z,
>    I have another tutorial document ready for review.
> http://dropbox.eait.uq.edu.au/e4pjacob/flash-forth/eoff.pdf
>
> Although a colleague has already provided comments, it could do with
> further review from experts such as yourselves, if you have time.
> Cheers,
> Peter Jacobs.
First of all, thanks for sharing your work, very valuable.

One major thing I noticed is how you describe the forget and marker.
You have their roles swapped in the document.

Marker is best for shrinking the dictionary if you have defined words 
that allot ram or eeprom memory.
For the novice, it is simplest to assume this is always the case.

Forget is best used when you know  that all the words your are 
forgetting have only alloted flash memory.

It would be best to just leave out forget completely from the tutorial 
and use marker in all examples.

Another thing is the jump table. It is better to store the jump table in 
flash.
Then it works also after a power break. That is also the normal intended 
usage.
It also shows how elegantly FlashForth handles dataspaces in different 
memory types.
This is perhaps the major distinguishing feature of FlashForth and 
important to understand.

\ Set the data space allot context to flash memory
flash ok<#,flash>

\ Store the execution tokens in a table in flash memory.
create actions ' ring , ' open , ' laugh , ' cry , ok<#,flash>

\ Set the data space allot context back to ram memory
ram ok<#,ram>

I'll read further and maybe have some more comments.

Best Regards
Mikael