diff options
author | Ludovic Courtès <ludo@gnu.org> | 2017-12-21 22:12:00 +0100 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2017-12-22 08:56:50 +0100 |
commit | 8785bd7759df7ba9c199dcdf398edd922866e3df (patch) | |
tree | dbecc7d2da8e93b5dfdb5bd2d92bb0f9bff2f8cd /doc/guix.texi | |
parent | a468f897437acfc1c70987a6df252c4735e3bf2d (diff) | |
download | guix-8785bd7759df7ba9c199dcdf398edd922866e3df.tar guix-8785bd7759df7ba9c199dcdf398edd922866e3df.tar.gz |
doc: Document fixed-output derivations.
* doc/guix.texi (Derivations): Add paragraph on fixed-output
derivations.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r-- | doc/guix.texi | 8 |
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 |