chore(docs): regenerate man page, HTML docs, and wiki
This commit is contained in:
Gitea Actions
@@ -207,6 +207,11 @@ CLAUDE_CODE_NO_FLICKER 1 \[em] suppress terminal flicker in Claude Code
|
||||
CDPATH . \[ti]/projects \[ti]
|
||||
\f[R]
|
||||
.fi
|
||||
.PP
|
||||
Opinionated defaults (CDPATH, PAGER/MANPAGER, Vi mode, command shadows,
|
||||
terminal integrations) can be switched off per category with universal
|
||||
variables \[em] see Section 7, \[lq]Opinionated Components (Minimal
|
||||
Mode)\[rq].
|
||||
.SS Pager Hierarchy
|
||||
.PP
|
||||
$PAGER is set to ov when available, falling back to less.
|
||||
@@ -1770,6 +1775,73 @@ Some settings (fzf colors, theme) are stored in fish_variables via
|
||||
\f[V]set -U\f[R].
|
||||
These are machine-local and git-ignored.
|
||||
Do not commit fish_variables.
|
||||
.SS Opinionated Components (Minimal Mode)
|
||||
.PP
|
||||
Every opinionated piece of this config is active by default but can be
|
||||
switched off through four category opt-out variables, each evaluated via
|
||||
__fish_variable_check.
|
||||
Set a variable to any falsy value (0, false, no, off, n) to disable its
|
||||
category; erase it or set a truthy value (1, true, yes, on, y) to
|
||||
re-enable.
|
||||
Unset means enabled.
|
||||
.IP
|
||||
.nf
|
||||
\f[C]
|
||||
Variable Disables
|
||||
------------------------------ ------------------------------------
|
||||
__fish_config_op_aliases Command shadows and flag injection:
|
||||
ls->eza, cat->bat, cd->zoxide,
|
||||
rm->trash, less->ov, top->btop,
|
||||
ping->prettyping, ssh->kitten,
|
||||
du->duf/dust, mkdir/bash wrappers,
|
||||
history timestamps, grep/cp/mv/wget
|
||||
flag injection, help intercept
|
||||
__fish_config_op_autoexec Startup side-effects: Fisher
|
||||
bootstrap, theme apply, paru/yay
|
||||
wrapper generation, auto venv
|
||||
activation, WakaTime hook
|
||||
__fish_config_op_overrides Key and env overrides: Vi mode,
|
||||
exit->smart_exit, PAGER/MANPAGER,
|
||||
CDPATH, bang-bang system, autopair,
|
||||
puffer, starship prompt, theme
|
||||
colors, FZF_DEFAULT_OPTS, right
|
||||
prompt
|
||||
__fish_config_op_integrations Terminal/tool coupling: Kitty/
|
||||
WezTerm window abbreviations, done
|
||||
notifications, spwin/tab/split,
|
||||
hist, logs, upgrade, WakaTime
|
||||
\f[R]
|
||||
.fi
|
||||
.PP
|
||||
Examples:
|
||||
.IP
|
||||
.nf
|
||||
\f[C]
|
||||
# Disable command shadows only (rm becomes plain rm again):
|
||||
set -U __fish_config_op_aliases off
|
||||
|
||||
# Full minimal mode \[em] disable all four categories at once:
|
||||
set -U __fish_config_opinionated 0
|
||||
|
||||
# Re-enable everything:
|
||||
set -Ue __fish_config_opinionated
|
||||
\f[R]
|
||||
.fi
|
||||
.PP
|
||||
Notes:
|
||||
.IP \[bu] 2
|
||||
Command shadows (rm, cat, ls, \&...)
|
||||
react immediately; conf.d-level components (bindings, prompt,
|
||||
abbreviations, hooks) take effect in new shells.
|
||||
.IP \[bu] 2
|
||||
With aliases disabled, rm falls back to bare \f[V]command rm\f[R] \[em]
|
||||
files are deleted permanently, not trashed.
|
||||
.IP \[bu] 2
|
||||
Disabled integration commands (spwin, tab, split, hist, logs, upgrade)
|
||||
print an error naming the variable that disabled them.
|
||||
.IP \[bu] 2
|
||||
On CachyOS, the distro fish config\[cq]s own aliases, history override,
|
||||
and bang-bang bindings are stripped per category as well.
|
||||
.SS Prompt and Theme
|
||||
.SS Starship
|
||||
.PP
|
||||
|
||||
@@ -515,8 +515,60 @@ Variables</h2>
|
||||
<p>Some settings (fzf colors, theme) are stored in fish_variables via
|
||||
<code>set -U</code>. These are machine-local and git-ignored. Do not
|
||||
commit fish_variables.</p>
|
||||
<h2 data-number="11.5" id="prompt-and-theme">Prompt and Theme</h2>
|
||||
<h3 data-number="11.5.1" id="starship">Starship</h3>
|
||||
<h2 data-number="11.5"
|
||||
id="opinionated-components-minimal-mode">Opinionated Components (Minimal
|
||||
Mode)</h2>
|
||||
<p>Every opinionated piece of this config is active by default but can
|
||||
be switched off through four category opt-out variables, each evaluated
|
||||
via __fish_variable_check. Set a variable to any falsy value (0, false,
|
||||
no, off, n) to disable its category; erase it or set a truthy value (1,
|
||||
true, yes, on, y) to re-enable. Unset means enabled.</p>
|
||||
<pre><code>Variable Disables
|
||||
------------------------------ ------------------------------------
|
||||
__fish_config_op_aliases Command shadows and flag injection:
|
||||
ls->eza, cat->bat, cd->zoxide,
|
||||
rm->trash, less->ov, top->btop,
|
||||
ping->prettyping, ssh->kitten,
|
||||
du->duf/dust, mkdir/bash wrappers,
|
||||
history timestamps, grep/cp/mv/wget
|
||||
flag injection, help intercept
|
||||
__fish_config_op_autoexec Startup side-effects: Fisher
|
||||
bootstrap, theme apply, paru/yay
|
||||
wrapper generation, auto venv
|
||||
activation, WakaTime hook
|
||||
__fish_config_op_overrides Key and env overrides: Vi mode,
|
||||
exit->smart_exit, PAGER/MANPAGER,
|
||||
CDPATH, bang-bang system, autopair,
|
||||
puffer, starship prompt, theme
|
||||
colors, FZF_DEFAULT_OPTS, right
|
||||
prompt
|
||||
__fish_config_op_integrations Terminal/tool coupling: Kitty/
|
||||
WezTerm window abbreviations, done
|
||||
notifications, spwin/tab/split,
|
||||
hist, logs, upgrade, WakaTime</code></pre>
|
||||
<p>Examples:</p>
|
||||
<pre><code># Disable command shadows only (rm becomes plain rm again):
|
||||
set -U __fish_config_op_aliases off
|
||||
|
||||
# Full minimal mode — disable all four categories at once:
|
||||
set -U __fish_config_opinionated 0
|
||||
|
||||
# Re-enable everything:
|
||||
set -Ue __fish_config_opinionated</code></pre>
|
||||
<p>Notes:</p>
|
||||
<ul>
|
||||
<li>Command shadows (rm, cat, ls, ...) react immediately; conf.d-level
|
||||
components (bindings, prompt, abbreviations, hooks) take effect in new
|
||||
shells.</li>
|
||||
<li>With aliases disabled, rm falls back to bare <code>command rm</code>
|
||||
— files are deleted permanently, not trashed.</li>
|
||||
<li>Disabled integration commands (spwin, tab, split, hist, logs,
|
||||
upgrade) print an error naming the variable that disabled them.</li>
|
||||
<li>On CachyOS, the distro fish config's own aliases, history override,
|
||||
and bang-bang bindings are stripped per category as well.</li>
|
||||
</ul>
|
||||
<h2 data-number="11.6" id="prompt-and-theme">Prompt and Theme</h2>
|
||||
<h3 data-number="11.6.1" id="starship">Starship</h3>
|
||||
<p>The primary prompt is Starship, initialized by conf.d/starship.fish.
|
||||
Configure it via ~/.config/starship.toml.</p>
|
||||
<p>conf.d/starship.fish defines a fish_prompt wrapper that only
|
||||
@@ -526,14 +578,14 @@ immediately after, placing both markers on the prompt line itself. This
|
||||
allows ov to use them as sticky section headers when browsing scrollback
|
||||
logs. Without Starship, fish's built-in prompt handles these markers
|
||||
automatically.</p>
|
||||
<h3 data-number="11.5.2" id="fzf">FZF</h3>
|
||||
<h3 data-number="11.6.2" id="fzf">FZF</h3>
|
||||
<p>FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in
|
||||
integrations/fzf.fish. The colors applied:</p>
|
||||
<pre><code>Background: #1E1E2E (base) #313244 (surface0)
|
||||
Foreground: #CDD6F4 (text)
|
||||
Highlights: #F38BA8 (red) #CBA6F7 (mauve) #B4BEFE (lavender)</code></pre>
|
||||
<p>To customize, override FZF_DEFAULT_OPTS in local.fish.</p>
|
||||
<h3 data-number="11.5.3"
|
||||
<h3 data-number="11.6.3"
|
||||
id="catppuccin-mocha-syntax-highlighting">Catppuccin Mocha Syntax
|
||||
Highlighting</h3>
|
||||
<p>The Catppuccin Mocha theme ships with this config in themes/ and is
|
||||
|
||||
@@ -525,6 +525,10 @@ interactively.</p>
|
||||
<pre><code>GPG_TTY $(tty) — ensures GPG passphrase prompts work
|
||||
CLAUDE_CODE_NO_FLICKER 1 — suppress terminal flicker in Claude Code
|
||||
CDPATH . ~/projects ~</code></pre>
|
||||
<p>Opinionated defaults (CDPATH, PAGER/MANPAGER, Vi mode, command
|
||||
shadows, terminal integrations) can be switched off per category with
|
||||
universal variables — see Section 7, "Opinionated Components (Minimal
|
||||
Mode)".</p>
|
||||
<h2 data-number="5.6" id="pager-hierarchy">Pager Hierarchy</h2>
|
||||
<p>$PAGER is set to ov when available, falling back to less. The less
|
||||
wrapper function extends this into a full chain so anything that calls
|
||||
|
||||
@@ -818,6 +818,10 @@ id="toc-overriding-configuration-variables">Overriding Configuration
|
||||
Variables</a></li>
|
||||
<li><a href="11-7-customization.html#fish-universal-variables"
|
||||
id="toc-fish-universal-variables">Fish Universal Variables</a></li>
|
||||
<li><a
|
||||
href="11-7-customization.html#opinionated-components-minimal-mode"
|
||||
id="toc-opinionated-components-minimal-mode">Opinionated Components
|
||||
(Minimal Mode)</a></li>
|
||||
<li><a href="11-7-customization.html#prompt-and-theme"
|
||||
id="toc-prompt-and-theme">Prompt and Theme</a>
|
||||
<ul>
|
||||
|
||||
File diff suppressed because one or more lines are too long
@@ -48,6 +48,10 @@ automatically on exit. Use `logs` to browse them interactively.
|
||||
CLAUDE_CODE_NO_FLICKER 1 — suppress terminal flicker in Claude Code
|
||||
CDPATH . ~/projects ~
|
||||
|
||||
Opinionated defaults (CDPATH, PAGER/MANPAGER, Vi mode, command shadows,
|
||||
terminal integrations) can be switched off per category with universal
|
||||
variables — see Section 7, "Opinionated Components (Minimal Mode)".
|
||||
|
||||
## Pager Hierarchy
|
||||
|
||||
$PAGER is set to ov when available, falling back to less. The less wrapper
|
||||
|
||||
@@ -37,6 +37,61 @@ Some settings (fzf colors, theme) are stored in fish_variables via
|
||||
`set -U`. These are machine-local and git-ignored. Do not commit
|
||||
fish_variables.
|
||||
|
||||
## Opinionated Components (Minimal Mode)
|
||||
|
||||
Every opinionated piece of this config is active by default but can be
|
||||
switched off through four category opt-out variables, each evaluated via
|
||||
__fish_variable_check. Set a variable to any falsy value (0, false, no,
|
||||
off, n) to disable its category; erase it or set a truthy value (1, true,
|
||||
yes, on, y) to re-enable. Unset means enabled.
|
||||
|
||||
Variable Disables
|
||||
------------------------------ ------------------------------------
|
||||
__fish_config_op_aliases Command shadows and flag injection:
|
||||
ls->eza, cat->bat, cd->zoxide,
|
||||
rm->trash, less->ov, top->btop,
|
||||
ping->prettyping, ssh->kitten,
|
||||
du->duf/dust, mkdir/bash wrappers,
|
||||
history timestamps, grep/cp/mv/wget
|
||||
flag injection, help intercept
|
||||
__fish_config_op_autoexec Startup side-effects: Fisher
|
||||
bootstrap, theme apply, paru/yay
|
||||
wrapper generation, auto venv
|
||||
activation, WakaTime hook
|
||||
__fish_config_op_overrides Key and env overrides: Vi mode,
|
||||
exit->smart_exit, PAGER/MANPAGER,
|
||||
CDPATH, bang-bang system, autopair,
|
||||
puffer, starship prompt, theme
|
||||
colors, FZF_DEFAULT_OPTS, right
|
||||
prompt
|
||||
__fish_config_op_integrations Terminal/tool coupling: Kitty/
|
||||
WezTerm window abbreviations, done
|
||||
notifications, spwin/tab/split,
|
||||
hist, logs, upgrade, WakaTime
|
||||
|
||||
Examples:
|
||||
|
||||
# Disable command shadows only (rm becomes plain rm again):
|
||||
set -U __fish_config_op_aliases off
|
||||
|
||||
# Full minimal mode — disable all four categories at once:
|
||||
set -U __fish_config_opinionated 0
|
||||
|
||||
# Re-enable everything:
|
||||
set -Ue __fish_config_opinionated
|
||||
|
||||
Notes:
|
||||
|
||||
- Command shadows (rm, cat, ls, ...) react immediately; conf.d-level
|
||||
components (bindings, prompt, abbreviations, hooks) take effect in
|
||||
new shells.
|
||||
- With aliases disabled, rm falls back to bare `command rm` — files
|
||||
are deleted permanently, not trashed.
|
||||
- Disabled integration commands (spwin, tab, split, hist, logs,
|
||||
upgrade) print an error naming the variable that disabled them.
|
||||
- On CachyOS, the distro fish config's own aliases, history override,
|
||||
and bang-bang bindings are stripped per category as well.
|
||||
|
||||
## Prompt and Theme
|
||||
|
||||
### Starship
|
||||
|
||||
Reference in New Issue
Block a user