docs(tvix/eval): update string context document

NixString doesn't contain a `HashSet<BuildReference>` anymore, there's a
more packed internal data structure. We don't need to be overly specific
in the docs, just say we expose an API.

Change-Id: I13380c49293f9a86d1916909fdfeefbe64d9024b
Reviewed-on: https://cl.tvl.fyi/c/depot/+/12755
Tested-by: BuildkiteCI
Autosubmit: flokli <flokli@flokli.de>
Reviewed-by: edef <edef@edef.eu>
This commit is contained in:
Florian Klink 2024-10-21 15:34:40 +02:00 committed by flokli
parent 2af30c8c7f
commit 1474471327

View file

@ -120,9 +120,10 @@ passes etc.
In the past, Tvix did not track string contexts in its evaluator at all, see
the historical section for more information about that.
Tvix tracks string contexts in every `NixString` structure via a
`HashSet<BuildReference>` and offers an API to combine the references while
keeping the exact internal structure of that data private.
Tvix tracks string contexts in every `NixString` structure and offers an API to
do operations on the context (inherit/clear/…), as well as iterators over
(different types of) context elements, while keeping the exact internal
structure of that data private.
## Historical attempt: Persistent reference tracking