mirror of
https://git.in.rschanz.org/ryan77627/guix.git
synced 2024-12-24 05:18:07 -05:00
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:
parent
fb0aeaacea
commit
910aaa3b86
1 changed files with 15 additions and 2 deletions
|
@ -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
|
||||||
|
|
Loading…
Reference in a new issue