From ab050f7d052e64fed8f0edf977ee3a423207f876 Mon Sep 17 00:00:00 2001
From: Shawn Sijnstra <78007189+sijnstra@users.noreply.github.com>
Date: Mon, 11 May 2026 08:45:15 +1000
Subject: [PATCH 1/3] Enhance documentation for CLI$Prompt variable

Added example for setting CLI$Prompt variable with color codes.
---
 docs/mos/System-Variables.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/mos/System-Variables.md b/docs/mos/System-Variables.md
index 5b48b69..7a164a8 100644
--- a/docs/mos/System-Variables.md
+++ b/docs/mos/System-Variables.md
@@ -115,6 +115,13 @@ The command prompt that the MOS CLI displays is defined using the variable named
 
 If you unset the `CLI$Prompt` variable, the system will revert to displaying the default prompt which is `*`.
 
+For example, to set your prompt to be written in yellow on black, returning to white on black for your commands, you can add the following line to your [boot script](../MOS.md#boot-script):
+
+```
+setmacro CLI$Prompt <17><128><17><11><Current$Dir> *<17><15>
+```
+
+
 ### `CLI$AutoPaged` {#autopaged}
 
 Setting a variable `CLI$AutoPaged` to any value will enable the auto-paging feature of the CLI, if you are using VDP 2.14.0 or later by [temporarily enabling paged mode](../vdp/System-Commands.md#vdu-23-0-9a).  By default this variable is not set.

From 88b282f2e15da5956321ecc3984ec2089ae6d0bd Mon Sep 17 00:00:00 2001
From: Shawn Sijnstra <78007189+sijnstra@users.noreply.github.com>
Date: Mon, 11 May 2026 09:00:01 +1000
Subject: [PATCH 2/3] Clarify prompt color mode requirements

Added note about prompt color modes for CLI$Prompt.
---
 docs/mos/System-Variables.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/mos/System-Variables.md b/docs/mos/System-Variables.md
index 7a164a8..f0c457f 100644
--- a/docs/mos/System-Variables.md
+++ b/docs/mos/System-Variables.md
@@ -121,6 +121,8 @@ For example, to set your prompt to be written in yellow on black, returning to w
 setmacro CLI$Prompt <17><128><17><11><Current$Dir> *<17><15>
 ```
 
+Note that the above prompt change relies on being in default colours, in 16 or 64 colour modes. In 2 or 4 colour modes the prompt will appear to be white on black.
+
 
 ### `CLI$AutoPaged` {#autopaged}
 

From 6d6dfb349dc73a934bcf33d20364afb79eca3bc3 Mon Sep 17 00:00:00 2001
From: Shawn Sijnstra <78007189+sijnstra@users.noreply.github.com>
Date: Mon, 11 May 2026 20:11:42 +1000
Subject: [PATCH 3/3] Clarify prompt change behavior in documentation

Expanded explanation on prompt change and GSTrans mechanism.
---
 docs/mos/System-Variables.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/mos/System-Variables.md b/docs/mos/System-Variables.md
index f0c457f..0e20904 100644
--- a/docs/mos/System-Variables.md
+++ b/docs/mos/System-Variables.md
@@ -121,7 +121,7 @@ For example, to set your prompt to be written in yellow on black, returning to w
 setmacro CLI$Prompt <17><128><17><11><Current$Dir> *<17><15>
 ```
 
-Note that the above prompt change relies on being in default colours, in 16 or 64 colour modes. In 2 or 4 colour modes the prompt will appear to be white on black.
+Note that the above prompt change relies on being in default colours, in 16 or 64 colour modes. In 2 or 4 colour modes the prompt will appear to be white on black. It works by taking advantage of the GSTrans mechanism interpreting the `<123>` entries as literal characters to send. This means the the first part of the new prompt is the equivalent of `vdu 17 128 17 11`, and after the `*`, the ending is the equivalent of `vdu 17 15`.
 
 
 ### `CLI$AutoPaged` {#autopaged}