chore(docs): regenerate manual and man page

This commit is contained in:
Gitea Actions
2026-08-06 20:32:45 +00:00
parent dfdc1063ba
commit fc420fad72
+57 -49
View File
@@ -4157,13 +4157,11 @@ The following plugins are fully managed by Fisher.
Their files are installed into the repo directory by Fisher and are
listed in \f[V].gitignore\f[R] \[em] do not commit them.
Fisher installs and updates them automatically.
.IP
.nf
\f[C]
jorgebucaran/fisher Plugin manager itself
meaningful-ooo/sponge Remove failed commands from history
\f[R]
.fi
.IP \[bu] 2
\f[V]jorgebucaran/fisher\f[R] \[em] Plugin manager itself
.IP \[bu] 2
\f[V]meaningful-ooo/sponge\f[R] \[em] Remove failed commands from
history
.SS Sponge History Filtering
.PP
Sponge removes failed commands from history and, via
@@ -4172,18 +4170,24 @@ through three layers:
.PP
Layer 1 \[em] Static patterns (universal, persistent across sessions):
Commands matching any of these structural signatures are never recorded:
.IP
.nf
\f[C]
--password / --token / --passphrase / --api-key flags with values
Inline env assignments: GITHUB_TOKEN=xxx, MY_API_KEY=abc
Fish set with sensitive names: set -gx GITHUB_TOKEN xxx
URLs with embedded credentials: https://user:pass\[at]host
HTTP Authorization headers: curl -H \[dq]Authorization: ...\[dq]
Basic auth flags: curl -u user:pass
sshpass, docker login -p, openssl -passin/-passout
\f[R]
.fi
.IP \[bu] 2
\f[V]--password\f[R] / \f[V]--token\f[R] / \f[V]--passphrase\f[R] /
\f[V]--api-key\f[R] flags with values
.IP \[bu] 2
Inline env assignments: \f[V]GITHUB_TOKEN=xxx\f[R],
\f[V]MY_API_KEY=abc\f[R]
.IP \[bu] 2
Fish set with sensitive names: \f[V]set -gx GITHUB_TOKEN xxx\f[R]
.IP \[bu] 2
URLs with embedded credentials: \f[V]https://user:pass\[at]host\f[R]
.IP \[bu] 2
HTTP Authorization headers:
\f[V]curl -H \[dq]Authorization: ...\[dq]\f[R]
.IP \[bu] 2
Basic auth flags: \f[V]curl -u user:pass\f[R]
.IP \[bu] 2
\f[V]sshpass\f[R], \f[V]docker login -p\f[R],
\f[V]openssl -passin/-passout\f[R]
.PP
Layer 2 \[em] Dynamic secret values (session globals, refreshed each
login): On the first prompt, after secrets.fish has loaded, the literal
@@ -4234,16 +4238,20 @@ and improved behavior that differ from their upstream releases.
Installing them through Fisher would overwrite these customizations.
.PP
Bundled components and their upstream origins:
.IP
.nf
\f[C]
catppuccin/fish → themes/ + conf.d/theme.fish
PatrickF1/fzf.fishfunctions/_fzf_*.fish + conf.d/fzf.fish
franciscolourenco/done → conf.d/done.fish
jorgebucaran/autopair.fish → functions/_autopair_*.fish + conf.d/autopair.fish
nickeb96/puffer-fish → functions/_puffer_fish_*.fish + conf.d/puffer.fish
\f[R]
.fi
.IP \[bu] 2
\f[V]catppuccin/fish\f[R] → \f[V]themes/\f[R] +
\f[V]conf.d/theme.fish\f[R]
.IP \[bu] 2
\f[V]PatrickF1/fzf.fish\f[R] → \f[V]functions/_fzf_*.fish\f[R] +
\f[V]conf.d/fzf.fish\f[R]
.IP \[bu] 2
\f[V]franciscolourenco/done\f[R] → \f[V]conf.d/done.fish\f[R]
.IP \[bu] 2
\f[V]jorgebucaran/autopair.fish\f[R]
\f[V]functions/_autopair_*.fish\f[R] + \f[V]conf.d/autopair.fish\f[R]
.IP \[bu] 2
\f[V]nickeb96/puffer-fish\f[R] → \f[V]functions/_puffer_fish_*.fish\f[R]
+ \f[V]conf.d/puffer.fish\f[R]
.PP
Do not run \f[V]fisher install\f[R] for these \[em] it will overwrite
the customized versions.
@@ -4251,13 +4259,11 @@ To update their behavior, edit the relevant bundled files directly.
.SS fish_plugins Manifest
.PP
The \f[V]fish_plugins\f[R] file at the config root:
.IP
.nf
\f[C]
jorgebucaran/fisher Plugin manager itself
meaningful-ooo/sponge Remove failed commands from history
\f[R]
.fi
.IP \[bu] 2
\f[V]jorgebucaran/fisher\f[R] \[em] Plugin manager itself
.IP \[bu] 2
\f[V]meaningful-ooo/sponge\f[R] \[em] Remove failed commands from
history
.PP
To update all Fisher-managed plugins, run \f[V]fisher update\f[R] or
\f[V]fish-deps update\f[R] which calls it as its first step.
@@ -4282,11 +4288,12 @@ All other plugin functionality is bundled directly with this config and
requires no additional installation.
.SS Return Sentinel
.PP
config.fish ends with a return sentinel guard.
Any lines appended after it by a tool\[cq]s setup command (starship init
fish | source, zoxide init fish | source, etc.)
\f[V]config.fish\f[R] ends with a return sentinel guard.
Any lines appended after it by a tool\[cq]s setup command
(\f[V]starship init fish | source\f[R],
\f[V]zoxide init fish | source\f[R], etc.)
will have no effect.
All integrations are managed via conf.d/ files.
All integrations are managed via \f[V]conf.d/\f[R] files.
.PP
If a new tool\[cq]s shell integration appears to do nothing, check
whether its setup command appended an init line below the sentinel and
@@ -4295,17 +4302,18 @@ create a dedicated \f[V]conf.d/<tool>.fish\f[R] instead.
.PP
Pull the latest changes from the upstream repository without needing a
configured git remote:
.IP
.nf
\f[C]
config-update Fetch and apply the latest commits from upstream
config-update --dry-run Preview available changes without applying them
config-update --force Stash local changes, pull, then restore the stash
\f[R]
.fi
.IP \[bu] 2
\f[V]config-update\f[R] \[em] Fetch and apply the latest commits from
upstream
.IP \[bu] 2
\f[V]config-update --dry-run\f[R] \[em] Preview available changes
without applying them
.IP \[bu] 2
\f[V]config-update --force\f[R] \[em] Stash local changes, pull, then
restore the stash
.PP
All git output is suppressed.
Run exec fish after a successful update to reload.
Run \f[V]exec fish\f[R] after a successful update to reload.
.PP
* * * * *
.SH 11. PERSONALIZATION