lix-releng-staging/doc/manual
John Ericson 44c8d83831 Create outputOf primop.
In the Nix language, given a drv path, we should be able to construct
another string referencing to one of its output. We can do this today
with `(import drvPath).output`, but this only works for derivations we
already have.

With dynamic derivations, however, that doesn't work well because the
`drvPath` isn't yet built: importing it like would need to trigger IFD,
when the whole point of this feature is to do "dynamic build graph"
without IFD!

Instead, what we want to do is create a placeholder value with the right
string context to refer to the output of the as-yet unbuilt derivation.
A new primop in the language, analogous to `builtins.placeholder` can be
used to create one. This will achieve all the right properties. The
placeholder machinery also will match out the `outPath` attribute for CA
derivations works.

In 60b7121d2c we added that type of
placeholder, and the derived path and string holder changes necessary to
support it. Then in the previous commit we cleaned up the code
(inspiration finally hit me!) to deduplicate the code and expose exactly
what we need. Now, we can wire up the primop trivally!

Part of RFC 92: dynamic derivations (tracking issue #6316)

Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
2023-08-14 09:37:37 -04:00
..
src Create outputOf primop. 2023-08-14 09:37:37 -04:00
theme doc/manual: don't need to copy highlight.js manually 2021-08-04 19:47:05 -07:00
anchors.jq doc: Port anchors preprocessor to jq script 2022-05-26 18:17:21 +02:00
book.toml manual: Check links 2023-01-10 22:30:41 +01:00
custom.css disallow selecting shell prompt in code samples 2022-12-05 11:01:46 +01:00
generate-builtin-constants.nix revert anchor prefix for builtin constants 2023-07-20 10:27:38 +02:00
generate-builtins.nix Automatically document builtin constants 2023-06-27 09:37:54 -04:00
generate-manpage.nix Add infra for experimental store implemenations 2023-08-02 15:46:38 -04:00
generate-xp-features-shortlist.nix Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
generate-xp-features.nix Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
local.mk Automatically document builtin constants 2023-06-27 09:37:54 -04:00
quote-literals.xsl Generate release notes again 2014-03-12 14:24:29 +01:00
redirects.js fix broken links 2023-07-19 11:01:48 +02:00
utils.nix Mark experimental configuration settings programmatically 2023-04-16 10:58:04 -04:00