From 6870c6023ebc1e190e5c06138391a3ae80ff975d Mon Sep 17 00:00:00 2001 From: Timo Teräs Date: Tue, 31 Jan 2023 15:14:54 +0200 Subject: cache: improve and document purging Document cache clean --purge better. Add a cache purge alias for it. And also purge installed package copies on disk installs. fixes #10857 --- doc/apk-cache.8.scd | 8 +++++++- doc/apk.8.scd | 6 ++++-- 2 files changed, 11 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/apk-cache.8.scd b/doc/apk-cache.8.scd index e5a9b6f..0a04123 100644 --- a/doc/apk-cache.8.scd +++ b/doc/apk-cache.8.scd @@ -10,6 +10,8 @@ apk cache - manage a local cache of package files *apk cache* [<_options_>...] download [_dependency_...] +*apk cache* [<_options_>...] purge + *apk cache* [<_options_>...] sync [_dependency_...] # DESCRIPTION @@ -23,7 +25,11 @@ default _world_ dependencies are used to determine what to download. If _dependency_ arguments are given, they will by default replace the _world_. *apk cache clean* will remove package files which no longer exist in any -repository index. +repository index. Specifying the global option *--purge* will additionally +remove all uninstalled package on tmpfs installations, and all packages on +disk installations. + +*apk cache purge* is a synonym for *clean --purge*. *apk cache sync* performs both operations. diff --git a/doc/apk.8.scd b/doc/apk.8.scd index 1b9b6f3..23d091c 100644 --- a/doc/apk.8.scd +++ b/doc/apk.8.scd @@ -161,8 +161,10 @@ The following options are available for all commands. Write progress to the specified file descriptor. *--purge* - Delete modified configuration files on package removal and uninstalled - packages from cache on cache clean. + Purge modified configuration and cached packages. Enables deletion of + modified configuration files on package removal. On cache clean action + this enables deletion of unneeded cached packages (uninstalled packages + on tmpfs installations or all packages on disk installations). *--repositories-file* _REPOFILE_ Override system repositories, see *apk-repositories*(8). Specifying this -- cgit v1.2.3-60-g2f50