From 83e8c52298802be343bf7acf0fc16b0d96381572 Mon Sep 17 00:00:00 2001 From: Gitea Actions Date: Tue, 21 Jul 2026 18:11:30 +0000 Subject: [PATCH] chore(docs): regenerate man page, HTML docs, and wiki --- docs/fish-config.1 | 17 +++++++++-------- docs/html/11-7-customization.html | 8 ++++---- docs/html/9-5-functions-reference.html | 11 ++++++----- docs/wiki/5-functions-reference.md | 11 ++++++----- 4 files changed, 25 insertions(+), 22 deletions(-) diff --git a/docs/fish-config.1 b/docs/fish-config.1 index 6b7cf56..b794991 100644 --- a/docs/fish-config.1 +++ b/docs/fish-config.1 @@ -1968,13 +1968,14 @@ replay \[dq]export FOO=bar\[dq] Synopsis: kitty-logging [install|uninstall|status|dismiss] [-h] Manages the Kitty scrollback watcher that powers C5 logging. Ships a -canonical, version-marked watcher and installs it into the Kitty config -directory, wiring it into kitty.conf through a sentinel-marked managed -block. Commenting out any conflicting watcher line avoids double-capture. +canonical watcher and symlinks it into the Kitty config directory (so it +always tracks the source), wiring it into kitty.conf through a +sentinel-marked managed block. Commenting out any conflicting watcher line +avoids double-capture. Commands: - install Copy/refresh the watcher and add the managed block - uninstall Remove the managed block and the watcher file + install Symlink the watcher and add the managed block + uninstall Remove the managed block and the watcher symlink status Show wiring, installed watcher version, and C5 state dismiss Stop the per-session setup reminder @@ -2469,9 +2470,9 @@ To guarantee a zellij pane is logged, end the session with \f[V]exit\f[R] or Ctrl-D rather than zellij\[cq]s close-pane or quit actions. .PP -The Kitty watcher is managed by the kitty-logging command: it installs a -version-marked watcher (fish-config-watcher.py) into the Kitty config -directory and wires it into kitty.conf via a managed block. +The Kitty watcher is managed by the kitty-logging command: it symlinks +the watcher (fish-config-watcher.py) into the Kitty config directory and +wires it into kitty.conf via a managed block. Inside Kitty, a non-blocking per-session reminder points first-time users at \f[V]kitty-logging install\f[R] until they install or run \f[V]kitty-logging dismiss\f[R]. diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html index 2f37362..785b9a4 100644 --- a/docs/html/11-7-customization.html +++ b/docs/html/11-7-customization.html @@ -785,10 +785,10 @@ guarantee a zellij pane is logged, end the session with exit or Ctrl-D rather than zellij's close-pane or quit actions.

The Kitty watcher is managed by the kitty-logging command: it -installs a version-marked watcher (fish-config-watcher.py) into the -Kitty config directory and wires it into kitty.conf via a managed block. -Inside Kitty, a non-blocking per-session reminder points first-time -users at kitty-logging install until they install or run +symlinks the watcher (fish-config-watcher.py) into the Kitty config +directory and wires it into kitty.conf via a managed block. Inside +Kitty, a non-blocking per-session reminder points first-time users at +kitty-logging install until they install or run kitty-logging dismiss. Install affects new Kitty windows only; runtime disable is still handled by the .logging_disabled sentinel.

diff --git a/docs/html/9-5-functions-reference.html b/docs/html/9-5-functions-reference.html index 9d23ff7..1a556e1 100644 --- a/docs/html/9-5-functions-reference.html +++ b/docs/html/9-5-functions-reference.html @@ -1339,13 +1339,14 @@ replay "export FOO=bar" 
Synopsis:  kitty-logging [install|uninstall|status|dismiss] [-h]
 
 Manages the Kitty scrollback watcher that powers C5 logging. Ships a
-canonical, version-marked watcher and installs it into the Kitty config
-directory, wiring it into kitty.conf through a sentinel-marked managed
-block. Commenting out any conflicting watcher line avoids double-capture.
+canonical watcher and symlinks it into the Kitty config directory (so it
+always tracks the source), wiring it into kitty.conf through a
+sentinel-marked managed block. Commenting out any conflicting watcher line
+avoids double-capture.
 
 Commands:
-  install    Copy/refresh the watcher and add the managed block
-  uninstall  Remove the managed block and the watcher file
+  install    Symlink the watcher and add the managed block
+  uninstall  Remove the managed block and the watcher symlink
   status     Show wiring, installed watcher version, and C5 state
   dismiss    Stop the per-session setup reminder
 
diff --git a/docs/wiki/5-functions-reference.md b/docs/wiki/5-functions-reference.md
index 4e412a6..c72b16a 100644
--- a/docs/wiki/5-functions-reference.md
+++ b/docs/wiki/5-functions-reference.md
@@ -1050,13 +1050,14 @@
     Synopsis:  kitty-logging [install|uninstall|status|dismiss] [-h]
 
     Manages the Kitty scrollback watcher that powers C5 logging. Ships a
-    canonical, version-marked watcher and installs it into the Kitty config
-    directory, wiring it into kitty.conf through a sentinel-marked managed
-    block. Commenting out any conflicting watcher line avoids double-capture.
+    canonical watcher and symlinks it into the Kitty config directory (so it
+    always tracks the source), wiring it into kitty.conf through a
+    sentinel-marked managed block. Commenting out any conflicting watcher line
+    avoids double-capture.
 
     Commands:
-      install    Copy/refresh the watcher and add the managed block
-      uninstall  Remove the managed block and the watcher file
+      install    Symlink the watcher and add the managed block
+      uninstall  Remove the managed block and the watcher symlink
       status     Show wiring, installed watcher version, and C5 state
       dismiss    Stop the per-session setup reminder