summaryrefslogtreecommitdiff
path: root/doc/future-designs
diff options
context:
space:
mode:
authorMaksim Denisov <denisov.maksim@huawei.com>2025-06-12 11:48:06 +0200
committerMaksim Denisov <denisov.maksim@huawei.com>2025-06-12 17:07:17 +0200
commit83a064b9d3c76900937d594675d407fc57681fee (patch)
tree22613d889abf00a3880304d920ea9d9015022c97 /doc/future-designs
parent64dd0eb0c941508536ff479f9e3be1bc23099a4a (diff)
downloadjustbuild-83a064b9d3c76900937d594675d407fc57681fee.tar.gz
Update documentation
Diffstat (limited to 'doc/future-designs')
-rw-r--r--doc/future-designs/gc-all.md28
1 files changed, 0 insertions, 28 deletions
diff --git a/doc/future-designs/gc-all.md b/doc/future-designs/gc-all.md
deleted file mode 100644
index b03ad9a4..00000000
--- a/doc/future-designs/gc-all.md
+++ /dev/null
@@ -1,28 +0,0 @@
-Full Garbage Collection
-===============================
-
-Motivation
-----------
-
-Over time, a lot of files accumulate in the local build root. `just` has a way
-to reclaim disk space while keeping the benefits of having a cache. At the same
-time, one of the steps of garbage collection is generational compactification.
-This is a mechanism for storing large objects in chunks, and it takes some time
-to scan the youngest generation and split up the large objects.
-
-Users may be interested in clearing the entire cache at once, so there is no
-need to worry about storage validity and spend extra time on compactification.
-Currently, there is no way to skip compactification, since this may invalidate
-the large object CAS. This results into the need for calling `just gc` several
-times manually, and the waiting time depends on the size of the youngest
-generation.
-
-Proposal
---------
-
-The `gc` command gets an additional mode that removes all generation folders
-without compactification.
-
-Update `just` `gc` command to support the `--all` flag. This flag is
-incompatible with `--no-rotate`, and an error must be reported if those two
-flags are met.