diff options
| author | Danilo M. <danix@danix.xyz> | 2026-07-09 11:05:40 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-07-09 11:05:40 +0200 |
| commit | 93190858380c533f9b7564c42bdfb5dbea03f144 (patch) | |
| tree | 26a861ed4cedc4010549465c660c207d24a247c2 /mkhint.1.md | |
| parent | 2c6e860df7e394fff4753796128fd50ce5c04ef3 (diff) | |
| download | mkhintfile-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.md | 18 |
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. |
