nixo
/
guix-devel
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

doc: Document references. 

Suggested by "pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian.de>.
Fixes <https://bugs.gnu.org/34574>.

* doc/guix.texi (Derivations): Document references.
This commit is contained in:
Ludovic Courtès 2019-03-08 11:47:00 +01:00
parent fb0aeaacea
commit 910aaa3b86
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 15 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/guix.texi
View File

@ -6238,8 +6238,11 @@ The outputs of the derivation---derivations produce at least one file or
directory in the store, but may produce more. directory in the store, but may produce more.
@item @item
The inputs of the derivations, which may be other derivations or plain @cindex build-time dependencies
files in the store (patches, build scripts, etc.) @cindex dependencies, build-time
The inputs of the derivations---i.e., its build-time dependencies---which may
be other derivations or plain files in the store (patches, build scripts,
etc.)
@item @item
The system type targeted by the derivation---e.g., @code{x86_64-linux}. The system type targeted by the derivation---e.g., @code{x86_64-linux}.
@ -6270,6 +6273,16 @@ of a fixed-output derivation are independent of its inputs---e.g., a
source code download produces the same result regardless of the download source code download produces the same result regardless of the download
method and tools being used. method and tools being used.
@cindex references
@cindex run-time dependencies
@cindex dependencies, run-time
The outputs of derivations---i.e., the build results---have a set of
@dfn{references}, as reported by the @code{references} RPC or the
@command{guix gc --references} command (@pxref{Invoking guix gc}). References
are the set of run-time dependencies of the build results. References are a
subset of the inputs of the derivation; this subset is automatically computed
by the build daemon by scanning all the files in the outputs.
The @code{(guix derivations)} module provides a representation of The @code{(guix derivations)} module provides a representation of
derivations as Scheme objects, along with procedures to create and derivations as Scheme objects, along with procedures to create and
otherwise manipulate derivations. The lowest-level primitive to create otherwise manipulate derivations. The lowest-level primitive to create