lix/doc/manual/src
John Ericson 60b7121d2c Make the Derived Path family of types inductive for dynamic derivations
We want to be able to write down `foo.drv^bar.drv^baz`:
`foo.drv^bar.drv` is the dynamic derivation (since it is itself a
derivation output, `bar.drv` from `foo.drv`).

To that end, we create `Single{Derivation,BuiltPath}` types, that are
very similar except instead of having multiple outputs (in a set or
map), they have a single one. This is for everything to the left of the
rightmost `^`.

`NixStringContextElem` has an analogous change, and now can reuse
`SingleDerivedPath` at the top level. In fact, if we ever get rid of
`DrvDeep`, `NixStringContextElem` could be replaced with
`SingleDerivedPath` entirely!

Important note: some JSON formats have changed.

We already can *produce* dynamic derivations, but we can't refer to them
directly. Today, we can merely express building or example at the top
imperatively over time by building `foo.drv^bar.drv`, and then with a
second nix invocation doing `<result-from-first>^baz`, but this is not
declarative. The ethos of Nix of being able to write down the full plan
everything you want to do, and then execute than plan with a single
command, and for that we need the new inductive form of these types.

Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-08-10 00:08:32 -04:00
..
advanced-topics rewrap lines to use one line per sentence 2023-05-31 01:32:03 +02:00
architecture Add description for file system objects (#8500) 2023-06-18 23:45:08 -04:00
command-ref list moving parts of channels 2023-07-19 10:26:25 +02:00
contributing fix broken links (#8722) 2023-07-20 17:58:14 +02:00
figures Move figures 2020-07-24 12:58:31 +02:00
installation nix actually needs c++20 now 2023-06-10 13:56:05 +02:00
language Stabilize discard-references 2023-08-07 16:53:37 +02:00
package-management remove the Channels section 2023-07-19 09:39:04 +02:00
protocols Apply suggestions from code review 2023-06-16 16:48:37 +02:00
release-notes Make the Derived Path family of types inductive for dynamic derivations 2023-08-10 00:08:32 -04:00
glossary.md Add description for file system objects (#8500) 2023-06-18 23:45:08 -04:00
introduction.md Convert short nix options to long ones 2023-05-17 08:10:30 +01:00
quick-start.md Update doc/manual/src/quick-start.md 2023-02-19 20:00:02 -05:00
SUMMARY.md.in Release notes 2023-07-24 17:19:31 +02:00