Document the ARGUMENTS dictionary for command-line args.

git-svn-id: http://scons.tigris.org/svn/scons/trunk@309 fdb21ef1-2011-0410-befe-b5e4ea1792b1

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index 51ee464fe5f425dfe814d9bcab6a207856028037..29a6ed6fb671a41ccd46d89df79d0e830020d582 100644 (file)
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -179,8 +179,17 @@ may be specified on the command line:
 scons debug=1 .
 .EE
 
-These variables can be used in the configuration file(s) to modify
-the build in any way.
+These variables are available in SConscript files
+through the ARGUMENTS dictionary,
+and can be used in the configuration file(s) to modify
+the build in any way:
+
+.ES
+if ARGUMENTS.get('debug', 0):
+    env = Environment(CCFLAGS = '-g')
+else:
+    env = Environment()
+.EE
 
 .\" .B scons
 .\" can maintain a cache of target (derived) files that can