docs for user guide

Author: braindigitalis

docpages/basic-language-reference/BASIC_SOUND.md

@@ -58,10 +58,10 @@ If you ever played games on a C64 or BBC Micro, you’ll remember how the same 
 
 Retro Rocket uses the classic **ADSR model** (Attack, Decay, Sustain, Release) found on many vintage synthesisers:
 
-* **Attack** — how quickly the sound rises from silence to full strength when a note begins.
-* **Decay** — once the peak is reached, how fast the sound falls back down to a steady level.
-* **Sustain** — the level held as long as the note continues.
-* **Release** — how long the note takes to fade back to silence after it ends.
+* **Attack** - how quickly the sound rises from silence to full strength when a note begins.
+* **Decay** - once the peak is reached, how fast the sound falls back down to a steady level.
+* **Sustain** - the level held as long as the note continues.
+* **Release** - how long the note takes to fade back to silence after it ends.
 
 ## Flow of audio
 

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

@@ -40,7 +40,7 @@ PRINT "Background job ended"
 
 * The returned value is an **integer** ≥ 1 (the current program itself counts as a process).
 * Values change dynamically as processes are created or end.
-* Designed for diagnostic or monitoring use; it does not reveal details of which processes are running — only the **total count**.
+* Designed for diagnostic or monitoring use; it does not reveal details of which processes are running - only the **total count**.
 * Use together with \ref GETPROCNAME\$ "GETPROCNAME\$" or \ref GETPROCID "GETPROCID" to identify individual processes.
 
 ---

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

@@ -45,7 +45,7 @@ ENDIF
 ### Notes
 
 * Returns an integer value ≥ 0.
-* Length is measured in characters, not bytes — since Retro Rocket BASIC strings are ASCII, the two are identical.
+* Length is measured in characters, not bytes - since Retro Rocket BASIC strings are ASCII, the two are identical.
 * Useful together with \ref LEFT "LEFT$", \ref RIGHT "RIGHT$", and \ref MID "MID$" for string slicing.
 
 ---

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

@@ -47,7 +47,7 @@ PRINT o$; " = "; OCTVAL(o$)
 * **Important distinction:**
 
   * In BASIC source code, you can write octal literals with a `&O` prefix (e.g. `&O755`).
-  * In strings passed to `OCTVAL`, only the raw digits are valid — no prefix.
+  * In strings passed to `OCTVAL`, only the raw digits are valid - no prefix.
 
 ---
 

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

@@ -44,7 +44,7 @@ NEXT
 * The result is an **integer** within the inclusive range `[min, max]`.
 * If `min > max`, behaviour is undefined.
 * Suitable for general randomness in games, simulations, and sampling.
-* **Not cryptographically secure** — although the kernel provides an unpredictable seed, the Mersenne Twister itself is deterministic and predictable if state is known.
+* **Not cryptographically secure** - although the kernel provides an unpredictable seed, the Mersenne Twister itself is deterministic and predictable if state is known.
 * **Retro Rocket BASIC difference:** BBC BASIC used a 33-bit LFSR (linear feedback shift register). Retro Rocket uses a modern PRNG (Mersenne Twister).
 
 ---

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

@@ -43,7 +43,7 @@ Produces `0`.
 
 * Returns a 64-bit signed integer.
 * If the string is empty or contains invalid characters, the return value is `0`.
-* Only integer values are supported — fractional values are truncated or treated as invalid.
+* Only integer values are supported - fractional values are truncated or treated as invalid.
 * For parsing hexadecimal or octal strings, see \ref HEXVAL "HEXVAL" and \ref OCTVAL "OCTVAL".
 
 ---

docpages/basic-language-reference/functions/real/FMOD.md

@@ -35,7 +35,7 @@ Produces `5`.
 
 ### Notes
 
-* `y` must not be `0` — this causes an error.
+* `y` must not be `0` - this causes an error.
 * The result has the same sign as the dividend (`x`).
 * Differs from integer modulus (`%`) because it works with reals and preserves fractional parts.
 * Useful for periodic functions, angle wrapping, and floating-point arithmetic.

docpages/basic-language-reference/functions/string/GETNAME.md

@@ -34,7 +34,7 @@ NEXT
 * If the index is outside the valid range, an error is raised.
 * The path may be absolute (starting with `/`) or relative to the current working directory (\ref CSD "CSD\$").
 * The order of entries is determined by the filesystem and may not be sorted alphabetically.
-* Only the name is returned — to distinguish files from directories, use \ref FILETYPE "FILETYPE\$".
+* Only the name is returned - to distinguish files from directories, use \ref FILETYPE "FILETYPE\$".
 
 ---
 

docpages/basic-language-reference/functions/string/GETPROCSTATE.md

@@ -17,7 +17,7 @@ The parameter is an index between `0` and `GETPROCCOUNT - 1`.
 | `suspended` | Process is waiting on another process to end before continuing.   |
 | `waiting`   | Process is blocked, waiting on I/O (e.g. disk, console, network). |
 | `ended`     | Process no longer exists.                                         |
-| `unknown`   | Error state — the status of this process cannot be determined.    |
+| `unknown`   | Error state - the status of this process cannot be determined.    |
 
 ---
 

docpages/basic-language-reference/functions/string/HIGHLIGHT.md

@@ -8,20 +8,20 @@ Given a string containing BASIC source, returns a copy with ANSI SGR escape sequ
 
 **Notes**
 
-* **Strings** — text between double quotes (`"..."`) is highlighted in **light yellow** from the opening quote to the closing quote. If a closing quote is missing, highlighting continues to the end of the input and is then reset.
+* **Strings** - text between double quotes (`"..."`) is highlighted in **light yellow** from the opening quote to the closing quote. If a closing quote is missing, highlighting continues to the end of the input and is then reset.
 * **Comments**
 
   * A single quote (') begins a comment that is highlighted in **dark green** until the end of the input.
   * The keyword `REM` (when not inside a string) causes the **entire line** to be treated as a comment and highlighted in **dark green**.
-* **Keywords / tokens** — recognised BASIC keywords are highlighted in **light blue** when they are not part of a longer identifier. Boundary detection prevents colouring inside names like `FORTH`. Exceptions: `PROC`, `FN`, and `=` may be adjacent to letters/digits/underscores and will still be highlighted.
+* **Keywords / tokens** - recognised BASIC keywords are highlighted in **light blue** when they are not part of a longer identifier. Boundary detection prevents colouring inside names like `FORTH`. Exceptions: `PROC`, `FN`, and `=` may be adjacent to letters/digits/underscores and will still be highlighted.
 * **Built-in functions**
 
   * Integer-returning built-ins are **light green**.
   * String-returning built-ins are **light magenta**.
   * Real/float-returning built-ins are **light cyan**.
-* **Numeric literals** — digits (and a leading unary `+`/`-`) are highlighted in **orange**.
-* **Operators & punctuation** — `() + - * / = < > , ;` are highlighted in **dark red**.
-* **Default text** — rendered in **white**. Colours are reset back to white after each coloured span, and a final reset is appended at the end of the result to prevent “colour leakage” in the caller’s terminal.
+* **Numeric literals** - digits (and a leading unary `+`/`-`) are highlighted in **orange**.
+* **Operators & punctuation** - `() + - * / = < > , ;` are highlighted in **dark red**.
+* **Default text** - rendered in **white**. Colours are reset back to white after each coloured span, and a final reset is appended at the end of the result to prevent “colour leakage” in the caller’s terminal.
 
 **Errors**