From: Scott Worley <scottworley@scottworley.com>
Date: Fri, 20 May 2022 21:47:01 +0000 (-0700)
Subject: README: Explain what this is for
X-Git-Tag: v1.0.0
X-Git-Url: http://git.scottworley.com/nix-pin-deps/commitdiff_plain/b40df7e83263cad58e6c7c6ef417ecbfc37541d9?ds=inline

README: Explain what this is for
---

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..53067f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+nix-pin-deps: GC-anchor a Nix build's dependencies
+--------------------------------------------------
+
+When a Nix build fails for lack of disk space and a `nix-collect-garbage`
+is needed to make disk space available, `nix-collect-garbage` will
+unhelpfully delete the successfully-built dependencies of the derivation
+that failed because they are are not yet gc-anchored, because the
+build failed.
+
+This tool solves this problem:
+
+  `nix-pin-deps /nix/store/...-foo.drv foo-deps`
+
+will create gc-anchors in foo-deps/ for all of the dependencies of foo.drv
+that exist in the nix store, keeping partial build progress safe from
+`nix-collect-garbage`.