rootiest/fish-config
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Gitea Actions
2026-07-04 06:36:42 +00:00
parent 3362c33339
commit 68eb3b0092
5 changed files with 69 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/html/11-7-customization.html
+21 -4
View File
@@ -499,6 +499,14 @@ in:</p>
<pre><code>set -U __fish_user_dots_path /path/to/your/dots/fish</code></pre>
<p>Typical uses: additional PATH entries, local aliases,
hostname-specific env vars, work-specific tool configs.</p>
<p>For convenience, a git-ignored <code>user-dots</code> symlink in the
fish config directory tracks <code>$__fish_user_dots_path</code> so the
overlay can be browsed from <code>~/.config/fish/</code>. It is created
if missing and repointed if the path changes. Opt out by setting
<code>__fish_user_dots_symlink</code> to a falsy value, or toggling
"Dots link" off on the config-settings Paths page — this stops
generation and removes any existing link. It only ever manages a symlink
and never clobbers a real file or directory at that path.</p>
<h2 data-number="11.2" id="secrets-and-api-keys">Secrets and API
Keys</h2>
<pre><code>$__fish_user_dots_path/secrets.fish</code></pre>
@@ -644,12 +652,21 @@ paru wrapper Every startup Writes ~/.local/bin/paru wrapper
yay wrapper Every startup Writes ~/.local/bin/yay wrapper
Python venv activation On every cd Sources .venv/bin/activate.fish
WakaTime command hook On every command Reports to WakaTime API
Auto-pull fast-forward On entering a repo Background ff-only git pull</code></pre>
Auto-pull fast-forward On entering a repo Background ff-only git pull
user-dots symlink Every startup Links $__fish_config_dir/user-dots
to $__fish_user_dots_path</code></pre>
<p>When C2 is disabled: no Fisher install, no theme application, no
paru/yay wrapper generation, no automatic venv activation, no WakaTime
reporting, and no auto-pull (the PWD handler is never registered). The
first-run completion marker (__fish_config_first_run_complete) is still
set so the init does not re-run on subsequent shells.</p>
reporting, no auto-pull (the PWD handler is never registered), and the
user-dots convenience symlink is not created. The symlink is git-ignored
and only ever managed as a symlink — a real file or directory at that
path is left untouched. The symlink has its own opt-out independent of
C2: set __fish_user_dots_symlink to a falsy value (or toggle "Dots link"
off on the config-settings Paths page) to stop generating it and remove
any existing link — honoured even when C2 is enabled. Managed by the
__fish_user_dots_link helper. The first-run completion marker
(__fish_config_first_run_complete) is still set so the init does not
re-run on subsequent shells.</p>
<p>Python venv activation fires on every directory change. If a
directory uses direnv (.envrc present), direnv takes priority and
auto-venv is skipped for that directory.</p>