From 91dabd565cbd9eec5e6f7f88271605f3740aacb0 Mon Sep 17 00:00:00 2001 From: Rootiest Date: Tue, 8 Sep 2026 12:42:30 -0400 Subject: [PATCH] fix(docs): strip backticks from Section 5 verbatim EXIT STATUS/ARGUMENTS lines Section 5 (function manpages) is pandoc-rendered verbatim, so a backtick there is a literal character on the page, not markup. Nine EXIT STATUS/ ARGUMENTS lines across check_fish_deps, lock, cleanup, claude-pr, claude-docs, dops, ports, screensleep, and steam-dl quoted a command with backticks; reworded to plain text matching each function's own DESCRIPTION style. Fixes docs/verify-manual.py's test_concat_section_five_stays_verbatim, failing in CI since before this branch (pre-existing on main, confirmed against the commit before PR #133 merged). --- functions/check_fish_deps.fish | 2 +- functions/claude-docs.fish | 2 +- functions/claude-pr.fish | 2 +- functions/cleanup.fish | 2 +- functions/dops.fish | 4 ++-- functions/lock.fish | 2 +- functions/ports.fish | 2 +- functions/screensleep.fish | 2 +- functions/steam-dl.fish | 2 +- 9 files changed, 10 insertions(+), 10 deletions(-) diff --git a/functions/check_fish_deps.fish b/functions/check_fish_deps.fish index 3be6cb5..981fa50 100644 --- a/functions/check_fish_deps.fish +++ b/functions/check_fish_deps.fish @@ -12,7 +12,7 @@ # report which fish shell dependencies are installed or missing. # # EXIT STATUS -# Exit status of `fish-deps status` +# Exit status of fish-deps status # # EXAMPLE # check_fish_deps diff --git a/functions/claude-docs.fish b/functions/claude-docs.fish index 699d814..5ac679b 100644 --- a/functions/claude-docs.fish +++ b/functions/claude-docs.fish @@ -13,7 +13,7 @@ # obsolete content. # # EXIT STATUS -# Exit status of the `claude` invocation +# Exit status of the claude invocation # # EXAMPLE # claude-docs diff --git a/functions/claude-pr.fish b/functions/claude-pr.fish index 02bd88c..1079251 100644 --- a/functions/claude-pr.fish +++ b/functions/claude-pr.fish @@ -13,7 +13,7 @@ # pull request with a manual verification checklist. # # EXIT STATUS -# Exit status of the `claude` invocation +# Exit status of the claude invocation # # EXAMPLE # claude-pr diff --git a/functions/cleanup.fish b/functions/cleanup.fish index 17e7612..a2d1297 100644 --- a/functions/cleanup.fish +++ b/functions/cleanup.fish @@ -13,7 +13,7 @@ # # EXIT STATUS # 0 No orphans found, or orphans removed successfully -# Nonzero `sudo pacman -Rns` failed +# Nonzero sudo pacman -Rns failed # # EXAMPLE # cleanup diff --git a/functions/dops.fish b/functions/dops.fish index b1b5422..6364659 100644 --- a/functions/dops.fish +++ b/functions/dops.fish @@ -16,10 +16,10 @@ # columns. Extra arguments (e.g. -a) are forwarded to docker ps. # # ARGUMENTS -# args... Arguments forwarded to `docker ps` +# args... Arguments forwarded to docker ps # # EXIT STATUS -# Exit status of `docker ps` +# Exit status of docker ps # # EXAMPLE # dops diff --git a/functions/lock.fish b/functions/lock.fish index 16f4043..dcb0785 100644 --- a/functions/lock.fish +++ b/functions/lock.fish @@ -11,7 +11,7 @@ # Locks the current desktop session using loginctl lock-session. # # EXIT STATUS -# Exit status of `loginctl lock-session` +# Exit status of loginctl lock-session # # EXAMPLE # lock diff --git a/functions/ports.fish b/functions/ports.fish index c57e7ec..7b2f35a 100644 --- a/functions/ports.fish +++ b/functions/ports.fish @@ -12,7 +12,7 @@ # port numbers and addresses without hostname resolution. # # EXIT STATUS -# Exit status of `lsof` +# Exit status of lsof # # EXAMPLE # ports diff --git a/functions/screensleep.fish b/functions/screensleep.fish index 4496031..ba1e18b 100644 --- a/functions/screensleep.fish +++ b/functions/screensleep.fish @@ -12,7 +12,7 @@ # PowerDevil "Turn Off Screen" global shortcut via busctl. # # EXIT STATUS -# Exit status of `busctl` +# Exit status of busctl # # EXAMPLE # screensleep diff --git a/functions/steam-dl.fish b/functions/steam-dl.fish index 24583bd..5223a2d 100644 --- a/functions/steam-dl.fish +++ b/functions/steam-dl.fish @@ -12,7 +12,7 @@ # or sleeping during active downloads. # # EXIT STATUS -# Exit status of `steam` (via systemd-inhibit) +# Exit status of steam (via systemd-inhibit) # # EXAMPLE # steam-dl -- 2.54.0