From d4ca425543752a370273a96af3f8606ab2b398cb Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Wed, 24 Jun 2026 17:07:16 +0200 Subject: Document package cache (CLAUDE.md, README) Co-Authored-By: Claude Opus 4.8 --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 6a15ff0..8f32ead 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,20 @@ The base is kept patched automatically on each run: when the mirror's ChangeLog head differs from the recorded marker, new packages from `patches/packages/` are applied to the local base via `upgradepkg`. +## Package cache + +Set `PKG_CACHE` in your config to a local directory to cache built packages +across runs (leave empty to disable). Layout mirrors the SBo tree +(`//--...txz`), one package per prog. + +The named target always builds fresh, it is the package under test. Its +dependencies are installed from the cache when their version is unchanged +(reported as `CACHED`), otherwise they are built and cached. A build order line +shows the outcome per package: `cached (1.1)`, `rebuild: 1.0 -> 1.1`, or +`build (new)`; `--dry-run` shows the same without building. The whole cache is +wiped automatically when the base is patched, since cached packages were built +against the previous base. + ## Usage ``` -- cgit v1.2.3