aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/rl-next/eval-system.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/manual/rl-next/eval-system.md b/doc/manual/rl-next/eval-system.md
new file mode 100644
index 000000000..a4696a56c
--- /dev/null
+++ b/doc/manual/rl-next/eval-system.md
@@ -0,0 +1,12 @@
+---
+synopsis: Add new `eval-system` setting
+prs: 4093
+---
+
+Add a new `eval-system` option.
+Unlike `system`, it just overrides the value of `builtins.currentSystem`.
+This is more useful than overriding `system`, because you can build these derivations on remote builders which can work on the given system.
+In contrast, `system` also effects scheduling which will cause Nix to build those derivations locally even if that doesn't make sense.
+
+`eval-system` only takes effect if it is non-empty.
+If empty (the default) `system` is used as before, so there is no breakage.