From cd240f4460c14c2ab1949480e8835b4a64674e20 Mon Sep 17 00:00:00 2001 From: Gitea Actions Date: Tue, 23 Jun 2026 18:28:57 +0000 Subject: [PATCH] chore(docs): regenerate man page, HTML docs, and wiki --- docs/fish-config.1 | 53 ++++++++++++++++------ docs/html/11-7-customization.html | 6 +-- docs/html/14-10-personalization.html | 3 ++ docs/html/3-description.html | 2 +- docs/html/9-5-functions-reference.html | 61 ++++++++++++++++---------- docs/html/index.html | 6 ++- docs/html/sitemap.json | 2 +- docs/wiki/10-personalization.md | 4 ++ docs/wiki/5-functions-reference.md | 40 ++++++++++++----- docs/wiki/7-customization.md | 2 +- docs/wiki/index.md | 2 +- 11 files changed, 125 insertions(+), 56 deletions(-) diff --git a/docs/fish-config.1 b/docs/fish-config.1 index 6c3ac23..5ee0255 100644 --- a/docs/fish-config.1 +++ b/docs/fish-config.1 @@ -80,7 +80,7 @@ Nothing leaves your machine, but the files persist locally. Disable all logging with: \f[V]set -U __fish_config_op_logging off\f[R] .IP \[bu] 2 Prefer a menu? -Run the interactive picker: \f[V]config-toggle\f[R] +Run the interactive picker: \f[V]config-settings\f[R] .IP \[bu] 2 See Section 7 (C5 - Logging and Capture) for the full breakdown. .RE @@ -1705,21 +1705,26 @@ config-update --dry-run config-update --force \f[R] .fi -.SS config-toggle +.SS config-settings .IP .nf \f[C] -Synopsis: config-toggle [-h] +Synopsis: config-settings [-h] -Opens an interactive TUI for toggling the six opinionated component -categories (C1\[en]C6) and the master disable variable without having to -type or remember variable names. Two scope tabs allow independent -per-scope configuration: +Opens an interactive TUI for managing fish configuration settings. Handles +the six opinionated component categories (C1\[en]C6), the master disable +variable, and the __fish_user_dots_path path variable \[em] without having to +type or remember variable names. Two scope tabs allow independent per-scope +configuration for category toggles: Universal \[em] persists across all sessions (set -U) Session \[em] current shell only (set -g) -Changes apply immediately on each value keypress. Always available +The Dots Path row always operates on the universal scope regardless of the +active tab. + +Changes to category toggles apply immediately on each keypress. Changes to +the path variable use an inline edit prompt (Enter). Always available regardless of the __fish_config_opinionated master state. The panel adapts to the terminal width automatically, selecting from @@ -1734,17 +1739,33 @@ redraws within \[ti]0.3 s of a terminal resize with no keypress required. Navigation: ↑ ↓ / k j Move cursor - ← → / h l Set value: OFF ← DEFAULT → ON (clamped) + ← → / h l Set value: OFF ← DEFAULT → ON (toggle rows); LEFT clears path + Enter Edit the Dots Path (path row only) Tab Switch scope (Universal ↔ Session) q / Escape Exit -Left/Right (or vim-style h/l) move the highlighted value one step along -the OFF\[en]DEFAULT\[en]ON scale and stop at the ends. DEFAULT erases the -variable so the master switch / built-in default applies. +Left/Right (or vim-style h/l) move the highlighted toggle value one step +along the OFF\[en]DEFAULT\[en]ON scale and stop at the ends. DEFAULT erases the +variable so the master switch / built-in default applies. On the Dots Path +row, LEFT/h clears the universal variable; RIGHT/l is a no-op (use Enter). + +Dots Path row [U] tag: the tag confirms this row always writes to the +universal scope, regardless of which tab is active. Setting it per-session +would have no effect on startup sourcing. Flags: --help / -h Show usage. +config-settings +\f[R] +.fi +.SS config-toggle (deprecated) +.IP +.nf +\f[C] +Deprecated alias for config-settings. Prints a deprecation notice to +stderr, then delegates all arguments to config-settings. + config-toggle \f[R] .fi @@ -2090,8 +2111,8 @@ set -U __fish_config_op_greeting 1 .fi .PP For an interactive alternative to setting these variables by hand, run -config-toggle \[em] a full-screen TUI that flips any category (including -C5 logging) on or off, per session or universally. +config-settings \[em] a full-screen TUI that flips any category +(including C5 logging) on or off, per session or universally. See its entry in Section 5. .PP Notes: @@ -2643,6 +2664,10 @@ set -U __fish_user_dots_path /path/to/your/dots/fish \f[R] .fi .PP +Or use the interactive TUI \[em] run \f[V]config-settings\f[R] and +navigate to the \[lq]Dots Path\[rq] row (last row). +Press Enter to type a new path, or ← / h to reset to the default. +.PP config.fish sources local.fish from that directory on every interactive session. local.fish is responsible for sourcing its own secrets.fish: diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html index 0478ce0..148f141 100644 --- a/docs/html/11-7-customization.html +++ b/docs/html/11-7-customization.html @@ -582,9 +582,9 @@ set -U __fish_config_opinionated 0 set -U __fish_config_op_greeting 1 # (erase both to go back to full-flavor defaults)

