aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2017-12-21 22:12:00 +0100
committerLudovic Courtès <ludo@gnu.org>2017-12-22 08:56:50 +0100
commit8785bd7759df7ba9c199dcdf398edd922866e3df (patch)
treedbecc7d2da8e93b5dfdb5bd2d92bb0f9bff2f8cd
parenta468f897437acfc1c70987a6df252c4735e3bf2d (diff)
downloadguix-8785bd7759df7ba9c199dcdf398edd922866e3df.tar.gz
guix-8785bd7759df7ba9c199dcdf398edd922866e3df.zip
doc: Document fixed-output derivations.
* doc/guix.texi (Derivations): Add paragraph on fixed-output derivations.
-rw-r--r--doc/guix.texi8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 6b6f8dedae..faad3ad6bb 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4210,6 +4210,14 @@ paths}. Derivations paths can be passed to the @code{build-derivations}
procedure to perform the build actions they prescribe (@pxref{The
Store}).
+@cindex fixed-output derivations
+Operations such as file downloads and version-control checkouts for
+which the expected content hash is known in advance are modeled as
+@dfn{fixed-output derivations}. Unlike regular derivations, the outputs
+of a fixed-output derivation are independent of its inputs---e.g., a
+source code download produces the same result regardless of the download
+method and tools being used.
+
The @code{(guix derivations)} module provides a representation of
derivations as Scheme objects, along with procedures to create and
otherwise manipulate derivations. The lowest-level primitive to create