docs(tvix/eval): add doc comments to VM fields r/5714

Change-Id: Ia4857c217de15aec8b61e1abd39e22c50e2d816a
Reviewed-on: https://cl.tvl.fyi/c/depot/+/7876
Reviewed-by: flokli <flokli@flokli.de>
Tested-by: BuildkiteCI
Autosubmit: tazjin <tazjin@tvl.su>

1 files changed, 8 insertions, 0 deletions

diff --git a/tvix/eval/src/vm.rs b/tvix/eval/src/vm.rs
index 60006ea76f9c..b42b47c2dc01 100644
--- a/tvix/eval/src/vm.rs
+++ b/tvix/eval/src/vm.rs
@@ -109,12 +109,20 @@ pub struct VM<'o> {
     /// Runtime warnings collected during evaluation.
     warnings: Vec<EvalWarning>,
 
+    /// Import cache, mapping absolute file paths to the value that
+    /// they compile to. Note that this reuses thunks, too!
+    // TODO: should probably be based on a file hash
     pub import_cache: Box<BTreeMap<PathBuf, Value>>,
 
+    /// Parsed Nix search path, which is used to resolve `<...>`
+    /// references.
     nix_search_path: NixSearchPath,
 
+    /// Implementation of I/O operations used for impure builtins and
+    /// features like `import`.
     io_handle: Box<dyn EvalIO>,
 
+    /// Runtime observer which can print traces of runtime operations.
     observer: &'o mut dyn RuntimeObserver,
 }