aboutsummaryrefslogtreecommitdiffstats
path: root/mkhint.1.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-07-09 17:22:55 +0200
committerDanilo M. <danix@danix.xyz>2026-07-09 17:22:55 +0200
commite94e3fe6e1d30a856913992aafb35bc7dfa2912d (patch)
treefc39d885612d6941e7f4d261ec088840c95367fe /mkhint.1.md
parentd74e9388d7d0581758d7aebe699e65c45f7bafb0 (diff)
downloadmkhintfile-e94e3fe6e1d30a856913992aafb35bc7dfa2912d.tar.gz
mkhintfile-e94e3fe6e1d30a856913992aafb35bc7dfa2912d.zip
feat: --info version-compare row; fix -i completion; release v1.2.6v1.2.6
--info/-i now prints a version-compare row between the header and the README: SBo .info version vs the hint's, greening the higher side (< / >), yellow on equal (=), '(no hint)' when no hint carries a version, skipped when the .info has no version. Header stays pinned, version row scrolls with the README. Completion: -i now completes package names (was flag-only); package-name completion for -n/-i drops the broken -maxdepth 2 .info scan for a param-expansion sweep of REPO_DIR/*/*/ dirs, ~7s -> ~60ms. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'mkhint.1.md')
-rw-r--r--mkhint.1.md16
1 files changed, 10 insertions, 6 deletions
diff --git a/mkhint.1.md b/mkhint.1.md
index 593bfb3..aa458a7 100644
--- a/mkhint.1.md
+++ b/mkhint.1.md
@@ -1,4 +1,4 @@
-% MKHINT(1) mkhint 1.2.5 | User Commands
+% MKHINT(1) mkhint 1.2.6 | User Commands
% Danilo M.
% July 2026
@@ -87,11 +87,15 @@ show a diff and prompt **[K]eep / [D]elete / [S]kip**.
: Delete a hint file and its `.bak`. Accepts multiple names.
**\--info**, **-i** *FILE*
-: Show a package's `category/program` path (green on a TTY), then its
-`README`. Paged with a sticky header (`less --header=1`) only when the
-`README` is taller than the terminal; printed inline when it fits or when
-piped. Missing package exits 2; missing `README` prints `(no README)` and
-exits 0. Mutually exclusive with **-V**, **-f**, **-n**.
+: Show a package's `category/program` path (green on a TTY), then a
+version-compare row, then its `README`. The row compares the SBo `.info`
+version against the hint's: `SBo: x < Hint: y` (or `>`) with the higher side
+green, `SBo: x = Hint: y` in yellow when equal, or `SBo: x (no hint)` when no
+hint carries a version. Omitted when the `.info` has no version. Paged with a
+sticky header (`less --header=1`) only when the `README` is taller than the
+terminal; printed inline when it fits or when piped. Missing package exits 2;
+missing `README` prints `(no README)` and exits 0. Mutually exclusive with
+**-V**, **-f**, **-n**.
**\--clean**, **-c**
: Remove all `.bak` files from the hint directory.