max/nix-super
1
0
Fork 0
mirror of https://github.com/privatevoid-net/nix-super.git synced 2024-11-26 07:46:21 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

clarify relation of tasks and plans

Browse source
This commit is contained in:
Valentin Gagarin 2022-05-12 12:30:28 +02:00
parent 2a8532fb61
commit 689b32a543
1 changed files with 9 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
doc/manual/src/architecture/architecture.md
View file

@ -13,21 +13,21 @@ Nix consists of hierarchical [layers](https://en.m.wikipedia.org/wiki/Multitier_
| evaluates | manages | evaluates | manages
V | V |
[ configuration language ] | [ configuration language ] |
| V
+-------------------------------|---------------------------------+
| store | |
| | evaluates to |
| | |
| referenced by V builds |
| [ build input ] --> [ build task ] --> [ build result ] |
| | | |
+-------------------------------|---------------------V-----------+
| store | evaluates to |
| .............................V............................... |
| : build plan : |
| : referenced by builds : |
| : [ build input ] --> [ build task ] --> [ build result ] : |
| :...........................................................: |
+-----------------------------------------------------------------+ +-----------------------------------------------------------------+
``` ```
At the top is the *command line interface*, translating from invocations of Nix executables to interactions with the underlying layers. At the top is the *command line interface*, translating from invocations of Nix executables to interactions with the underlying layers.
Below that is the *Nix language*, a [purely functional](https://en.m.wikipedia.org/wiki/Purely_functional_programming) configuration language. Below that is the *Nix language*, a [purely functional](https://en.m.wikipedia.org/wiki/Purely_functional_programming) configuration language.
It is used to compose expressions which ultimately evaluate to self-contained *build tasks*, used to derive *build results* from referenced *build inputs*. It is used to compose expressions which ultimately evaluate to self-contained *build plans*, made up *build tasks* used to derive *build results* from referenced *build inputs*.
::: {.note} ::: {.note}
The Nix language itself does not have a notion of *packages* or *configurations*. The Nix language itself does not have a notion of *packages* or *configurations*.
@ -40,4 +40,3 @@ The command line and Nix language are what users interact with most.
Underlying everything is the *Nix store*, a mechanism to keep track of build tasks, data, and references between them. Underlying everything is the *Nix store*, a mechanism to keep track of build tasks, data, and references between them.
It can also execute *build instructions*, captured in the build tasks, to produce new data. It can also execute *build instructions*, captured in the build tasks, to produce new data.
A series of build tasks is a *build plan*.