aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-06-13 17:58:44 +0200
committerDanilo M. <danix@danix.xyz>2026-06-13 17:58:44 +0200
commit8c14667b6377e643bd1e6d630e9d12bccf6660d3 (patch)
tree74c7ebc3f03796f7f12f53ffbd02417dc7f7664a
parent37f1ff189ffef9625609a339d635b29ba07fac8c (diff)
downloadmkhintfile-8c14667b6377e643bd1e6d630e9d12bccf6660d3.tar.gz
mkhintfile-8c14667b6377e643bd1e6d630e9d12bccf6660d3.zip
docs: document --check populate-missing-sections prompt
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
-rw-r--r--CLAUDE.md7
-rw-r--r--README.md2
2 files changed, 8 insertions, 1 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index f6578bf..7320177 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -82,6 +82,11 @@ Test coverage:
| T24 | `--check` all current — "all up to date", no slackrepo |
| T25 | `--check` mixed — decline one / accept one |
| T26 | `--check` with -v — mutually-exclusive error, exit 1 |
+| T27 | `--check` upstream older than hint — reported as `(?downgrade)` |
+| T28 | `--check` no args — scans entire HINT_DIR |
+| T29 | `--check` missing section, accept populate — github section appended, run stops, hint unchanged |
+| T30 | `--check` missing section, decline populate — nothing added |
+| T31 | `--check` missing section, no `.info` in repo — skipped, no section added |
When adding new features, add a corresponding test case to `tests/mkhint_test.sh`.
@@ -91,7 +96,7 @@ When adding new features, add a corresponding test case to `tests/mkhint_test.sh
- `--new` with existing `.info`: copies `.info` as template, strips `PRGNAM`, `HOMEPAGE`, `MAINTAINER`, `EMAIL`, comments out `REQUIRES`, sets `ARCH="x86_64"`. Keeps `VERSION` from `.info`. If `-v` given, updates version string and recalculates checksums. Also appends an nvchecker `[section]` to the config, auto-detecting github/pypi source or providing a commented stub.
- `--new` when hint already exists: backs up old, creates empty skeleton.
- `--hintfile` with no `-v`: queries nvchecker for latest version, shows current vs. latest, prompts to accept/override/decline. After accepting, runs `nvtake` to sync nvchecker's keyfile.
-- `--check` / `-C`: runs nvchecker for all (or named) hints, reports outdated packages with current → latest versions, prompts per-package to update, applies updates with `nvtake`, then prompts single `slackrepo update` for all updated packages.
+- `--check` / `-C`: runs nvchecker for all (or named) hints, reports outdated packages with current → latest versions, prompts per-package to update, applies updates with `nvtake`, then prompts single `slackrepo update` for all updated packages. Hints with no `[pkg]` section in `nvchecker.toml` are collected and, after the scan, a single prompt offers to populate the config via `add_nvchecker_section` (github/pypi autodetect, else stub); on accept it prints a "review and re-run" message and stops the run without applying updates. Packages whose `.info` is not found in `REPO_DIR` are skipped.
- `--no-dl` / `-N`: downloads and recalculates checksums as normal, then appends `NODOWNLOAD=yes` after `MD5SUM_x86_64=`. Works with `--hintfile` or `--new`. Error if used alone.
- `--delete` / `-d`: removes hint file and `.bak` if present. Accepts multiple package names. Exits 2 on first missing file.
- Downloads go to `/tmp/mkhint/download` (single shared temp file, deleted after md5 calculation).
diff --git a/README.md b/README.md
index e71429d..5eb5ec0 100644
--- a/README.md
+++ b/README.md
@@ -146,6 +146,8 @@ mkhint --check pkg1 pkg2 # check specific packages
mkhint -C # short form
```
+If any scanned hint file has no nvchecker source configured, `--check` lists those packages and offers to populate `nvchecker.toml` for them in one prompt — auto-detecting github/pypi from the SBo `.info`, otherwise writing a commented stub to fill in. After populating, it asks you to review the file (fill any stubs) and re-run `mkhint -C`. Packages with no matching `.info` in the repository are skipped.
+
### Help
```bash