1
0
mirror of https://github.com/20kdc/OC-KittenOS.git synced 2024-09-28 06:31:07 +10:00
OC-KittenOS/inst/symbolGuide.md

37 lines
1.2 KiB
Markdown
Raw Normal View History

2020-03-31 22:41:08 +11:00
# The Symbol Guide
The following prefixes are really special,
and are lexcrunch's responsibility:
"$$THING" : These are defines.
"$Thing" : Writes a global into stream. If not already allocated, is allocated a global.
DEPRECATED (yes, already):
"$NT|THING" : Allocates THING from temp pool
"$DT|THING" : Returns temp THING to temp pool
2020-03-31 22:41:08 +11:00
PROBABLY DEPRECATED:
"$NA|THING1|THING2" : Copies $THING2 to $THING1 in forwards table (not in backwards table)
"$DA|THING1" : Removes THING1 in forwards table.
2020-03-31 22:41:08 +11:00
"${" : Opens a frame.
"$}" : Closes a frame. (Attached temps are released.)
"$L|THING" : Allocates THING from temp pool, attaches to stack frame, writes to stream.
Use inside a comment to erase the written symbol
2020-03-31 22:41:08 +11:00
The rest are convention:
"$iThing" symbols are Installer Wrapper.
"$icThing" symbols are Installer Core.
"$dfThing" symbols are DEFLATE Engine.
"$bdThing" symbols are BDIVIDE Engine.
"$a0", "$a1", etc. are Local Symbols.
DEPRECATED, THESE ARE AN OLD MECHANISM, USE FRAMED TEMPS INSTEAD.
2020-03-31 22:41:08 +11:00
These are reserved only for use in locals.
(For loops count.)
"$lThing" symbols are used to name Local Symbols using aliases.
NO THEY ARE NOW USED FOR ALL TEMPS, INCLUDING LOCAL SYMBOLS