From b6d277c140c7cbec3349bf5bd5986fc79f804e42 Mon Sep 17 00:00:00 2001 From: Tristan Partin Date: Fri, 12 Mar 2021 00:24:21 -0600 Subject: Add 'subprojects purge' command This will help facilitate cache busting in certain situations, and replaces hand-rolled solutions of writing a length command to remove various files/folders within the subprojects directory. --- docs/markdown/snippets/subprojects_purge.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 docs/markdown/snippets/subprojects_purge.md (limited to 'docs/markdown') diff --git a/docs/markdown/snippets/subprojects_purge.md b/docs/markdown/snippets/subprojects_purge.md new file mode 100644 index 0000000..86e1064 --- /dev/null +++ b/docs/markdown/snippets/subprojects_purge.md @@ -0,0 +1,18 @@ +## Purge subprojects folder + +It is now possible to purge a subprojects folder of artifacts created +from wrap-based subprojects including anything in `packagecache`. This is useful +when you want to return to a completely clean source tree or busting caches with +stale patch directories or caches. By default the command will only print out +what it is removing. You need to pass `--confirm` to the command for actual +artifacts to be purged. + +By default all wrap-based subprojects will be purged. + +- `meson subprojects purge` prints non-cache wrap artifacts which will be +purged. +- `meson subprojects purge --confirm` purges non-cache wrap artifacts. +- `meson subprojects purge --confirm --include-cache` also removes the cache +artifacts. +- `meson subprojects purge --confirm subproj1 subproj2` removes non-cache wrap +artifacts associated with the listed subprojects. -- cgit v1.1