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