aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
authorValentin Gagarin <valentin.gagarin@tweag.io>2022-05-26 02:29:59 +0200
committerValentin Gagarin <valentin.gagarin@tweag.io>2022-08-04 12:37:47 +0200
commite72a7874dc59e7dd9783fb2783cfaf88806bf085 (patch)
treec239d921fd5f970e275e45fe8a71ab110199d18f /doc/manual
parentb6b112b366bed363f94231410946ad82122b317c (diff)
beautify rosetta table
while this may eventually introduce ugly diffs, the table will now render readably on the terminal (e.g. for `man nix` or `nix --help`) without further intervention.
Diffstat (limited to 'doc/manual')
-rw-r--r--doc/manual/src/architecture/store/store.md16
1 files changed, 8 insertions, 8 deletions
diff --git a/doc/manual/src/architecture/store/store.md b/doc/manual/src/architecture/store/store.md
index d710ca4c0..808e87581 100644
--- a/doc/manual/src/architecture/store/store.md
+++ b/doc/manual/src/architecture/store/store.md
@@ -24,14 +24,14 @@ Usage of terms is, for historic reasons, not entirely consistent within the Nix
The following translation table points out similarities and equivalent terms, to help clarify their meaning and inform consistent use in the future.
-generic build system | Nix | [Bazel][bazel] | [Build Systems à la Carte][bsalc] | programming language
--- | -- | -- | -- | --
-data (build input, build result) | store object | [artifact][bazel-artifact] | value | value
-build instructions | builder | ([depends on action type][bazel-actions]) | function | function
-build task | derivation | [action][bazel-action] | `Task` | [thunk][thunk]
-build plan | derivation graph | [action graph][bazel-action-graph], [build graph][bazel-build-graph] | `Tasks` | [call graph][call-graph]
-build | build | build | application of `Build` | evaluation
-persistence layer | store | [action cache][bazel-action-cache] | `Store` | heap
+| generic build system | Nix | [Bazel][bazel] | [Build Systems à la Carte][bsalc] | programming language |
+| -------------------------------- | ---------------- | -------------------------------------------------------------------- | --------------------------------- | ------------------------ |
+| data (build input, build result) | store object | [artifact][bazel-artifact] | value | value |
+| build instructions | builder | ([depends on action type][bazel-actions]) | function | function |
+| build task | derivation | [action][bazel-action] | `Task` | [thunk][thunk] |
+| build plan | derivation graph | [action graph][bazel-action-graph], [build graph][bazel-build-graph] | `Tasks` | [call graph][call-graph] |
+| build | build | build | application of `Build` | evaluation |
+| persistence layer | store | [action cache][bazel-action-cache] | `Store` | heap |
All of these systems share features of [declarative programming][declarative-programming] languages, a key insight first put forward by Eelco Dolstra et al. in [Imposing a Memory Management Discipline on Software Deployment][immdsd] (2004), elaborated in his PhD thesis [The Purely Functional Software Deployment Model][phd-thesis] (2006), and further refined by Andrey Mokhov et al. in [Build Systems à la Carte][bsalc] (2018).