chore(docs): regenerate manual, man page, and component registry

This commit is contained in:
2026-09-21 07:03:41 +00:00
parent 85d13a6aaf
commit 21ef25bb56
2 changed files with 69 additions and 32 deletions
+42 -18
View File
@@ -1664,7 +1664,8 @@ gitup --all
Synopsis: hist
Searches fish history interactively using fzf, inserts the selected command
into the command line, and copies it to the clipboard via wl-copy.
into the command line, and copies it to the clipboard via wl-copy, xclip,
or win32yank (WSL2).
Exit Status:
0 Command selected and inserted, or fzf was cancelled
@@ -1674,6 +1675,8 @@ Example:
hist
\f[R]
.fi
.PP
\f[B]Dependencies:\f[R] \f[V]_fish_clipboard_copy\f[R]
.SS mkrep
.IP
.nf
@@ -2414,8 +2417,8 @@ tab
\f[C]
Synopsis: p [args...]
Outputs clipboard contents to stdout. Uses wl-paste on Wayland,
falls back to xclip on X11. Supports -h/--help for usage info.
Outputs clipboard contents to stdout. Uses wl-paste on Wayland, xclip on
X11, or win32yank on WSL2. Supports -h/--help for usage info.
Arguments:
-h, --help Show usage help
@@ -2433,14 +2436,16 @@ p | grep foo
p > file.txt
\f[R]
.fi
.PP
\f[B]Dependencies:\f[R] \f[V]_fish_clipboard_paste\f[R]
.SS paste
.IP
.nf
\f[C]
Synopsis: paste [args...]
Outputs clipboard contents to stdout. Uses wl-paste on Wayland,
falls back to xclip on X11.
Outputs clipboard contents to stdout. Uses wl-paste on Wayland, xclip on
X11, or win32yank on WSL2.
Arguments:
args... Arguments forwarded to the clipboard tool
@@ -2456,14 +2461,16 @@ Example:
paste > file.txt
\f[R]
.fi
.PP
\f[B]Dependencies:\f[R] \f[V]_fish_clipboard_paste\f[R]
.SS y
.IP
.nf
\f[C]
Synopsis: y [text...]
Copies text to the system clipboard using wl-copy (Wayland) or xclip (X11).
Reads from stdin when no arguments are given.
Copies text to the system clipboard using wl-copy (Wayland), xclip (X11),
or win32yank (WSL2). Reads from stdin when no arguments are given.
Arguments:
text Text to copy; reads from stdin if omitted
@@ -2478,6 +2485,8 @@ ls | y
cat file.txt | y
\f[R]
.fi
.PP
\f[B]Dependencies:\f[R] \f[V]_fish_clipboard_copy\f[R]
.SS 5.10 Network
.SS fast
.IP
@@ -4197,6 +4206,18 @@ Sandbox; needed only by \f[V]md --read-only\f[R], which uses it to make
MarkText unable to save over the file it opened.
Every other \f[V]md\f[R] invocation works without it.
T}
T{
\f[V]win32yank.exe\f[R]
T}@T{
Clipboard bridge for WSL2; backs the
\f[V]y\f[R]/\f[V]p\f[R]/\f[V]paste\f[R]/\f[V]hist\f[R] clipboard
fallback chain when neither \f[V]wl-copy\f[R]/\f[V]wl-paste\f[R] nor
\f[V]xclip\f[R] are present.
\f[V]fish-deps\f[R] only offers to install it when WSL2 is detected
(\f[V]microsoft\f[R] in \f[V]/proc/sys/kernel/osrelease\f[R]),
downloading the \f[V]x86_64\f[R] binary from GitHub releases to
\f[V]\[ti]/.local/bin\f[R].
T}
.TE
.SS Terminal Emulators
.PP
@@ -4904,7 +4925,7 @@ Done desktop notifications Graphical desktop with a notification daemon
spwin Kitty or WezTerm
tab Kitty, WezTerm, or Konsole
split Kitty or WezTerm
hist fzf + wl-copy (Wayland clipboard)
hist fzf + wl-copy, xclip, or win32yank.exe (WSL2)
logs fzf + ov; reads from \[ti]/.terminal_history/
upgrade paru or yay (Arch Linux only)
WakaTime hook wakatime CLI and a configured API key
@@ -5329,12 +5350,15 @@ IMPORTANT: A number of functions call Linux-specific subsystems
directly, with no fallback: - \f[V]systemd-inhibit\f[R]
(\f[V]wake-lock\f[R]) - \f[V]zramctl\f[R] / \f[V]swapon\f[R]
(\f[V]swapstat\f[R]) - \f[V]sbctl\f[R] and UEFI Secure Boot state
(\f[V]sbver\f[R]) - \f[V]wl-copy\f[R] / \f[V]xclip\f[R] for clipboard
access (\f[V]y\f[R], \f[V]p\f[R], \f[V]paste\f[R], \f[V]hist\f[R]) \[em]
Wayland or X11 only, no \f[V]pbcopy\f[R]/\f[V]pbpaste\f[R] fallback -
GNU coreutils flags such as \f[V]stat -c\f[R] and \f[V]numfmt\f[R]
(\f[V]sudo-toggle\f[R], \f[V]dng2avif\f[R]), which differ or don\[cq]t
exist under a BSD userland
(\f[V]sbver\f[R]) - GNU coreutils flags such as \f[V]stat -c\f[R] and
\f[V]numfmt\f[R] (\f[V]sudo-toggle\f[R], \f[V]dng2avif\f[R]), which
differ or don\[cq]t exist under a BSD userland
.PP
Clipboard access (\f[V]y\f[R], \f[V]p\f[R], \f[V]paste\f[R],
\f[V]hist\f[R]) is the exception: it falls back through
\f[V]wl-copy\f[R]/\f[V]wl-paste\f[R] (Wayland), \f[V]xclip\f[R] (X11),
and \f[V]win32yank.exe\f[R] (WSL2), so it works on all three.
There is still no \f[V]pbcopy\f[R]/\f[V]pbpaste\f[R] fallback for macOS.
.PP
\f[B]macOS\f[R] is not supported.
\f[V]_fish_deps_detect_pm\f[R] does check for \f[V]brew\f[R], but that
@@ -5347,10 +5371,10 @@ Fish itself has no native Windows build; upstream\[cq]s own
port.
This config is not tested under WSL either.
WSL2 runs a real Linux kernel and can run \f[V]systemd\f[R], so basic
shell use may work, but \f[V]zramctl\f[R], \f[V]sbctl\f[R], and Secure
Boot state are meaningless inside a VM, and clipboard integration would
need a WSL-specific path (\f[V]clip.exe\f[R], \f[V]win32yank\f[R]) that
does not exist here.
shell use may work; \f[V]zramctl\f[R], \f[V]sbctl\f[R], and Secure Boot
state are still meaningless inside a VM, but clipboard integration works
via \f[V]win32yank.exe\f[R] (see above) once it\[cq]s installed on the
Windows side and reachable through WSL interop.
.PP
\f[B]Assumed present on any Linux system this runs on:\f[R]
\f[V]git\f[R], \f[V]gpg\f[R], \f[V]tar\f[R], and GNU coreutils (for