sgr

Author: rumbledethumps

docs/source/vga.rst

@@ -692,7 +692,7 @@ treat 0 as 1 to remain useful without parameters.
   * - CSI n m
     - SGR
     - Select Graphic Rendition
-    - Selects colors and styles.
+    - See `SGR Parameters`_.
   * - CSI 6n
     - DSR
     - Device Status Report
@@ -716,6 +716,8 @@ treat 0 as 1 to remain useful without parameters.
     - Makes the cursor invisible.
 
 
+.. _SGR Parameters:
+
 SGR Parameters
 --------------
 Send multiple parameters separated by semicolons. Sending CSI m
@@ -749,7 +751,10 @@ without any codes resets all attributes.
     - Colors 0-7
   * - 38
     - Set foreground color
-    - Followed by 1 or 5;n or 2;r;g;b or 2::r:g:b
+    - - ``;5;n`` — 256-color index n (0-255)
+      - ``;2;r;g;b`` — 24-bit RGB color
+      - ``;2::r:g:b`` — 24-bit RGB color
+      - ``;1`` — transparent
   * - 39
     - Default foreground color
     - Color 7 white.
@@ -758,7 +763,10 @@ without any codes resets all attributes.
     - Colors 0-7
   * - 48
     - Set background color
-    - Followed by 1 or 5;n or 2;r;g;b or 2::r:g:b
+    - - ``;5;n`` — 256-color index n (0-255)
+      - ``;2;r;g;b`` — 24-bit RGB color
+      - ``;2::r:g:b`` — 24-bit RGB color
+      - ``;1`` — transparent
   * - 49
     - Default background color
     - Color 0 transparent black.