new docpages

Author: braindigitalis

Doxyfile

@@ -54,7 +54,7 @@ PROJECT_BRIEF	  = "BASIC-Powered Operating System"
 # and the maximum width should not exceed 200 pixels. Doxygen will copy the logo
 # to the output directory.
 
-#PROJECT_LOGO	   = docpages/images/rr.png
+PROJECT_LOGO	   = docpages/images/rr.png
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
 # into which the generated documentation will be written. If a relative path is
@@ -276,7 +276,7 @@ OPTIMIZE_OUTPUT_VHDL   = NO
 # Note that for custom extensions you also need to set FILE_PATTERNS otherwise
 # the files are not read by doxygen.
 
-EXTENSION_MAPPING      =
+EXTENSION_MAPPING      = 
 
 # If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
 # according to the Markdown format, which allows for more readable
@@ -506,7 +506,7 @@ HIDE_SCOPE_NAMES       = NO
 # the files that are included by a file in the documentation of that file.
 # The default value is: YES.
 
-SHOW_INCLUDE_FILES     = YES
+SHOW_INCLUDE_FILES     = NO
 
 # If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
 # grouped member an include statement to the documentation, telling the reader
@@ -749,7 +749,14 @@ WARN_LOGFILE	   =
 # spaces.
 # Note: If this tag is empty the current directory is searched.
 
-INPUT		  = docpages include src
+INPUT		  = include src modules
+
+# List Markdown explicitly, as files not dirs
+INPUT              += docpages
+FILE_PATTERNS      += *.md
+RECURSIVE          = YES
+# Explicitly exclude the docpages folder so no directory page is made
+EXCLUDE            += docpages
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -2272,4 +2279,4 @@ DOT_GRAPH_MAX_NODES = 100
 
 
 STRIP_FROM_PATH        =
-FULL_PATH_NAMES        = YES
+FULL_PATH_NAMES        = NO

docpages/basic-language-reference/functions/integer/INPORT.md

@@ -6,7 +6,7 @@ X = INPORT(port)
 Reads a **byte** from an I/O `port` and returns it (0–255).
 
 
-> Only use on hardware that expects **8-bit** port reads at that address.
+@note Only use on hardware that expects **8-bit** port reads at that address.
 
 ---
 
@@ -31,4 +31,4 @@ PRINT DATA
 - Continuous polling may stall the system; check status before reads if possible.
 
 **See also:**  
