From 3f1df1916feb3d7afd411894b14731570847f74d Mon Sep 17 00:00:00 2001 From: Vincent Ambo Date: Sun, 11 Sep 2022 15:33:15 +0300 Subject: docs(tvix/eval): add some notes on cloning & building tvix-eval Change-Id: I8cc359952b41994c2ba8bcfb8b0b6fc629bb81ea Reviewed-on: https://cl.tvl.fyi/c/depot/+/6502 Reviewed-by: sterni Autosubmit: tazjin Tested-by: BuildkiteCI --- tvix/eval/README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'tvix/eval') 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 -- cgit 1.4.1