Improved docs

This commit is contained in:
neauoire 2021-02-08 14:49:45 -08:00
parent 635d3de67b
commit 5e80946097
2 changed files with 12 additions and 18 deletions

View File

@ -1,32 +1,26 @@
# Uxn # Uxn
A stack-based VM, written in ANSI C. A [stack-based VM](https://wiki.xxiivv.com/site/uxn.html), written in ANSI C.
## Build
```
cc uxn.c -std=c89 -Os -DNDEBUG -g0 -s -Wall -Wno-unknown-pragmas -o uxn
```
## Assembly Syntax ## Assembly Syntax
### Write ### Write
- `;variable`, set a label to an assigned address - `;variable`, automatically assign an address to a label.
- `:const`, set a label to a constant short - `:const FFCF`, manually assign an address to a label.
- `@label`, set a label to an address - `@label`, assign the current address to a label.
### Read ### Read
- `,literal`, push label value to stack - `,literal`, push label value to stack, prefixed with `LIT LEN`.
- `.pointer`, read label value - `.pointer`, push label value to stack.
### Special ### Special
- `( comment )`, toggle parsing on/off - `( comment )`, toggle parsing on/off.
- `|0010`, move to position in the program - `|0010`, move to position in the program.
- `"hello`, push literal bytes for word "hello" - `"hello`, push literal bytes for word "hello".
- `#04`, a zero-page address, equivalent to `,0004` - `#04`, a zero-page address, equivalent to `,0004`.
### Operator modes ### Operator modes
@ -68,7 +62,7 @@ BRK
|FFFA .RESET .FRAME .ERROR |FFFA .RESET .FRAME .ERROR
``` ```
## Mission ## TODOs
### Assembler ### Assembler