commit adc5c9b83df203c9e425efe00f9a788ed3554c2d · pyrox.dev/nixpkgs

doc/default.nix

···

       50
       50
        
             useChapters = true;

     

       51
       51
        
           }

     

       52
       52
        
         + toDocbook {

     

       53
       53
       +
             inputFile = ./shell.md;

     

       54
       54
       +
             outputFile = "shell.xml";

     

       55
       55
       +
           }

     

       56
       56
       +
         + toDocbook {

     

       53
       57
        
             inputFile = ./languages-frameworks/python.md;

     

       54
       58
        
             outputFile = "./languages-frameworks/python.xml";

     

       55
       59
        
           }

+20

doc/shell.md

···

       1
       1
       +
       ---

     

       2
       2
       +
       title: stdenv.mkShell

     

       3
       3
       +
       author: zimbatm

     

       4
       4
       +
       date: 2017-10-30

     

       5
       5
       +
       ---

     

       6
       6
       +
       

     

       7
       7
       +
       stdenv.mkShell is a special kind of derivation that is only useful when using

     

       8
       8
       +
       it combined with nix-shell. It will in fact fail to instantiate when invoked

     

       9
       9
       +
       with nix-build.

     

       10
       10
       +
       

     

       11
       11
       +
       ## Usage

     

       12
       12
       +
       

     

       13
       13
       +
       ```nix

     

       14
       14
       +
       { pkgs ? import <nixpkgs> {} }:

     

       15
       15
       +
       pkgs.mkShell {

     

       16
       16
       +
         # this will make all the build inputs from hello and gnutar available to the shell environment

     

       17
       17
       +
         inputsFrom = with pkgs; [ hello gnutar ];

     

       18
       18
       +
         buildInputs = [ pkgs.gnumake ];

     

       19
       19
       +
       }

     

       20
       20
       +
       ```

+46

pkgs/build-support/mkshell/default.nix

···

       1
       1
       +
       { lib, stdenv }:

     

       2
       2
       +
       

     

       3
       3
       +
       # A special kind of derivation that is only meant to be consumed by the

     

       4
       4
       +
       # nix-shell.

     

       5
       5
       +
       {

     

       6
       6
       +
         inputsFrom ? [], # a list of derivations whose inputs will be made available to the environment

     

       7
       7
       +
         buildInputs ? [],

     

       8
       8
       +
         nativeBuildInputs ? [],

     

       9
       9
       +
         propagatedBuildInputs ? [],

     

       10
       10
       +
         propagatedNativeBuildInputs ? [],

     

       11
       11
       +
         ...

     

       12
       12
       +
       }@attrs:

     

       13
       13
       +
       let

     

       14
       14
       +
         mergeInputs = name:

     

       15
       15
       +
           let

     

       16
       16
       +
             op = item: sum: sum ++ item."${name}" or [];

     

       17
       17
       +
             nul = [];

     

       18
       18
       +
             list = [attrs] ++ inputsFrom;

     

       19
       19
       +
           in

     

       20
       20
       +
             lib.foldr op nul list;

     

       21
       21
       +
       

     

       22
       22
       +
         rest = builtins.removeAttrs attrs [

     

       23
       23
       +
           "inputsFrom"

     

       24
       24
       +
           "buildInputs"

     

       25
       25
       +
           "nativeBuildInputs"

     

       26
       26
       +
           "propagatedBuildInputs"

     

       27
       27
       +
           "propagatedNativeBuildInputs"

     

       28
       28
       +
         ];

     

       29
       29
       +
       in

     

       30
       30
       +
       

     

       31
       31
       +
       stdenv.mkDerivation ({

     

       32
       32
       +
         name = "nix-shell";

     

       33
       33
       +
         phases = ["nobuildPhase"];

     

       34
       34
       +
       

     

       35
       35
       +
         buildInputs = mergeInputs "buildInputs";

     

       36
       36
       +
         nativeBuildInputs = mergeInputs "nativeBuildInputs";

     

       37
       37
       +
         propagatedBuildInputs = mergeInputs "propagatedBuildInputs";

     

       38
       38
       +
         propagatedNativeBuildInputs = mergeInputs "propagatedNativeBuildInputs";

     

       39
       39
       +
       

     

       40
       40
       +
         nobuildPhase = ''

     

       41
       41
       +
           echo

     

       42
       42
       +
           echo "This derivation is not meant to be built, aborting";

     

       43
       43
       +
           echo

     

       44
       44
       +
           exit 1

     

       45
       45
       +
         '';

     

       46
       46
       +
       } // rest)

pkgs/top-level/all-packages.nix

···

       311
       311
        
             inherit kernel rootModules allowMissing;

     

       312
       312
        
           };

     

       313
       313
        
       

     

       314
       314
       +
         mkShell = callPackage ../build-supports/mkshell { };

     

       315
       315
       +
       

     

       314
       316
        
         nixBufferBuilders = import ../build-support/emacs/buffer.nix { inherit (pkgs) lib writeText; inherit (emacsPackagesNg) inherit-local; };

     

       315
       317
        
       

     

       316
       318
        
         pathsFromGraph = ../build-support/kernel/paths-from-graph.pl;