aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/command-ref/nix-shell.xml
diff options
context:
space:
mode:
authorSamuel Dionne-Riel <samuel@dionne-riel.com>2018-08-01 21:28:49 -0400
committerSamuel Dionne-Riel <samuel@dionne-riel.com>2018-08-02 08:21:30 -0400
commit438e02529dfb4b26603e2a06992df977cd80ecd9 (patch)
treec7545b9b40190ce2c60e12e536243db70d7b1edb /doc/manual/command-ref/nix-shell.xml
parentb27431b7cb918e6866f4bb4fa7ec6e23240cfeab (diff)
Allows selectively adding environment variables to pure shells.
Includes documentation and test.
Diffstat (limited to 'doc/manual/command-ref/nix-shell.xml')
-rw-r--r--doc/manual/command-ref/nix-shell.xml8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/manual/command-ref/nix-shell.xml b/doc/manual/command-ref/nix-shell.xml
index 62d026ac2..5c44c4a8f 100644
--- a/doc/manual/command-ref/nix-shell.xml
+++ b/doc/manual/command-ref/nix-shell.xml
@@ -32,6 +32,7 @@
<arg><option>--run</option> <replaceable>cmd</replaceable></arg>
<arg><option>--exclude</option> <replaceable>regexp</replaceable></arg>
<arg><option>--pure</option></arg>
+ <arg><option>--keep</option> <replaceable>name</replaceable></arg>
<group choice='req'>
<arg choice='plain'>
<group choice='req'>
@@ -165,6 +166,13 @@ also <xref linkend="sec-common-options" />.</phrase></para>
</listitem></varlistentry>
+ <varlistentry><term><option>--keep</option> <replaceable>name</replaceable></term>
+
+ <listitem><para>When a <option>--pure</option> shell is started,
+ keep the listed environment variables.</para></listitem>
+
+ </varlistentry>
+
</variablelist>
<para>The following common options are supported:</para>