chore(docs): regenerate man page, HTML docs, and wiki
This commit is contained in:
+45
-2
@@ -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
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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)
|
||||||
|
╰─>$</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
|
||||||
|
┬─ / ╰─> 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
|
||||||
|
|||||||
@@ -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
@@ -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.
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user