aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authoreldritch horrors <pennae@lix.systems>2024-08-09 02:12:01 +0200
committereldritch horrors <pennae@lix.systems>2024-08-09 19:30:45 +0000
commit35a2f28a46613ad185b96d6e38c3f5d13bfc79b5 (patch)
tree0a28b6b92cdfabd0ab09de8b3095a3cd5d5412ac /doc
parent790d1079e1da414f730c9d03c4c8ecc4c40d5c4d (diff)
libstore: deprecate the build-hook setting
implementing a build hook is pretty much impossible without either being a nix, or blindly forwarding the important bits of all build requests to some kind of nix. we've found no uses of build-hook in the wild, and the build-hook protocol (apart from being entirely undocumented) is not able to convey any kind of versioning information between hook and daemon. if we want to upgrade this infrastructure (which we do), this must not stay Change-Id: I1ec4976a35adf8105b8ca9240b7984f8b91e147e
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/rl-next/deprecate-build-hook.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/manual/rl-next/deprecate-build-hook.md b/doc/manual/rl-next/deprecate-build-hook.md
new file mode 100644
index 000000000..30de1298d
--- /dev/null
+++ b/doc/manual/rl-next/deprecate-build-hook.md
@@ -0,0 +1,8 @@
+---
+synopsis: "The `build-hook` setting is now deprecated"
+category: Breaking Changes
+---
+
+Build hooks communicate with the daemon using a custom, internal, undocumented protocol that is entirely unversioned and cannot be changed.
+Since we intend to change it anyway we must unfortunately deprecate the current build hook infrastructure.
+We do not expect this to impact most users—we have not found any uses of `build-hook` in the wild—but if this does affect you, we'd like to hear from you!