The format of the file is recursive and Lisp-like, with lots of parentheses. The syntax is somewhat cryptic and there are a few keywords which need to be understood.
Note: not all features have been fully developed. Be cautious!
Also note: the error handling of the parser has not been `bombproofed', so try to get the syntax correct!
Also also note: this documentation is a very loose draft at present and full of holes.
A ';' begins a comment which continues to the end of the current line.
memory-ptr-width takes a single parameter which specifies the size, in bytes, of an address.
wordalign is a zero/non-zero value which - if non-zero - specifies that the display of memory words should be confined to appropriately aligned boundaries.
window-list determines how the majority of the main window is subdivided. It takes a string parameter which uses letters to specify panel types and '!' and '~' characters to divide the area recursively into panels. For example:
(window-list "M")creates a single, memory panel, whereas:
(window-list "~MM")produces two memory display panels split horizontally, and:
(window-list "~M!MM")will further split the lower panel vertically.
(regbanks 0 ; regbanks main-regbank (regbank-granularity 4) ; regbank minimum transferregbank takes five parameters:
(names "R0" "R1" "R2" "R3" "R4" "R5" "R6" "R7" "R8" "R9" "R10" "R11" "R12" ("R13" "SP") ("R14" "LR") ("PC" "R15") "CPSR" "SPSR")A list of 18 elements. The fourth register (for example) is called "R3"; the sixteenth element will be displayed as "PC" but can also be called "R15".
(GREEN 15)This causes the memory pointed to by the register number 15 to be highlighted in green.
Currently, three highlights are supported - it is easy to define more by editing the source code - which are:
compile-script takes a single, string parameter which, if present, overrides the function taken when the compile -> button is pressed. It is passed to the shell in the normal way.