diff options
author | Alyssa Ross <hi@alyssa.is> | 2023-11-21 16:12:21 +0100 |
---|---|---|
committer | Alyssa Ross <hi@alyssa.is> | 2023-11-21 16:12:48 +0100 |
commit | 048a4cd441a59cbf89defb18bb45c9f0b4429b35 (patch) | |
tree | f8f5850ff05521ab82d65745894714a8796cbfb6 /doc/builders/special/mkshell.section.md | |
parent | 030c5028b07afcedce7c5956015c629486cc79d9 (diff) | |
parent | 4c2d05dd6435d449a3651a6dd314d9411b5f8146 (diff) | |
download | nixpkgs-rootfs.tar nixpkgs-rootfs.tar.gz nixpkgs-rootfs.tar.bz2 nixpkgs-rootfs.tar.lz nixpkgs-rootfs.tar.xz nixpkgs-rootfs.tar.zst nixpkgs-rootfs.zip |
Signed-off-by: Alyssa Ross <hi@alyssa.is>
Diffstat (limited to 'doc/builders/special/mkshell.section.md')
-rw-r--r-- | doc/builders/special/mkshell.section.md | 37 |
1 files changed, 0 insertions, 37 deletions
diff --git a/doc/builders/special/mkshell.section.md b/doc/builders/special/mkshell.section.md deleted file mode 100644 index 96d43535955..00000000000 --- a/doc/builders/special/mkshell.section.md +++ /dev/null @@ -1,37 +0,0 @@ -# pkgs.mkShell {#sec-pkgs-mkShell} - -`pkgs.mkShell` is a specialized `stdenv.mkDerivation` that removes some -repetition when using it with `nix-shell` (or `nix develop`). - -## Usage {#sec-pkgs-mkShell-usage} - -Here is a common usage example: - -```nix -{ pkgs ? import <nixpkgs> {} }: -pkgs.mkShell { - packages = [ pkgs.gnumake ]; - - inputsFrom = [ pkgs.hello pkgs.gnutar ]; - - shellHook = '' - export DEBUG=1 - ''; -} -``` - -## Attributes {#sec-pkgs-mkShell-attributes} - -* `name` (default: `nix-shell`). Set the name of the derivation. -* `packages` (default: `[]`). Add executable packages to the `nix-shell` environment. -* `inputsFrom` (default: `[]`). Add build dependencies of the listed derivations to the `nix-shell` environment. -* `shellHook` (default: `""`). Bash statements that are executed by `nix-shell`. - -... all the attributes of `stdenv.mkDerivation`. - -## Building the shell {#sec-pkgs-mkShell-building} - -This derivation output will contain a text file that contains a reference to -all the build inputs. This is useful in CI where we want to make sure that -every derivation, and its dependencies, build properly. Or when creating a GC -root so that the build dependencies don't get garbage-collected. |