aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/src/architecture/store/store.md11
1 files changed, 8 insertions, 3 deletions
diff --git a/doc/manual/src/architecture/store/store.md b/doc/manual/src/architecture/store/store.md
index 18d25ca4d..1640944ad 100644
--- a/doc/manual/src/architecture/store/store.md
+++ b/doc/manual/src/architecture/store/store.md
@@ -18,7 +18,7 @@ A Nix store can *add*, *retrieve*, and *delete* store objects.
It can *perform builds*, that is, create new store objects by transforming build inputs into build outputs, using instructions from the build tasks.
-As it keeps track of references, it can [garbage-collect](https://en.m.wikipedia.org/wiki/Garbage_collection_(computer_science)) unused store objects.
+As it keeps track of references, it can [garbage-collect][garbage-collection] unused store objects.
```haskell
add :: Store -> Data -> (Store, Reference)
@@ -30,9 +30,9 @@ build :: Store -> Reference -> Maybe (Store, Reference)
collectGarbage :: Store -> Store
```
-Store objects are [immutable](https://en.m.wikipedia.org/wiki/Immutable_object): once created, they do not change until they are deleted.
+Store objects are [immutable][immutable-object]: once created, they do not change until they are deleted.
-References are [opaque](https://en.m.wikipedia.org/wiki/Opaque_data_type), [unique identifiers](https://en.m.wikipedia.org/wiki/Unique_identifier):
+References are [opaque][opaque-data-type], [unique identifiers][unique-identifier]:
The only way to obtain references is by adding or building store objects.
A reference will always point to exactly one store object.
@@ -55,6 +55,11 @@ Garbage collection will delete all store objects that cannot be reached from any
<!-- more details in section on garbage collection, link to it once it exists -->
+[garbage-collection]: https://en.m.wikipedia.org/wiki/Garbage_collection_(computer_science)
+[immutable-object]: https://en.m.wikipedia.org/wiki/Immutable_object
+[opaque-data-type]: https://en.m.wikipedia.org/wiki/Opaque_data_type
+[unique-identifier]: https://en.m.wikipedia.org/wiki/Unique_identifier
+
## Files and Processes
Nix provides a mapping between its store model and the [Unix paradigm](https://en.m.wikipedia.org/wiki/Everything_is_a_file) that governs the interplay of [files and processes](https://en.m.wikipedia.org/wiki/File_descriptor).