From 726ce1cbdcafa8bf0649abd37c3040022640f75a Mon Sep 17 00:00:00 2001
From: David Schmidt <1110325+david-schmidt@users.noreply.github.com>
Date: Sat, 30 Apr 2022 11:45:00 -0400
Subject: [PATCH] Assembler document cleanup

---
 .Docs/ASM.md | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/.Docs/ASM.md b/.Docs/ASM.md
index b8ee3ee3..004a64b3 100644
--- a/.Docs/ASM.md
+++ b/.Docs/ASM.md
@@ -17,30 +17,28 @@ no .AC support
 | .AS  | Ascii String | S-C,A2osX     | Working     |  `.AS dTEXTd`  where d is any delimiter  `.AS -"TEXT"`produce ascii code with b7=1             | |
 | .AT  | Ascii string Terminated | S-C,A2osX     | Working     | (same as above) | |
 | .AZ  | Ascii string Zero terminated (C String) | S-C,A2osX     | Working     | (same as above) | |
-| .BS  | Block Storage | S-C,A2osX     | Working     | .BS x[,b]  | |
-| .DA  | Data | S-C,A2osX     | Working |             | |
+| .BS  | Block (Byte) Storage | S-C,A2osX     | Working     | `.BS count[,value]` | Reserves `count` bytes in output and sets them to `value` (or zero if omitted) |
+| .DA  | DAta value | S-C,A2osX     | Working | `.DA value` | 2-byte address: `.DA $1234` only high byte: `.DA /$1234` only low byte: `.DA #$1234` |
 | .DO  | conditional start | S-C,A2osX     | Working |             | |
 | .DU,.DUMMY | begin DUmmy section | S-C,A2osX     | Working |             | |
 | .ED  | End Dummy section | S-C,A2osX     | Working |             | |
-| .DA  | DAta | S-C,A2osX     | Working |             | |
 | .ELSE | conditional ELSE | S-C,A2osX     | Working |             | |
 | .EM  | End Macro | S-C,A2osX     | Working |             | |
 | .EN  | ENd of source code | S-C,A2osX     | IGNORED |             | |
-| .EP  | End Phase | S-C,A2osX     | Working |             | |
+| .EP  | End Phase | S-C,A2osX     | Working | `.EP` | Conclude temporary addressing range started with `.PH` and resume prior assembly addressing |
 | .EQ  | EQuate | S-C,A2osX     | Working |             | |
 | .FIN | conditional end| S-C,A2osX     | Working |             | |
-| .PH  | PHase start| S-C,A2osX     | Working |             | |
-| .HS  | Hex String | S-C,A2osX     | Working | `HS FE1A78`     delimiter allowed : `HS 00.11,22`            | |
-| .IN,.INB,.INBx | | S-C,A2osX     | Working | .INB MYFILE  | |
-| .LI,.LIST  | | S-C,A2osX     | Working | .LIST ON/OFF CON/COFF MON/MOFF XON/XOFF  | |
-| .MA  | MAcro deffinition | S-C,A2osX | Working | .MA >MYMACRO  | |
+| .HS  | Hex String storage | S-C,A2osX     | Working | `HS FE1A78`     delimiter allowed : `HS 00.11,22`            | |
+| .IN,.INB,.INBx | INline source | S-C,A2osX     | Working | `.INB MYFILE`  | `.IN` inlines full text, `.INB` inlines 1 block at a time during assembly |
+| .LI,.LIST  | | S-C,A2osX     | Working | `.LIST ON/OFF CON/COFF MON/MOFF XON/XOFF`  | |
+| .MA  | MAcro deffinition | S-C,A2osX | Working | `.MA >MYMACRO`  | |
 | .OP  | OPCode | S-C,A2osX     | Working | `.OP cpu` where cpu is one of 6502,65C02,65R02,65816,Z80,SW16           | |
-| .OR  | ORigin | S-C,A2osX     | Working | .OR $2000 | |
+| .OR  | ORigin | S-C,A2osX     | Working | `.OR address` | Set initial output address (only one allowed per assembly) |
 | .PG  | PaGe control | S-C,A2osX     | IGNORED |             | |
-| .PH  | PHase | S-C,A2osX     | Working |             | |
+| .PH  | PHase start | S-C,A2osX     | Working |  `.PH address` | Start a temporary addressing range |
 | .SE  | | S-C,A2osX     | Working |             | |
 | .TA  | Target Address| S-C,A2osX     | IGNORED |             | |
-| .TF  | Target File | S-C,A2osX     | Working | .TF TargetFile[,Txxx] | only ,TSYS supported  |
+| .TF  | Target File | S-C,A2osX     | Working | `.TF TargetFile[,Txxx]` | only ,TSYS supported  |
 | .TI  | TItle | S-C,A2osX     | IGNORED |             | |
 | .US  | USer defined | S-C,A2osX     | IGNORED |             | |