summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKlaus Aehlig <klaus.aehlig@huawei.com>2024-06-06 17:04:41 +0200
committerKlaus Aehlig <klaus.aehlig@huawei.com>2024-06-06 17:04:41 +0200
commit49fe646298a92364ea199bb7fca50f86dd112ed2 (patch)
tree3e81aa8278c4c253fdd8a73a2fab13d117631432
parentc79221225909cf33c9b38deda310a9b8cfee0c85 (diff)
downloadjustbuild-49fe646298a92364ea199bb7fca50f86dd112ed2.tar.gz
Update documentation about tc writing in the presence of serve
-rw-r--r--doc/concepts/service-target-cache.md10
-rw-r--r--doc/future-designs/tc-gc.md14
2 files changed, 10 insertions, 14 deletions
diff --git a/doc/concepts/service-target-cache.md b/doc/concepts/service-target-cache.md
index 19db3ef8..8821cfad 100644
--- a/doc/concepts/service-target-cache.md
+++ b/doc/concepts/service-target-cache.md
@@ -379,3 +379,13 @@ This includes
In this way, `just-mr` can be used to fill the CAS from one central
point with all the information the clients need to treat all
content-fixed roots as absent.
+
+### Target-level cache writing in the presence of some targets served
+
+When building, `just` normally does not create an entry for
+target-level cache hit received from `just serve`. However, it
+might happen that `just` has to analyse an eligible `export`
+target locally, as the `just serve` instance cannot provide it, and
+during that analysis `export` targets provided by `just serve` are
+encountered. In this case, the writing of the export targets depending
+on served targets is skipped.
diff --git a/doc/future-designs/tc-gc.md b/doc/future-designs/tc-gc.md
deleted file mode 100644
index 8060a546..00000000
--- a/doc/future-designs/tc-gc.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Target-level cache dependencies for garbage collection
-
-## Interaction with `just serve`
-
-When building, `just` normally does not create an entry for
-target-level cache hit received from `just serve`. However, it
-might happen that `just` has to analyse an eligible `export`
-target locally, as the `just serve` instance cannot provide it, and
-during that analysis `export` targets provided by `just serve` are
-encountered. In this case, before writing the target-level cache
-entry for the locally analysed `export` target, the `just build`
-process, in order to keep cache consistency, will first query and
-write to the local target-level cache the transitively implied
-target-level cache entries.