summary refs log tree commit diff
path: root/doc/stdenv.xml
diff options
context:
space:
mode:
authorJohn Ericson <John.Ericson@Obsidian.Systems>2017-09-20 11:33:29 -0400
committerJohn Ericson <John.Ericson@Obsidian.Systems>2017-09-26 11:24:19 -0400
commitbc0aec5d974a6a3269aeb4cec582e51baa433853 (patch)
tree63decd432ccfc27d0d124f5f3a03ea72b2d5ece6 /doc/stdenv.xml
parent2d521567933718dee4f820efb3b41a2baaf08d02 (diff)
downloadnixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.tar
nixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.tar.gz
nixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.tar.bz2
nixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.tar.lz
nixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.tar.xz
nixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.tar.zst
nixlib-bc0aec5d974a6a3269aeb4cec582e51baa433853.zip
doc: Document forthcomming NIX_DEBUG degredations
Diffstat (limited to 'doc/stdenv.xml')
-rw-r--r--doc/stdenv.xml13
1 files changed, 7 insertions, 6 deletions
diff --git a/doc/stdenv.xml b/doc/stdenv.xml
index dac53bc2b800..a097762130a5 100644
--- a/doc/stdenv.xml
+++ b/doc/stdenv.xml
@@ -1,4 +1,3 @@
-
 <chapter xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xml:id="chap-stdenv">
@@ -188,11 +187,13 @@ genericBuild
 
   <varlistentry>
     <term><varname>NIX_DEBUG</varname></term>
-    <listitem><para>If set, <literal>stdenv</literal> will print some
-    debug information during the build.  In particular, the
-    <command>gcc</command> and <command>ld</command> wrapper scripts
-    will print out the complete command line passed to the wrapped
-    tools.</para></listitem>
+    <listitem><para>
+      A natural number indicating how much information to log.
+      If set to 1 or higher, <literal>stdenv</literal> will print moderate debug information during the build.
+      In particular, the <command>gcc</command> and <command>ld</command> wrapper scripts will print out the complete command line passed to the wrapped tools.
+      If set to 6 or higher, the <literal>stdenv</literal> setup script will be run with <literal>set -x</literal> tracing.
+      If set to 7 or higher, the <command>gcc</command> and <command>ld</command> wrapper scripts will also be run with <literal>set -x</literal> tracing.
+    </para></listitem>
   </varlistentry>
 
 </variablelist>