docs first version

2025-06-27 10:20:27 +01:00
parent c8e79f130e
commit 89a6bd5792
29 changed files with 646 additions and 434 deletions
@@ -0,0 +1,41 @@
+# Data Directives
+
+### Data Definition
+
+| Mnemonic | Syntax | Description |
+|----------|--------|-------------|
+| **DB** | `name: value1 [, value2, ...]` | Define bytes</br>*(byte aligned)*|
+| **DH** | `name: value1 [, value2, ...]` | Define half-words</br>*(2 byte aligned)*|
+| **DW** | `name: value1 [, value2, ...]` | Define words</br>*(4 byte aligned)*|
+
+**Examples:**
+```dsa
+db message: "Hello World", 0, 0x20, 231
+dh numbers: 1000, 2000, 3000
+dw stack: 0x10000
+```
+
+**Notes:**
+- All string literals are automatically *null-terminated*
+- 
+
+### Memory Reservation
+
+| Mnemonic | Syntax | Description |
+|----------|--------|-------------|
+| **RESB** | `name: size` | Reserve bytes |
+| **RESH** | `name: size` | Reserve half-words |  
+| **RESW** | `name: size` | Reserve words |
+
+**Examples:**
+```dsa
+resb buffer: 256    ; Reserve 256 bytes
+resh array: 100     ; Reserve space for 100 half-words
+resw heap: 1024     ; Reserve space for 1024 words
+```
+
+### Imports
+| Mnemonic | Syntax | Description |
+|----------|--------|-------------|
+| **INCLUDE** | `module_name "path"` | Include module symbols |
+[More details on the module System](../imports.md)