aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
Diffstat (limited to 'doc/manual')
-rw-r--r--doc/manual/redirects.js4
-rw-r--r--doc/manual/src/contributing/hacking.md26
2 files changed, 16 insertions, 14 deletions
diff --git a/doc/manual/redirects.js b/doc/manual/redirects.js
index bddd56eb8..d75cd231a 100644
--- a/doc/manual/redirects.js
+++ b/doc/manual/redirects.js
@@ -344,6 +344,10 @@ const redirects = {
"macos": "uninstall.html#macos",
"uninstalling": "uninstall.html"
}
+ "contributing/hacking.html": {
+ "nix-with-flakes": "#building-nix-with-flakes"
+ "classic-nix": "#building-nix"
+ }
};
// the following code matches the current page's URL against the set of redirects.
diff --git a/doc/manual/src/contributing/hacking.md b/doc/manual/src/contributing/hacking.md
index c57d45138..6c6f2eb52 100644
--- a/doc/manual/src/contributing/hacking.md
+++ b/doc/manual/src/contributing/hacking.md
@@ -12,14 +12,15 @@ The following instructions assume you already have some version of Nix installed
[installation instructions]: ../installation/installation.md
-## Nix with flakes
+## Building Nix with flakes
-This section assumes you are using Nix with [flakes] enabled. See the [next section](#classic-nix) for equivalent instructions which don't require flakes.
+This section assumes you are using Nix with the [`flakes`] and [`nix-command`] experimental features enabled.
+See the [Building Nix](#building-nix) section for equivalent instructions using stable Nix interfaces.
-[flakes]: ../command-ref/new-cli/nix3-flake.md#description
+[`flakes`]: @docroot@/contributing/experimental-features.md#xp-feature-flakes
+[`nix-command`]: @docroot@/contributing/experimental-features.md#xp-nix-command
-To build all dependencies and start a shell in which all environment
-variables are set up so that those dependencies can be found:
+To build all dependencies and start a shell in which all environment variables are set up so that those dependencies can be found:
```console
$ nix develop
@@ -55,20 +56,17 @@ To install it in `$(pwd)/outputs` and test it:
nix (Nix) 2.12
```
-To build a release version of Nix:
+To build a release version of Nix for the current operating system and CPU architecture:
```console
$ nix build
```
-You can also build Nix for one of the [supported target platforms](#target-platforms).
+You can also build Nix for one of the [supported platforms](#platforms).
-## Classic Nix
+## Building Nix
-This section is for Nix without [flakes].
-
-To build all dependencies and start a shell in which all environment
-variables are set up so that those dependencies can be found:
+To build all dependencies and start a shell in which all environment variables are set up so that those dependencies can be found:
```console
$ nix-shell
@@ -102,13 +100,13 @@ To install it in `$(pwd)/outputs` and test it:
nix (Nix) 2.12
```
-To build Nix for the current operating system and CPU architecture use
+To build a release version of Nix for the current operating system and CPU architecture:
```console
$ nix-build
```
-You can also build Nix for one of the [supported target platforms](#target-platforms).
+You can also build Nix for one of the [supported platforms](#platforms).
## Platforms