Add support for SCONSFLAGS.

2 files changed, 41 insertions, 0 deletions

diff --git a/doc/man/main.sgml b/doc/man/main.sgml
index 5bac0f0..75abbd7 100644
--- a/doc/man/main.sgml
+++ b/doc/man/main.sgml
@@ -15,6 +15,7 @@
 
     <!ENTITY desc SYSTEM "desc.sgml">
     <!ENTITY options SYSTEM "options.sgml">
+    <!ENTITY variables SYSTEM "variables.sgml">
 ]>
 
 <refentry id="scons">
@@ -82,6 +83,11 @@
   </refsect1>
 
   <refsect1>
+    <title>Environment Variables</title>
+    &variables;
+  </refsect1>
+
+  <refsect1>
     <title>See Also</title>
     <para>
     </para>
diff --git a/doc/man/variables.sgml b/doc/man/variables.sgml
new file mode 100644
index 0000000..8d4e0c8
--- /dev/null
+++ b/doc/man/variables.sgml
@@ -0,0 +1,35 @@
+<!--
+
+  Copyright 2001 Steven Knight
+
+-- >
+
+<para>
+
+  &scons; supports the following environment variables to affect
+  its behavior:
+
+</para>
+
+<variablelist>
+
+  <varlistentry>
+    <term>
+      &SCONSFLAGS;
+    </term>
+    <listitem>
+      <para>
+
+        &SCons; reads and interprets command-line options from this
+        environment variable before interpreting the options actually
+        supplied on the command line.  Where there's a conflict, options
+        from the command line overrule options from the &SCONSFLAGS;
+        environment variable.  Unknown options and other errors in the
+        &SCONSFLAGS; variable are ignored with a warning, but do not
+        halt &SCons;.
+
+      </para>
+    </listitem>
+  </varlistentry>
+
+</variablelist>