diff options
author | Robert Hensing <robert@roberthensing.nl> | 2022-02-01 16:46:18 +0100 |
---|---|---|
committer | Robert Hensing <robert@roberthensing.nl> | 2022-02-01 16:46:18 +0100 |
commit | b08ee51cc7dc57e104698e446a45bbb8e962fe07 (patch) | |
tree | 27a7d2967f8269f42698ca632f0c044b961ae331 /doc | |
parent | efeefb2af1469a5d1f0ae7ca8f0dfd9bb87d5cfb (diff) |
stdenv.md: Remove off topic phase propaganda
Phases are cool, I get it, but the reader will enjoy it when they see it. And they'll see it sooner if they don't have to read about it.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/stdenv/stdenv.chapter.md | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/doc/stdenv/stdenv.chapter.md b/doc/stdenv/stdenv.chapter.md index 6d72bd0deb4f8..9c78539945fd5 100644 --- a/doc/stdenv/stdenv.chapter.md +++ b/doc/stdenv/stdenv.chapter.md @@ -319,7 +319,7 @@ For information about how to run the updates, execute `nix-shell maintainers/scr ## Phases {#sec-stdenv-phases} -The generic builder has a number of *phases*. Package builds are split into phases to make it easier to override specific parts of the build (e.g., unpacking the sources or installing the binaries). Furthermore, it allows a nicer presentation of build logs in the Nix build farm. +The generic builder has a number of *phases*. Package builds are split into phases to make it easier to override specific parts of the build (e.g., unpacking the sources or installing the binaries). Each phase can be overridden in its entirety either by setting the environment variable `namePhase` to a string containing some shell commands to be executed, or by redefining the shell function `namePhase`. The former is convenient to override a phase from the derivation, while the latter is convenient from a build script. However, typically one only wants to *add* some commands to a phase, e.g. by defining `postInstall` or `preFixup`, as skipping some of the default actions may have unexpected consequences. The default script for each phase is defined in the file `pkgs/stdenv/generic/setup.sh`. |