d6
/
uxn11
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify number representations 

- relative addresses are signed
 - byte-order is big endian (#abcd = #ab #cd)

Also fixes a misspelling.
This commit is contained in:
~d6 2024-09-20 21:29:43 -04:00
parent 9530e7b13a
commit 126efb84f4
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/man/uxntal.7
View File

@ -3,7 +3,7 @@
.\" Contact d_m@plastic-idolatry.com to correct errors or typos. .\" Contact d_m@plastic-idolatry.com to correct errors or typos.
.TH uxntal 7 "05 Aug 2024" "1.0" "Uxntal Reference Guide" .TH uxntal 7 "05 Aug 2024" "1.0" "Uxntal Reference Guide"
.SH NAME .SH NAME
uxntal \- assembly langauge for Varvara virtual machine uxntal \- assembly language for Varvara virtual machine
.SH DESCRIPTION .SH DESCRIPTION
Uxntal is an 8-bit instruction set for programming the Varvara virtual machine. Uxntal is an 8-bit instruction set for programming the Varvara virtual machine.
It uses the lower 5-bits to specify an opcode, and the upper 3-bits to specify It uses the lower 5-bits to specify an opcode, and the upper 3-bits to specify
@ -15,7 +15,9 @@ Instructions manipulate data using two stacks: a working stack (\fBwst\fP) and a
There are also 256 bytes of device memory, which are used to interact with the virtual machine and its devices. There are also 256 bytes of device memory, which are used to interact with the virtual machine and its devices.
Instructions deal with unsigned 8-bit values (\fIbytes\fP) and unsigned 16-bit values (\fIshorts\fP). There are no other built-in data types. Instructions deal with unsigned 8-bit values (\fIbytes\fP) and unsigned 16-bit values (\fIshorts\fP). There are no other built-in data types. Occasionally values are treated as signed, such as when loading, storing, or jumping with a relative address.
Short values are stored on the stack in big-endian byte order: the least significant byte will be on the top of the stack. This makes \fB#abcd\fB is equivalent to \fB#ab #cd\fB.
.SH INSTRUCTION LAYOUT .SH INSTRUCTION LAYOUT