From: Aaron Taylor Date: Mon, 31 Dec 2018 11:30:09 +0000 (-0800) Subject: Updated markdown in Instruction Reference to display as separate paragraphs. X-Git-Url: http://git.subgeniuskitty.com/ned1/.git/commitdiff_plain/ec3f5f9cd6794235f3a86deffdaaf5349fff58ec Updated markdown in Instruction Reference to display as separate paragraphs. --- diff --git a/docs/instruction_reference.md b/docs/instruction_reference.md index 690623d..fe0eee0 100644 --- a/docs/instruction_reference.md +++ b/docs/instruction_reference.md @@ -16,7 +16,9 @@ Format A - Word +----------+----+-------+ Operation: TOS = x + Indicators: None + Description: Pushes bits 30-0 on to TOS after left shift by one position and padding with zero bit. @@ -30,7 +32,9 @@ Format C - Syllables +----------+---+---+---+---+---+---+ Operation: TOS = x + Indicators: None + Description: Pushes bits 4-0 on to TOS while padding bits 31-5 with zeroes. -------------------------------------------------------------------------------- @@ -42,7 +46,9 @@ Description: Pushes bits 4-0 on to TOS while padding bits 31-5 with zeroes. +----------+---+---+---+---+---+---+ Operation: TOS = TOS[x] + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pushes a copy of the x'th entry on the stack to the TOS. Indexing begins at 0. Thus, LDSP+0 duplicates the top stack entry and LDSP+1 pushes a copy of the NOS to the TOS. @@ -56,7 +62,9 @@ Description: Pushes a copy of the x'th entry on the stack to the TOS. Indexing +----------+---+---+---+---+---+---+ Operation: TOS[x] = TOS + Indicators: None + Description: Pops TOS and stores it x positions deep, overwriting the pre-existing stack entry. Indexing begins at 0 and is counted after popping the TOS. Thus, STSP+0 deletes the NOS, equivalent @@ -71,7 +79,9 @@ Description: Pops TOS and stores it x positions deep, overwriting the +----------+---+---+---+---+---+---+ Operation: TOS = TOS ^ NOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS and NOS, performs bitwise Boolean AND and pushes result to TOS. @@ -84,7 +94,9 @@ Description: Pops TOS and NOS, performs bitwise Boolean AND and pushes result +----------+---+---+---+---+---+---+ Operation: TOS = TOS V NOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS and NOS, performs bitwise Boolean OR and pushes result to TOS. @@ -97,7 +109,9 @@ Description: Pops TOS and NOS, performs bitwise Boolean OR and pushes result +----------+---+---+---+---+---+---+ Operation: TOS = ~TOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS, performs bitwise Boolean NOT and pushes result to TOS. -------------------------------------------------------------------------------- @@ -109,7 +123,9 @@ Description: Pops TOS, performs bitwise Boolean NOT and pushes result to TOS. +----------+---+---+---+---+---+---+ Operation: TOS = TOS >< NOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS and NOS, performs bitwise Boolean XOR and pushes result to TOS. @@ -122,7 +138,9 @@ Description: Pops TOS and NOS, performs bitwise Boolean XOR and pushes result +----------+---+---+---+---+---+---+ Operation: TOS = TOS + NOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS and NOS, performs signed, twos-complement addition and pushes result to TOS. @@ -135,7 +153,9 @@ Description: Pops TOS and NOS, performs signed, twos-complement addition and +----------+---+---+---+---+---+---+ Operation: TOS = NOS; NOS = TOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Swaps the TOS and NOS entries on the stack. Sets PSW flags based on new TOS entry. @@ -148,7 +168,9 @@ Description: Swaps the TOS and NOS entries on the stack. Sets PSW flags based +----------+---+---+---+---+---+---+ Operation: PC = TOS + Indicators: None + Description: Pops TOS and loads value in to PC, overwriting existing PC. Resets SC to zero. @@ -161,7 +183,9 @@ Description: Pops TOS and loads value in to PC, overwriting existing PC. Resets +----------+---+---+---+---+---+---+ Operation: SID = TOS + Indicators: None + Description: Pops TOS and loads value in to SID, overwriting existing SID. -------------------------------------------------------------------------------- @@ -173,7 +197,9 @@ Description: Pops TOS and loads value in to SID, overwriting existing SID. +----------+---+---+---+---+---+---+ Operation: TOS = NOS (<< or >>) TOS + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS and NOS, shifts NOS according to TOS and pushes back to TOS. Direction of shift is left if bit 31 of TOS is set, otherwise shift is right. Magnitude of shift is controlled by bits 30-0 of @@ -188,7 +214,9 @@ Description: Pops TOS and NOS, shifts NOS according to TOS and pushes back to +----------+---+---+---+---+---+---+ Operation: + Indicators: + Description: Not yet implemented. -------------------------------------------------------------------------------- @@ -200,7 +228,9 @@ Description: Not yet implemented. +----------+---+---+---+---+---+---+ Operation: None + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS and sets PSW flags accordingly. -------------------------------------------------------------------------------- @@ -212,7 +242,9 @@ Description: Pops TOS and sets PSW flags accordingly. +----------+---+---+---+---+---+---+ Operation: PC = TOS if NOS = 0 + Indicators: None + Description: Pops TOS and NOS. If NOS = 0, loads TOS value in to PC. -------------------------------------------------------------------------------- @@ -224,7 +256,9 @@ Description: Pops TOS and NOS. If NOS = 0, loads TOS value in to PC. +----------+---+---+---+---+---+---+ Operation: TOS = (TOS) + Indicators: Sets PSW_N and PSW_Z flags. + Description: Pops TOS, treating it as a pointer in to RAM and pushing the corresponding value from RAM on to TOS. @@ -237,7 +271,9 @@ Description: Pops TOS, treating it as a pointer in to RAM and pushing the +----------+---+---+---+---+---+---+ Operation: (TOS) = NOS + Indicators: None + Description: Pops TOS and NOS, treating TOS as a pointer in to RAM and storing NOS at that address. @@ -250,7 +286,9 @@ Description: Pops TOS and NOS, treating TOS as a pointer in to RAM and storing +----------+---+---+---+---+---+---+ Operation: None + Indicators: None + Description: Does nothing for one CPU cycle. -------------------------------------------------------------------------------- @@ -262,5 +300,7 @@ Description: Does nothing for one CPU cycle. +----------+---+---+---+---+---+---+ Operation: None + Indicators: None + Description: Halts the CPU.