chore(docs): regenerate man page, HTML docs, and wiki

This commit is contained in:
Gitea Actions
2026-06-12 04:58:11 +00:00
parent b323fedf49
commit 8b9bd248fd
7 changed files with 107 additions and 9 deletions
+45 -2
View File
@@ -1754,7 +1754,7 @@ cargo Rust toolchain (via rustup); used by fish-deps to install
Rust-based tools and to build fish from source. All paths Rust-based tools and to build fish from source. All paths
are gated on type -q cargo and degrade gracefully. are gated on type -q cargo and degrade gracefully.
starship Cross-shell prompt; loaded via type -q starship guard. starship Cross-shell prompt; loaded via type -q starship guard.
Without it fish falls back to its built-in default prompt. Without it the Catppuccin nim-style fallback prompt activates.
uv Python package and project manager (Astral); used by the uv Python package and project manager (Astral); used by the
fish-from-source build path in fish-deps. All consumers fish-from-source build path in fish-deps. All consumers
degrade gracefully without it. degrade gracefully without it.
@@ -2019,7 +2019,7 @@ Puffer key intercepts . ! $ * keys intercepted for smart expansion
Starship prompt fish_prompt replaced by Starship + OSC 133 markers Starship prompt fish_prompt replaced by Starship + OSC 133 markers
Catppuccin colors 30+ fish_color_* variables set to Mocha palette Catppuccin colors 30+ fish_color_* variables set to Mocha palette
FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors
Right prompt fish_right_prompt: Docker context + timestamp Right prompt fish_right_prompt: exit code (on failure) + dim timestamp; always rendered; Docker context added when starship+C3 active
\f[R] \f[R]
.fi .fi
.PP .PP
@@ -2145,6 +2145,49 @@ This allows ov to use them as sticky section headers when browsing
scrollback logs. scrollback logs.
Without Starship, fish\[cq]s built-in prompt handles these markers Without Starship, fish\[cq]s built-in prompt handles these markers
automatically. automatically.
.SS Catppuccin Fallback Prompt
.PP
When Starship is absent or C3 overrides are disabled, a built-in
nim-style two-line prompt activates from functions/fish_prompt.fish.
No external dependencies \[em] fish builtins only.
.PP
Layout:
.IP
.nf
\f[C]
┬─[user\[at]host:\[ti]/path] (main)
╰─>$
\f[R]
.fi
.PP
Elements:
.IP
.nf
\f[C]
user Yellow (Catppuccin Yellow); red if root
\[at]host Blue (local) or Teal (SSH)
\[ti]/path prompt_pwd abbreviation (Catppuccin Text)
(main) Current git branch in Catppuccin Pink; omitted outside repos
─[V:name] Active Python venv basename; omitted when none
─[N/I/R/V] Vi-mode indicator when vi bindings are active
┬─ / ╰─> Connector lines: Catppuccin Green on success, Red on failure
\f[R]
.fi
.PP
The right prompt (fish_right_prompt.fish) always renders, regardless of
C3 state.
On failure it shows a red ✘ and the exit code; on success it shows only
the dim timestamp.
When starship is installed and C3 is enabled, the active Docker context
is also shown (if non-default):
.IP
.nf
\f[C]
✘ 1 󰡨 myctx Fri Jun 12 00:51:21 2026 ← failed, starship+C3 active
✘ 1 Fri Jun 12 00:51:21 2026 ← failed, fallback prompt
Fri Jun 12 00:51:21 2026 ← success (no ✘)
\f[R]
.fi
.SS FZF .SS FZF
.PP .PP
FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in
+1 -1
View File
@@ -504,7 +504,7 @@ tailscale Mesh VPN client</code></pre>
Rust-based tools and to build fish from source. All paths Rust-based tools and to build fish from source. All paths
are gated on type -q cargo and degrade gracefully. are gated on type -q cargo and degrade gracefully.
starship Cross-shell prompt; loaded via type -q starship guard. starship Cross-shell prompt; loaded via type -q starship guard.
Without it fish falls back to its built-in default prompt. Without it the Catppuccin nim-style fallback prompt activates.
uv Python package and project manager (Astral); used by the uv Python package and project manager (Astral); used by the
fish-from-source build path in fish-deps. All consumers fish-from-source build path in fish-deps. All consumers
degrade gracefully without it. degrade gracefully without it.
+26 -3
View File
@@ -659,7 +659,7 @@ Puffer key intercepts . ! $ * keys intercepted for smart expansion
Starship prompt fish_prompt replaced by Starship + OSC 133 markers Starship prompt fish_prompt replaced by Starship + OSC 133 markers
Catppuccin colors 30+ fish_color_* variables set to Mocha palette Catppuccin colors 30+ fish_color_* variables set to Mocha palette
FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors
Right prompt fish_right_prompt: Docker context + timestamp</code></pre> Right prompt fish_right_prompt: exit code (on failure) + dim timestamp; always rendered; Docker context added when starship+C3 active</code></pre>
<p>The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish, <p>The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish,
and six expand_bang_*.fish functions. All are gated together — disabling and six expand_bang_*.fish functions. All are gated together — disabling
C3 removes the entire bang-expansion system at once.</p> C3 removes the entire bang-expansion system at once.</p>
@@ -749,14 +749,37 @@ immediately after, placing both markers on the prompt line itself. This
allows ov to use them as sticky section headers when browsing scrollback allows ov to use them as sticky section headers when browsing scrollback
logs. Without Starship, fish's built-in prompt handles these markers logs. Without Starship, fish's built-in prompt handles these markers
automatically.</p> automatically.</p>
<h3 data-number="11.6.2" id="fzf">FZF</h3> <h3 data-number="11.6.2" id="catppuccin-fallback-prompt">Catppuccin
Fallback Prompt</h3>
<p>When Starship is absent or C3 overrides are disabled, a built-in
nim-style two-line prompt activates from functions/fish_prompt.fish. No
external dependencies — fish builtins only.</p>
<p>Layout:</p>
<pre><code>┬─[user@host:~/path] (main)
╰─&gt;$</code></pre>
<p>Elements:</p>
<pre><code>user Yellow (Catppuccin Yellow); red if root
@host Blue (local) or Teal (SSH)
~/path prompt_pwd abbreviation (Catppuccin Text)
(main) Current git branch in Catppuccin Pink; omitted outside repos
─[V:name] Active Python venv basename; omitted when none
─[N/I/R/V] Vi-mode indicator when vi bindings are active
┬─ / ╰─&gt; Connector lines: Catppuccin Green on success, Red on failure</code></pre>
<p>The right prompt (fish_right_prompt.fish) always renders, regardless
of C3 state. On failure it shows a red ✘ and the exit code; on success
it shows only the dim timestamp. When starship is installed and C3 is
enabled, the active Docker context is also shown (if non-default):</p>
<pre><code>✘ 1 󰡨 myctx Fri Jun 12 00:51:21 2026 ← failed, starship+C3 active
✘ 1 Fri Jun 12 00:51:21 2026 ← failed, fallback prompt
Fri Jun 12 00:51:21 2026 ← success (no ✘)</code></pre>
<h3 data-number="11.6.3" id="fzf">FZF</h3>
<p>FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in <p>FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in
integrations/fzf.fish. The colors applied:</p> integrations/fzf.fish. The colors applied:</p>
<pre><code>Background: #1E1E2E (base) #313244 (surface0) <pre><code>Background: #1E1E2E (base) #313244 (surface0)
Foreground: #CDD6F4 (text) Foreground: #CDD6F4 (text)
Highlights: #F38BA8 (red) #CBA6F7 (mauve) #B4BEFE (lavender)</code></pre> Highlights: #F38BA8 (red) #CBA6F7 (mauve) #B4BEFE (lavender)</code></pre>
<p>To customize, override FZF_DEFAULT_OPTS in local.fish.</p> <p>To customize, override FZF_DEFAULT_OPTS in local.fish.</p>
<h3 data-number="11.6.3" <h3 data-number="11.6.4"
id="catppuccin-mocha-syntax-highlighting">Catppuccin Mocha Syntax id="catppuccin-mocha-syntax-highlighting">Catppuccin Mocha Syntax
Highlighting</h3> Highlighting</h3>
<p>The Catppuccin Mocha theme ships with this config in themes/ and is <p>The Catppuccin Mocha theme ships with this config in themes/ and is
+2
View File
@@ -834,6 +834,8 @@ id="toc-prompt-and-theme">Prompt and Theme</a>
<ul> <ul>
<li><a href="11-7-customization.html#starship" <li><a href="11-7-customization.html#starship"
id="toc-starship">Starship</a></li> id="toc-starship">Starship</a></li>
<li><a href="11-7-customization.html#catppuccin-fallback-prompt"
id="toc-catppuccin-fallback-prompt">Catppuccin Fallback Prompt</a></li>
<li><a href="11-7-customization.html#fzf" id="toc-fzf">FZF</a></li> <li><a href="11-7-customization.html#fzf" id="toc-fzf">FZF</a></li>
<li><a <li><a
href="11-7-customization.html#catppuccin-mocha-syntax-highlighting" href="11-7-customization.html#catppuccin-mocha-syntax-highlighting"
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -24,7 +24,7 @@ fish-deps manages these tools. Run `fish-deps` to check status, or
Rust-based tools and to build fish from source. All paths Rust-based tools and to build fish from source. All paths
are gated on type -q cargo and degrade gracefully. are gated on type -q cargo and degrade gracefully.
starship Cross-shell prompt; loaded via type -q starship guard. starship Cross-shell prompt; loaded via type -q starship guard.
Without it fish falls back to its built-in default prompt. Without it the Catppuccin nim-style fallback prompt activates.
uv Python package and project manager (Astral); used by the uv Python package and project manager (Astral); used by the
fish-from-source build path in fish-deps. All consumers fish-from-source build path in fish-deps. All consumers
degrade gracefully without it. degrade gracefully without it.
+31 -1
View File
@@ -191,7 +191,7 @@ all of them.
Starship prompt fish_prompt replaced by Starship + OSC 133 markers Starship prompt fish_prompt replaced by Starship + OSC 133 markers
Catppuccin colors 30+ fish_color_* variables set to Mocha palette Catppuccin colors 30+ fish_color_* variables set to Mocha palette
FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors
Right prompt fish_right_prompt: Docker context + timestamp Right prompt fish_right_prompt: exit code (on failure) + dim timestamp; always rendered; Docker context added when starship+C3 active
The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish, and The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish, and
six expand_bang_*.fish functions. All are gated together — disabling C3 six expand_bang_*.fish functions. All are gated together — disabling C3
@@ -292,6 +292,36 @@ markers on the prompt line itself. This allows ov to use them as sticky
section headers when browsing scrollback logs. Without Starship, fish's section headers when browsing scrollback logs. Without Starship, fish's
built-in prompt handles these markers automatically. built-in prompt handles these markers automatically.
### Catppuccin Fallback Prompt
When Starship is absent or C3 overrides are disabled, a built-in nim-style
two-line prompt activates from functions/fish_prompt.fish. No external
dependencies — fish builtins only.
Layout:
┬─[user@host:~/path] (main)
╰─>$
Elements:
user Yellow (Catppuccin Yellow); red if root
@host Blue (local) or Teal (SSH)
~/path prompt_pwd abbreviation (Catppuccin Text)
(main) Current git branch in Catppuccin Pink; omitted outside repos
─[V:name] Active Python venv basename; omitted when none
─[N/I/R/V] Vi-mode indicator when vi bindings are active
┬─ / ╰─> Connector lines: Catppuccin Green on success, Red on failure
The right prompt (fish_right_prompt.fish) always renders, regardless of C3
state. On failure it shows a red ✘ and the exit code; on success it shows
only the dim timestamp. When starship is installed and C3 is enabled, the
active Docker context is also shown (if non-default):
✘ 1 󰡨 myctx Fri Jun 12 00:51:21 2026 ← failed, starship+C3 active
✘ 1 Fri Jun 12 00:51:21 2026 ← failed, fallback prompt
Fri Jun 12 00:51:21 2026 ← success (no ✘)
### FZF ### FZF
FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in