-[INPORTW](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTW) · [INPORTD](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTD) · [INPORTQ](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTQ) · [OUTPORT](https://github.com/brainboxdotcc/retro-rocket/wiki/OUTPORT)
+\ref INPORTW "INPORTW" · \ref INPORTD "INPORTD" · \ref INPORTQ "INPORTQ" · \ref OUTPORT "OUTPORT"

docpages/basic-language-reference/functions/integer/INPORTD.md

@@ -6,7 +6,7 @@ X = INPORTD(port)
 Reads a **32-bit double-word** from `port` and returns it.
 
 
-> Only use on devices that specify **double-word** port access.
+@note Only use on devices that specify **double-word** port access.
 
 ---
 
@@ -30,4 +30,4 @@ PRINT D
 - Most modern devices prefer MMIO; only use when the hardware requires 32-bit port access.
 
 **See also:**  
-[INPORT](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORT) · [INPORTW](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTW) · [INPORTQ](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTQ) · [OUTPORTD](https://github.com/brainboxdotcc/retro-rocket/wiki/OUTPORTD)
+\ref INPORT "INPORT" · \ref INPORTW "INPORTW" · \ref INPORTQ "INPORTQ" · \ref OUTPORTD "OUTPORTD"

docpages/basic-language-reference/functions/integer/INPORTQ.md

@@ -6,7 +6,7 @@ X = INPORTQ(port)
 Reads a **64-bit quad-word** from `port` and returns it.
 
 
-> Very few devices support 64-bit port access; consult hardware documentation before use.
+@note Very few devices support 64-bit port access; consult hardware documentation before use.
 
 ---
 
@@ -29,4 +29,4 @@ PRINT Q
 - Rare in practice; most hardware uses MMIO or smaller port widths.
 
 **See also:**  
-[INPORT](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORT) · [INPORTW](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTW) · [INPORTD](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTD) · [OUTPORTQ](https://github.com/brainboxdotcc/retro-rocket/wiki/OUTPORTQ)
+\ref INPORT "INPORT" · \ref INPORTW "INPORTW" · \ref INPORTD "INPORTD" · \ref OUTPORTQ "OUTPORTQ"

docpages/basic-language-reference/functions/integer/INPORTW.md

@@ -6,7 +6,7 @@ X = INPORTW(port)
 Reads a **16-bit word** from `port` and returns it (0–65535).
 
 
-> Only use when the device expects **word** access.
+@note Only use when the device expects **word** access.
 
 ---
 
@@ -30,4 +30,4 @@ PRINT W
 - Do not use unless the port is documented as word-accessible.
 
 **See also:**  
-[INPORT](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORT) · [INPORTD](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTD) · [INPORTQ](https://github.com/brainboxdotcc/retro-rocket/wiki/INPORTQ) · [OUTPORTW](https://github.com/brainboxdotcc/retro-rocket/wiki/OUTPORTW)
+\ref INPORT "INPORT" · \ref INPORTD "INPORTD" · \ref INPORTQ "INPORTQ" · \ref OUTPORTW "OUTPORTW"

docpages/basic-language-reference/functions/integer/INSTR.md

@@ -1,6 +1,34 @@
 \page INSTR INSTR Function
+
+#### INSTR
+
 ```basic
-INSTR(string-expression, string-expression)
+INSTR(haystack$, needle$)
 ```
-Returns `TRUE` if the first expression is contained in the second expression.
 
+Searches for the substring `needle$` inside the string `haystack$`.
+Returns the 1-based index of the first occurrence, or `0` if not found. The search is case-sensitive.
+
+**Notes**
+
+* The first parameter is the string to search in (the *haystack*).
+* The second parameter is the substring to search for (the *needle*).
+* If multiple matches exist, only the first occurrence is returned.
+* An empty `needle$` always returns `1`.
+
+**Errors**
+
+* None.
+
+**Examples**
+
+@code
+PRINT INSTR("HELLO WORLD", "WORLD")   ' Prints: 7
+PRINT INSTR("HELLO WORLD", "world")   ' Prints: 0 (case-sensitive)
+PRINT INSTR("ABCDE", "A")             ' Prints: 1
+PRINT INSTR("ABCDE", "")              ' Prints: 1
+@endcode
+
+**See also**
+
+\ref LEFT "LEFT$" · \ref RIGHT "RIGHT$" · \ref MID "MID$" · \ref LEN "LEN$"

docpages/basic-language-reference/functions/integer/PEEK.md

@@ -6,7 +6,7 @@ X = PEEK(address)
 Reads a **single byte** from the specified memory `address` and returns it as an integer (0–255).
 
 
-> `PEEK` reads only from **mapped** memory. If `address` (or any byte it touches) is not permitted by the system memory map, an error is raised: `Bad Address at <address>`.
+@note `PEEK` reads only from **mapped** memory. If `address` (or any byte it touches) is not permitted by the system memory map, an error is raised: `Bad Address at <address>`.
 
 ---
 
@@ -40,4 +40,4 @@ IF (STATUS AND 1) <> 0 THEN PRINT "Ready"
 - Accessing device MMIO may have **side effects**.
 
 **See also:**  
-[PEEKW](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKW) · [PEEKD](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKD) · [PEEKQ](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKQ) · [POKE](https://github.com/brainboxdotcc/retro-rocket/wiki/POKE)
+\ref PEEKW "PEEKW" · \ref PEEKD "PEEKD" · \ref PEEKQ "PEEKQ" · \ref POKE "POKE"

docpages/basic-language-reference/functions/integer/PEEKD.md

@@ -6,7 +6,7 @@ X = PEEKD(address)
 Reads a **32-bit double-word** from `address` and returns it as an integer (0–4294967295).
 
 
-> The entire 4-byte span must be valid; otherwise `Bad Address at <address>` is raised.
+@note The entire 4-byte span must be valid; otherwise `Bad Address at <address>` is raised.
 
 ---
 
@@ -30,4 +30,4 @@ PRINT D
 - 32-bit is common for MMIO registers.
 
 **See also:**  
-[PEEK](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEK) · [PEEKW](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKW) · [PEEKQ](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKQ) · [POKED](https://github.com/brainboxdotcc/retro-rocket/wiki/POKED)
+\ref PEEK "PEEK" · \ref PEEKW "PEEKW" · \ref PEEKQ "PEEKQ" · \ref POKED "POKED"

docpages/basic-language-reference/functions/integer/PEEKQ.md

@@ -6,7 +6,7 @@ X = PEEKQ(address)
 Reads a **64-bit quad-word** from `address` and returns it as an integer.
 
 
-> The full 8-byte span must be valid; otherwise `Bad Address at <address>` is raised.
+@note The full 8-byte span must be valid; otherwise `Bad Address at <address>` is raised.
 
 ---
 
@@ -30,4 +30,4 @@ PRINT Q
 - Use for 64-bit fields or counters; don’t assume atomicity for unaligned addresses.
 
 **See also:**  
-[PEEK](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEK) · [PEEKD](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKD) · [POKEQ](https://github.com/brainboxdotcc/retro-rocket/wiki/POKEQ)
+\ref PEEK "PEEK" · \ref PEEKD "PEEKD" · \ref POKEQ "POKEQ"

docpages/basic-language-reference/functions/integer/PEEKW.md

@@ -6,7 +6,7 @@ X = PEEKW(address)
 Reads a **16-bit word** from `address` and returns it as an integer (0–65535).
 
 
-> The full 2-byte span must be valid and mapped, or `Bad Address at <address>` is raised.
+@note The full 2-byte span must be valid and mapped, or `Bad Address at <address>` is raised.
 
 ---
 
@@ -30,4 +30,4 @@ PRINT W
 - Match the width to the device register size for MMIO.
 
 **See also:**  
-[PEEK](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEK) · [PEEKD](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKD) · [PEEKQ](https://github.com/brainboxdotcc/retro-rocket/wiki/PEEKQ) · [POKEW](https://github.com/brainboxdotcc/retro-rocket/wiki/POKEW)
+\ref PEEK "PEEK" · \ref PEEKD "PEEKD" · \ref PEEKQ "PEEKQ" · \ref POKEW "POKEW"