jewelforth

it's a subroutine threaded forth for linux x86_64. mostly made for personal stuff. it does not conform to any standards, i just implement what i want. if you use it and it breaks, too bad

public domain

dictionary

the dictionary follows a fairly standard format.

field	size	forth name
link to previous	8 bytes	LFA (link field address)
flag	1 byte	FFA (flag field address)
string length	2 bytes	NFA (name field address)
string	variable length	still NFA
code	variable length	CFA (code field address)

the one reserved register

the working stack pointer is r14. the other registers are used as general purpose registers; r11 in particular is the standard register used in compiling calls.

miscellaneous notes and stuff

COMPILE,

this is an STC forth so when we compile a call we have to write the bytes of a call in manually. x86_64 does not allow absolute jumps from an immediate address, so a wonky but hopefully not too slow solution is to compile literal address → W and then call W. It'll Be Fine?

• mov r11, [cfa] = 94 BB [CFA]
• call r11 = 41 FF D3

Some Links

• starting forth part 1: http://www.bradrodriguez.com/papers/moving1.htm
• jonesforth, public domain forth tutorial implementation which was significantly cribbed from and studied: http://git.annexia.org/?p=jonesforth.git;a=tree
• jonesforth nasm port: http://ratfactor.com/repos/nasmjf/

silly little plans

in-forth assembler

this would reap the most benefits from STC. probably look at dusk's assemblers for how it should look like or liek something liek dusk's lib/bm? idk something to do stuff Fast if u need. would be fun