From 7ca546399118500a2f31975222fbc10a1c22a3fe Mon Sep 17 00:00:00 2001
From: Graham Christensen <graham@grahamc.com>
Date: Wed, 20 Dec 2017 07:01:32 -0500
Subject: [PATCH] document how evals are executed, closes #20

---
 README.md | 32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index bbc7195..5ae2111 100644
--- a/README.md
+++ b/README.md
@@ -78,16 +78,36 @@ looks good to me!
 as it'll try to build `list` `of` `attrs` `looks` `good` `to` `me!`.
 
 
-# Why did my build fail?
-
+# How does OfBorg call nix-build?
 
 Builds are run like:
 
-> HOME=/homeless-shelter NIX_PATH=nixpkgs=$(pwd) nix-build ./default.nix \
-> --no-out-link --keep-going -A hello \
-> --option restrict-eval true \
-> --option build-timeout 1800 \
+> HOME=/homeless-shelter NIX_PATH=nixpkgs=$(pwd) nix-build ./default.nix
+> --no-out-link --keep-going -A hello
+> --option restrict-eval true
+> --option build-timeout 1800
 > --argstr system thesystem
+> --show-trace
+
+# How does OfBorg call nix-instantiate?
+
+NixOS evals are run like:
+
+> HOME=/homeless-shelter NIX_PATH=nixpkgs=$(pwd) nix-instantiate ./nixos/release.nix
+> -A manual
+> --option restrict-eval true
+> --option build-timeout 1800
+> --argstr system thesystem
+> --show-trace
+
+Nixpkgs evals are run like:
+
+> HOME=/homeless-shelter NIX_PATH=nixpkgs=$(pwd) nix-instantiate ./pkgs/top-level/release.nix
+> -A manual
+> --option restrict-eval true
+> --option build-timeout 1800
+> --argstr system thesystem
+> --show-trace
 
 
 ---