chore(docs): regenerate manual and man page
This commit is contained in:
+57
-49
@@ -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.fish → functions/_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
|
||||||
|
|||||||
Reference in New Issue
Block a user