For an interactive alternative to setting these variables by hand, -run config-toggle — a full-screen TUI that flips any category (including -C5 logging) on or off, per session or universally. See its entry in -Section 5.

+run config-settings — a full-screen TUI that flips any category +(including C5 logging) on or off, per session or universally. See its +entry in Section 5.

Notes:

diff --git a/docs/html/9-5-functions-reference.html b/docs/html/9-5-functions-reference.html index 62edda8..c9c4264 100644 --- a/docs/html/9-5-functions-reference.html +++ b/docs/html/9-5-functions-reference.html @@ -1155,18 +1155,23 @@ Flags: config-update config-update --dry-run config-update --force -

config-toggle

-
Synopsis:  config-toggle [-h]
+
config-settings

+
Synopsis:  config-settings [-h]
 
-Opens an interactive TUI for toggling the six opinionated component
-categories (C1–C6) and the master disable variable without having to
-type or remember variable names. Two scope tabs allow independent
-per-scope configuration:
+Opens an interactive TUI for managing fish configuration settings. Handles
+the six opinionated component categories (C1–C6), the master disable
+variable, and the __fish_user_dots_path path variable — without having to
+type or remember variable names. Two scope tabs allow independent per-scope
+configuration for category toggles:
 
   Universal — persists across all sessions (set -U)
   Session   — current shell only (set -g)
 
-Changes apply immediately on each value keypress. Always available
+The Dots Path row always operates on the universal scope regardless of the
+active tab.
+
+Changes to category toggles apply immediately on each keypress. Changes to
+the path variable use an inline edit prompt (Enter). Always available
 regardless of the __fish_config_opinionated master state.
 
 The panel adapts to the terminal width automatically, selecting from
@@ -1181,56 +1186,68 @@ redraws within ~0.3 s of a terminal resize with no keypress required.
 
 Navigation:
   ↑ ↓ / k j   Move cursor
-  ← → / h l   Set value: OFF ← DEFAULT → ON (clamped)
+  ← → / h l   Set value: OFF ← DEFAULT → ON (toggle rows); LEFT clears path
+  Enter        Edit the Dots Path (path row only)
   Tab          Switch scope (Universal ↔ Session)
   q / Escape   Exit
 
-Left/Right (or vim-style h/l) move the highlighted value one step along
-the OFF–DEFAULT–ON scale and stop at the ends. DEFAULT erases the
-variable so the master switch / built-in default applies.
+Left/Right (or vim-style h/l) move the highlighted toggle value one step
+along the OFF–DEFAULT–ON scale and stop at the ends. DEFAULT erases the
+variable so the master switch / built-in default applies. On the Dots Path
+row, LEFT/h clears the universal variable; RIGHT/l is a no-op (use Enter).
+
+Dots Path row [U] tag: the tag confirms this row always writes to the
+universal scope, regardless of which tab is active. Setting it per-session
+would have no effect on startup sourcing.
 
 Flags:
   --help / -h   Show usage.
 
