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

docs(functions): merge remaining manual prose into function headers

Browse Source 
Folds the last seven manual entries whose description exceeded their header
back into the source-of-truth comment blocks: config-settings (Sponge/Paths
page detail, list-value parsing, width tiers, navigation keys), fish-deps
(install-method priority, dependency tiers), logs (fzf keybindings, ov
viewer behavior), kitty-logging (symlink wording, C5 inert-vs-uninstalled),
config-update (exec fish reload), yt-dlp (C1 guard). Drops duplicate example
lines left by the previous merge.
This commit is contained in:
rootiest
2026-07-26 03:52:02 -04:00
parent 02c46ebea7
commit 8d6ca1797a
8 changed files with 85 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
functions/kitty-logging.fish
+13 -9
View File
@@ -8,17 +8,21 @@
# kitty-logging [install | uninstall | status | dismiss] [-h]
#
# DESCRIPTION
# Manages the fish-config Kitty scrollback watcher. `install` copies the
# canonical watcher into the Kitty config dir and wires it into kitty.conf via
# a sentinel-marked managed block (commenting out any conflicting active
# watcher line to avoid double-capture). `uninstall` reverses it. `status`
# reports wiring, watcher version, and C5 logging state. `dismiss` silences the
# per-session setup reminder. Runtime capture remains gated by the C5
# .logging_disabled sentinel; install affects future Kitty instances only.
# Manages the fish-config Kitty scrollback watcher that powers C5 logging.
# `install` symlinks the canonical watcher into the Kitty config dir (so it
# always tracks the source) and wires it into kitty.conf via a
# sentinel-marked managed block, commenting out any conflicting active
# watcher line to avoid double-capture. `uninstall` reverses it. `status`
# reports wiring, installed watcher version, and C5 logging state. `dismiss`
# silences the per-session setup reminder.
#
# Runtime capture stays governed by the C5 .logging_disabled sentinel, so
# disabling __fish_config_op_logging makes the watcher inert without
# uninstalling. Install affects new Kitty windows only.
#
# ARGUMENTS
# install Copy the watcher and add the managed block to kitty.conf
# uninstall Remove the managed block and the installed watcher
# install Symlink the watcher and add the managed block to kitty.conf
# uninstall Remove the managed block and the watcher symlink
# status Report wiring, watcher version, and C5 logging state
# dismiss Stop the per-session reminder
# -h, --help Show this help