summaryrefslogtreecommitdiff
path: root/src/tutor.txt
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-08-18 14:21:38 -0300
committerGabriel Schneider <[email protected]>2026-08-18 23:45:30 -0300
commit382abe3dafb872b3e6c9792a9cc0abcf6267e180 (patch)
treee30f47d911561db9b02e714287a1658822c77a09 /src/tutor.txt
parentc24a9e40215bc30c68c9db7675f1c6a07d9bbae3 (diff)
downloadpardes-382abe3dafb872b3e6c9792a9cc0abcf6267e180.tar.gz
pardes-382abe3dafb872b3e6c9792a9cc0abcf6267e180.zip
file_watch + builtins + config: richer watch semantics, new builtins, config docs
Diffstat (limited to 'src/tutor.txt')
-rw-r--r--src/tutor.txt16
1 files changed, 12 insertions, 4 deletions
diff --git a/src/tutor.txt b/src/tutor.txt
index f9ee1932..2fb89ea0 100644
--- a/src/tutor.txt
+++ b/src/tutor.txt
@@ -1064,6 +1064,13 @@ abc
`Theme <name>` goes straight to one, ThemeSel (SPC t t) lists them
all into a buffer you walk.
+ A native build can also wear one complete ZON file at runtime:
+ `ThemeFile themes/mine.zon` resolves from the pardes config directory
+ and, where document watching is available, reloads after every valid save.
+ A broken save leaves the last good colors on screen. `DumpThemes` writes
+ copyable references under themes/builtin; copy one out, rename it and edit
+ that rather than guessing the fields.
+
Fonts, on the SDL and macOS builds only — in a terminal the font
belongs to the terminal and in a browser to the page. FontSel
(SPC t f) lists every MONOSPACE face on the machine into a "+Fonts"
@@ -1089,10 +1096,10 @@ abc
effect builtin as its argument) opens the exact backend sources that
were embedded when this binary was built.
- Before its first frame a native pardes reads ONE file: a file called
- `pardes` in your config directory — $XDG_CONFIG_HOME/pardes when that
- is set to an absolute path, else ~/.config/pardes, and on macOS
- ~/Library/Application Support/pardes. `SPC f c` opens a refreshable
+ Before its first frame a native pardes reads ONE file: `init` inside its
+ `pardes` config directory — $XDG_CONFIG_HOME/pardes/init when that is
+ set to an absolute path, else ~/.config/pardes/init, and on macOS
+ ~/Library/Application Support/pardes/init. `SPC f c` opens a refreshable
"+Config" buffer containing the resolved path and every live setting:
theme, shell, requested/effective font, panel/scene effects, hover
delay, and the ordinary display toggles. The path is printed whether
@@ -1111,6 +1118,7 @@ abc
you would execute it anywhere else:
Theme gruvbox_dark_hard
+ ThemeFile themes/mine.zon
Shell zsh
TaglineSize 70
Tagbottom