+config-settings

+
config-toggle
+(deprecated)

+
Deprecated alias for config-settings. Prints a deprecation notice to
+stderr, then delegates all arguments to config-settings.
+
 config-toggle

-
bash

+
bash

 
Synopsis:  bash [args...]
 Switches to bash, with XDG config applied. On exit, $SHELL is reset
 back to fish.

-
bd-pull

+
bd-pull

 
Synopsis:  bd-pull <owner/repo>
 Fetches unlinked Gitea issues and creates local Beads entries, updating
 issue titles with the assigned Beads IDs.
 Requires $GITEA_TOKEN and $GITEA_URL to be set.
 
 bd-pull rootiest/fish-config

-
cheat

+
cheat

 
Synopsis:  cheat <topic> [args...]
 Displays a colorized cheatsheet using cheat -c, falls back to tldr,
 then man.
 
 cheat tar
 cheat git

-
cffetch / ffetch

+
cffetch / ffetch

 
Synopsis:  cffetch [args...]  /  ffetch [args...]
 Clears the screen and displays system information via fastfetch with
 the custom config at ~/.fastfetch.jsonc. Falls back to neofetch.

-
dockup

+
dockup

 
Synopsis:  dockup [-h] [directory]
 Pulls latest Docker images, restarts services in the given Docker
 Compose project, and prunes dangling images.
 
 dockup ~/myapp

-
joplin

+
joplin

 
Synopsis:  joplin [args...]
 Runs the Joplin CLI with Node.js deprecation warnings suppressed.
 
 joplin ls

-
ld

+
ld

 
Synopsis:  ld
 Launches lazydocker targeting the currently active Docker context,
 detected via docker context inspect.

-
replay

+
replay

 
Synopsis:  replay <commands>
 Runs Bash commands and replays any resulting changes to environment
 variables, aliases, and the working directory back into the current
@@ -1238,7 +1255,7 @@ Fish session. Useful for sourcing Bash scripts.
 
 replay "source ~/.bashrc"
 replay "export FOO=bar"

-
kitty-logging

+
kitty-logging

 
Synopsis:  kitty-logging [install|uninstall|status|dismiss] [-h]
 
 Manages the Kitty scrollback watcher that powers C5 logging. Ships a
@@ -1259,11 +1276,11 @@ uninstalling. Install affects new Kitty windows only.
 Example:
   kitty-logging install
   kitty-logging status

-
tmux-clean

+
tmux-clean

 
Synopsis:  tmux-clean
 Kills all detached (unattached) tmux sessions, leaving attached ones
 running.

-
wake-lock

+
wake-lock

 
Synopsis:  wake-lock <command> [args...]
 Runs a command under systemd-inhibit, preventing the system from going
 idle or sleeping until the command completes.
diff --git a/docs/html/index.html b/docs/html/index.html
index 38822ff..3fbb297 100644
--- a/docs/html/index.html
+++ b/docs/html/index.html
@@ -771,8 +771,10 @@ id="toc-514-miscellaneous">5.14 Miscellaneous
 id="toc-config-help">config-help
 
  • config-update
    • 
-
  • config-toggle
    • 
+
  • config-settings
    • 
+
  • config-toggle (deprecated)
    • 
 
  • bash
    • 
 
  •  your machine, but the files persist locally.
 >
 > - Disable all logging with: `set -U __fish_config_op_logging off`
-> - Prefer a menu? Run the interactive picker: `config-toggle`
+> - Prefer a menu? Run the interactive picker: `config-settings`
 > - See Section 7 (C5 - Logging and Capture) for the full breakdown.
 
 The configuration is split across: