# ASM SYNTAX

Grammar is described via
[McKeeman Form](https://www.crockford.com/mckeeman.html).

Instruction operands order resembles Intel syntax.

`digit(min, max)` is a representation of binary, octal,
decimal or hexadecimal integer in range `[min, max]`.
I don't want to describe grammar for integers because
it does not seem like a trivial task. Sue me.

```
asm
	expressions

expressions
	expression
	expression '\n' expressions

expression
	instruction
	byte-literal

byte-literal
	'BYTE' digit(0, 255)

instruction
	mov
	jmp
	'EQ'
	'GT'
	'LE'
	'NOT'
	shift
	'INC' register
	'DEC' register
	'ADD'
	'SUB'
	'AND'
	'OR'
	'XOR'
	'XNOR'
	'COMPL' register
	'SETC' carry
	'NOP'
	'HALT'
	'CLOAD' register
	'ZERO' register
	'DIV'
	'MUL'
	'SWAP'
	'PRTCHK'
	'PRTRD'
	'PRTWR'
	'LOAD'
	'STORE'

carry
    '0'
    '1'

mov
	'MOV' register-half ',' digit(0, 15)
	'MOV' register ',' register

jmp
	'JMP' digit(-16, -1)
	'JMP' digit(1, 16)
	'JMPC' digit(-16, -1)
	'JMPC' digit(1, 16)
	'AJMP' register
	'AJMPC' register

shift
	'SHR'
	'SHL'
	'ROTR'
	'ROTL'
	'SHR' register ',' digit(0, 7)
	'SHL' register ',' digit(0, 7)
	'ROTR' register ',' digit(0, 7)
	'ROTL' register ',' digit(0, 7)

register
	'R0'
	'R1'

register-half
	register '.l'
	register '.h'
```

Comments are introduced with `#`, like in Bash.

## Missing stuff

There are no labels.
We will probably implement them in future.
Or we will probably not.

## Sample program

```asm
MOV R0.l, 0xF
MOV R1.l, 0x3
ADD
MOV [0], R0
ZERO R0
HALT
```