summaryrefslogtreecommitdiff
path: root/doc/concepts/computed-roots.md
diff options
context:
space:
mode:
authorKlaus Aehlig <klaus.aehlig@huawei.com>2025-04-14 12:55:12 +0200
committerKlaus Aehlig <klaus.aehlig@huawei.com>2025-04-14 13:02:45 +0200
commit629df017d74734e93e2b63a1bb4b7819a34a1c9f (patch)
tree3c16b58c162a08b3ffda718aa183e2e42442aa6d /doc/concepts/computed-roots.md
parentc7216ce1da69f3fdbd2e577113c0a15a7dd41130 (diff)
downloadjustbuild-629df017d74734e93e2b63a1bb4b7819a34a1c9f.tar.gz
clean up markdown in tutorial and concepts
... and ensure that pandoc processes them correctly. In particular, add an empty line around itemize environments.
Diffstat (limited to 'doc/concepts/computed-roots.md')
-rw-r--r--doc/concepts/computed-roots.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/doc/concepts/computed-roots.md b/doc/concepts/computed-roots.md
index 171c7648..7007eab4 100644
--- a/doc/concepts/computed-roots.md
+++ b/doc/concepts/computed-roots.md
@@ -136,9 +136,11 @@ of a `"computed"` repository is just forwarded as computed root.
Due to the presence of `just serve`, roots can be absent. This
affects computed roots in two ways,
+
- roots, in particular the target roots, of the repository referred
to can be absent, and
- a computed root can be absent itself.
+
The latter has to be supported, as dependencies that should be
delegated to `just serve` might contain computed roots themselves.
In this case, we consider it acceptable to have one round of talking
@@ -172,12 +174,14 @@ true}]` is the same computed root considered absent.
If a computed root is absent then, in native mode, regardless of whether
the base repository is absent or not,
+
- serve will be asked for the result, and
- from the result the tree identifier of the root will be computed
in memory and the root set to that value, as absent.
If a concrete computed root refers to a base repository with absent
target root,
+
- the client will ask serve about the flexible variables of the
specified target, and
- with this information will compute locally the cache key and