From 389e307f205f9b7edf604fb9f86e1038ead736ef Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Tue, 16 Jun 2026 23:37:50 -0400
Subject: feat: major xterm256 color overhaul, see worldbuilding docs.

---
 data/help/prompt.yaml | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

(limited to 'data/help/prompt.yaml')

diff --git a/data/help/prompt.yaml b/data/help/prompt.yaml
index 95d852b..9af6b01 100644
--- a/data/help/prompt.yaml
+++ b/data/help/prompt.yaml
@@ -1,9 +1,12 @@
 name: "prompt"
-category: "Options"
+category: "General"
 description: |
-  Customize your command prompt.
+  Customize your command prompt. Prompts are per-character.
 
-  Set via: option prompt <string>
+  Usage:
+    prompt              Show current prompt
+    prompt <value>      Set a custom prompt
+    prompt reset        Restore default "> "
 
   Your prompt string can include variables and color blocks.
 
@@ -21,15 +24,14 @@ description: |
 
   Use %% for a literal % sign.
 
-  Color blocks use the same format as the color command:
-    {fg=green bold}text{/}
+  Color blocks:
+    {<0-255> [bold] [dim] [underline]}text{/}
+    {g:<a>,<b>[,<c>...]}gradient text{/}
 
-  A color block starts with {color_string} and ends with {/}.
+  A color block starts with {color_spec} and ends with {/}.
 
   Examples:
-    option prompt "> "
-    option prompt "{fg=cyan}%h/%Hhp $%c %s{/} >"
-    option prompt "<{fg=green}%h{/}/{fg=red}%H{/}hp> "
-
-  To reset to the default "> ":
-    option prompt "> "
+    prompt > 
+    prompt {6}%h/%Hhp $%c %s{/} >
+    prompt <{2}%h{/}/{1}%H{/}hp> 
+    prompt {208 bold}%h/%Hhp{/} >
-- 
cgit v1.2.3