about summary refs log tree commit diff
path: root/doc/manual/command-ref/nix-shell.xml
diff options
context:
space:
mode:
authorSamuel Dionne-Riel <samuel@dionne-riel.com>2018-08-02T01·28-0400
committerSamuel Dionne-Riel <samuel@dionne-riel.com>2018-08-02T12·21-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 62d026ac238e..5c44c4a8f446 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>