[colorforth] Meta-assembling colorforth

[albert@xxxxxxxxxxxxxxxxxx (Albert van der Horst)]

Reassembling colorforth                         UTRECHT 2005 june 14

The stuff talked about here can be found by clicking on FTP
on my home page below. Then
    cd pub/colorforth/finalsmall

Get all files from that directory. ( binary  mget * ).

README.TXT              This file
cias+                   Two pass ForthAssembler (configured)
colorabs.cul            Absolute labels
colorbald.asm           Source of colorforth

On a linux system colorforth can be reassembled by the command

    cias+ colorbald.asm color.com

colorbald.asm is the direct output of version 1.58 of the
disassembly process. Except that some comment ( indicating addresses)
has been removed.

Don't worry about ISN'T UNIQUE messages. This is a two pass assembler
and EQU labels are compiled twice. "Phase errors" are indicative
of problems.

The result is a replica of the original
COLOR.COM of Chuck Moore, except:
1. It contains zero's in what is believed to be don't care areas.
2. The dictionary tables for forth and macro are automatically
generated, and have the words in the order they appear in the source.

cias+ is an experimental version of ciasdis with SEGMENTS,
with colorname.frt loaded on top of it. Colorname.frt understands
the particular syntax used in the blocks, and has the
word >CN to convert a string to a colorword token/Huffman encoded
string. If you want to see source look around in pub/colorforth.

If you want to change assembler code, you can find a manual for the
assembler in
http://home.hccnet.nl/a.w.m.van.der.horst/forthassembler.html

Be warned that the resulting color.com may have to be debugged still.
(I can't run the original COLOR.COM myself.)
In particular after modifications (if you shift the code) a crash may
result if I interpreted some address as an absolute number or vice versa.

The SEGMENT additions are not yet documented, they are a
feature added in behalf of colorforth.  Leave them alone.
However, changing the addresses of the dictionary tables in colorabs.cul
should not present problems, nor should the introduction of new screens.

Have fun!

--
Albert van der Horst,Oranjestr 8,3511 RA UTRECHT,THE NETHERLANDS
Economic growth -- like all pyramid schemes -- ultimately falters.
albert@xxxxxxxxxxxxxxxxxx http://home.hccnet.nl/a.w.m.van.der.horst

---------------------------------------------------------------------
To unsubscribe, e-mail: colorforth-unsubscribe@xxxxxxxxxxxxxxxxxx
For additional commands, e-mail: colorforth-help@xxxxxxxxxxxxxxxxxx
Main web page - http://www.colorforth.com