diff options
author | Graham Christensen <graham@grahamc.com> | 2018-10-02 14:16:27 -0400 |
---|---|---|
committer | Graham Christensen <graham@grahamc.com> | 2018-10-02 14:16:27 -0400 |
commit | c3125498fd7d0398f50e2b53a9e274b7c1e2db67 (patch) | |
tree | d01d375f9a0b0ec7a0f0b2fcd0897a736e041b23 /doc/functions/shell.xml | |
parent | 507a63c88557f8afa06a3e507fe3d055fc55a815 (diff) | |
download | nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.tar nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.tar.gz nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.tar.bz2 nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.tar.lz nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.tar.xz nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.tar.zst nixlib-c3125498fd7d0398f50e2b53a9e274b7c1e2db67.zip |
shell functions: rewrite as xml
Diffstat (limited to 'doc/functions/shell.xml')
-rw-r--r-- | doc/functions/shell.xml | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/functions/shell.xml b/doc/functions/shell.xml new file mode 100644 index 000000000000..a8d2a30cb508 --- /dev/null +++ b/doc/functions/shell.xml @@ -0,0 +1,27 @@ +<section xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + xml:id="sec-pkgs-mkShell"> + <title>pkgs.mkShell</title> + + <para> + <function>pkgs.mkShell</function> is a special kind of derivation + that is only useful when using it combined with + <command>nix-shell</command>. It will in fact fail to instantiate + when invoked with <command>nix-build</command>. + </para> + + <section xml:id="sec-pkgs-mkShell-usage"> + <title>Usage</title> + + <programlisting><![CDATA[ +{ pkgs ? import <nixpkgs> {} }: +pkgs.mkShell { + # this will make all the build inputs from hello and gnutar + # available to the shell environment + inputsFrom = with pkgs; [ hello gnutar ]; + buildInputs = [ pkgs.gnumake ]; +} +]]></programlisting> + </section> +</section> |