about summary refs log tree commit diff
path: root/tvix/eval/README.md
diff options
context:
space:
mode:
authorVincent Ambo <mail@tazj.in>2022-09-11T12·33+0300
committerclbot <clbot@tvl.fyi>2022-09-11T19·58+0000
commit3f1df1916feb3d7afd411894b14731570847f74d (patch)
tree3364c9208110714deb43bb8e576546001450863d /tvix/eval/README.md
parent19c072304541a97e5bc62b928d753f20489b9c7c (diff)
docs(tvix/eval): add some notes on cloning & building tvix-eval r/4818
Change-Id: I8cc359952b41994c2ba8bcfb8b0b6fc629bb81ea
Reviewed-on: https://cl.tvl.fyi/c/depot/+/6502
Reviewed-by: sterni <sternenseemann@systemli.org>
Autosubmit: tazjin <tazjin@tvl.su>
Tested-by: BuildkiteCI
Diffstat (limited to 'tvix/eval/README.md')
-rw-r--r--tvix/eval/README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/tvix/eval/README.md b/tvix/eval/README.md
index ec0f4fece334..785c0a76643a 100644
--- a/tvix/eval/README.md
+++ b/tvix/eval/README.md
@@ -18,6 +18,29 @@ We expect this to have caught up in a handful of weeks (as of
 Please contact [TVL](https://tvl.fyi) with any questions you might
 have.
 
+## Building the evaluator
+
+If you are in a full checkout of the TVL depot, you can simply run `mg
+build` in this directory (or `mg build //tvix/eval` from anywhere in
+the repo).
+
+**Important note:** We only use and test Nix builds of our software
+against Nix 2.3. There are a variety of bugs and subtle problems in
+newer Nix versions which we do not have the bandwidth to address,
+builds in newer Nix versions may or may not work.
+
+The evaluator can also be built with standard Rust tooling (i.e.
+`cargo build`).
+
+If you would like to clone **only** the evaluator and build it
+directly with Rust tooling, you can do:
+
+```bash
+git clone https://code.tvl.fyi/depot.git:/tvix/eval.git tvix-eval
+
+cd tvix-eval && cargo build
+```
+
 ## Nix test suite
 
 C++ Nix implements a language test suite in the form of Nix source