aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
authorJohn Chapman <thestar@fussycoder.id.au>2021-10-09 12:03:34 +1100
committerJohn Chapman <thestar@fussycoder.id.au>2021-10-09 12:03:34 +1100
commit4cff4130549abf65eb17242a373eb98953252895 (patch)
tree7e7fc292e40d2395d4e78aa1cf483af7b2ac1cba /doc/manual
parent01e9f046a8f8fafb4d084153d4b30dd3a8d7aef5 (diff)
Clarify that not all nix packages will use the default build phases
Diffstat (limited to 'doc/manual')
-rw-r--r--doc/manual/src/command-ref/nix-shell.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/manual/src/command-ref/nix-shell.md b/doc/manual/src/command-ref/nix-shell.md
index 72f6730f1..8bcad85e1 100644
--- a/doc/manual/src/command-ref/nix-shell.md
+++ b/doc/manual/src/command-ref/nix-shell.md
@@ -117,6 +117,12 @@ $ nix-shell '<nixpkgs>' -A pan
[nix-shell]$ ./pan/gui/pan
```
+Note: Other packages may override these phases (the unpackPhase,
+configurePhase, buildPhase, etc).
+For those, it may be required to do something like
+`eval "$configurePhase-configurePhase"` or `eval "$configurePhase"`
+depending on how that package's nix files have been written.
+
To clear the environment first, and do some additional automatic
initialisation of the interactive shell: