aboutsummaryrefslogtreecommitdiffstats
path: root/mkhint.1.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-07-09 11:05:40 +0200
committerDanilo M. <danix@danix.xyz>2026-07-09 11:05:40 +0200
commit93190858380c533f9b7564c42bdfb5dbea03f144 (patch)
tree26a861ed4cedc4010549465c660c207d24a247c2 /mkhint.1.md
parent2c6e860df7e394fff4753796128fd50ce5c04ef3 (diff)
downloadmkhintfile-93190858380c533f9b7564c42bdfb5dbea03f144.tar.gz
mkhintfile-93190858380c533f9b7564c42bdfb5dbea03f144.zip
feat: nvchecker autodetect expansion, -n stanza echo, --info/-i; release v1.2.5
Documents the Task 1-6 additions that shipped without doc updates: expanded nvchecker source autodetection (gitlab, bitbucket, gitea, codeberg, pagure, npm, gems, crates.io, cpan, hackage, packagist, cran, in addition to github and pypi), the fenced stanza echo on --new/-n, and the --info/-i command (category/program header plus paged README). Updates show_help, bash completion, mkhint.1.md (rebuilds mkhint.1.gz), CLAUDE.md, and CHANGELOG.md. Bumps MKHINT_VERSION to 1.2.5. No program logic changed; 224/224 tests still pass.
Diffstat (limited to 'mkhint.1.md')
-rw-r--r--mkhint.1.md18
1 files changed, 16 insertions, 2 deletions
diff --git a/mkhint.1.md b/mkhint.1.md
index f01be66..593bfb3 100644
--- a/mkhint.1.md
+++ b/mkhint.1.md
@@ -1,4 +1,4 @@
-% MKHINT(1) mkhint 1.2.4 | User Commands
+% MKHINT(1) mkhint 1.2.5 | User Commands
% Danilo M.
% July 2026
@@ -22,6 +22,8 @@ mkhint - manage hint files for slackrepo scripts
**mkhint** **\--delete** *FILE*...
+**mkhint** **\--info** *FILE*
+
**mkhint** **\--clean**
**mkhint** {**\--version** | **\--help**}
@@ -55,7 +57,11 @@ to *FILE*.bak first.
`HOMEPAGE`, `MAINTAINER`, and `EMAIL`, comments out `REQUIRES`, and sets
`ARCH="x86_64"`, keeping only the variables a hint needs. `VERSION` is kept
from the `.info` unless **-V** is given. Appends an **nvchecker** section to the
-config, autodetecting a github or pypi source or leaving a commented stub.
+config, autodetecting the upstream source (github, gitlab, bitbucket, gitea,
+codeberg, pagure, pypi, npm, gems, crates.io, cpan, hackage, packagist, or
+cran) or leaving a commented stub when nothing matches. Prints the managed
+**nvchecker** stanza on stdout, whether it was just added or was already
+present.
**\--check**, **-C** \[*FILE*...]
: Check all (or the named) hints for upstream updates via **nvchecker** and
@@ -80,6 +86,13 @@ show a diff and prompt **[K]eep / [D]elete / [S]kip**.
**\--delete**, **-d** *FILE*...
: 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**.
+
**\--clean**, **-c**
: Remove all `.bak` files from the hint directory.
@@ -132,6 +145,7 @@ List, review, sweep, delete, clean:
mkhint --review
mkhint --fix-current
mkhint --delete mypackage
+ mkhint --info mypackage
mkhint --clean
URLs set to `UNSUPPORTED` or `UNTESTED` are skipped during download.