summaryrefslogtreecommitdiffstats
path: root/doc/generated/examples
diff options
context:
space:
mode:
authorDirk Baechle <dl9obn@darc.de>2013-05-03 22:37:44 (GMT)
committerDirk Baechle <dl9obn@darc.de>2013-05-03 22:37:44 (GMT)
commit1c43c95fd745a770ad7b0be5ead347c62a18e006 (patch)
treeefb533bcf689eeea1a957e4ae05720d4b7a9d215 /doc/generated/examples
parentf0c7dbb434dde7e6516d9e8bffa19aa10b7bf509 (diff)
downloadSCons-1c43c95fd745a770ad7b0be5ead347c62a18e006.zip
SCons-1c43c95fd745a770ad7b0be5ead347c62a18e006.tar.gz
SCons-1c43c95fd745a770ad7b0be5ead347c62a18e006.tar.bz2
- added default files in doc/generated/
Diffstat (limited to 'doc/generated/examples')
-rw-r--r--doc/generated/examples/EnumVariable_map_1.xml4
-rw-r--r--doc/generated/examples/addmethod_ex1_1.xml7
-rw-r--r--doc/generated/examples/addmethod_ex2_1.xml5
-rw-r--r--doc/generated/examples/addmethod_ex2_2.xml7
-rw-r--r--doc/generated/examples/alias_ex1_1.xml6
-rw-r--r--doc/generated/examples/alias_ex2_1.xml26
-rw-r--r--doc/generated/examples/buildersbuiltin_ex1_1.xml5
-rw-r--r--doc/generated/examples/buildersbuiltin_ex2_1.xml4
-rw-r--r--doc/generated/examples/buildersbuiltin_ex3_1.xml4
-rw-r--r--doc/generated/examples/buildersbuiltin_ex4_1.xml4
-rw-r--r--doc/generated/examples/buildersbuiltin_libs_1.xml6
-rw-r--r--doc/generated/examples/buildersbuiltin_libs_2.xml7
-rw-r--r--doc/generated/examples/builderscommands_ex1_1.xml4
-rw-r--r--doc/generated/examples/builderscommands_ex2_1.xml4
-rw-r--r--doc/generated/examples/builderswriting_MY_EMITTER_1.xml5
-rw-r--r--doc/generated/examples/builderswriting_ex1_1.xml4
-rw-r--r--doc/generated/examples/builderswriting_ex2_1.xml6
-rw-r--r--doc/generated/examples/builderswriting_ex3_1.xml6
-rw-r--r--doc/generated/examples/builderswriting_ex4_1.xml5
-rw-r--r--doc/generated/examples/builderswriting_ex5_1.xml4
-rw-r--r--doc/generated/examples/builderswriting_ex6_1.xml4
-rw-r--r--doc/generated/examples/builderswriting_ex7_1.xml4
-rw-r--r--doc/generated/examples/caching_ex-random_1.xml9
-rw-r--r--doc/generated/examples/caching_ex1_1.xml11
-rw-r--r--doc/generated/examples/caching_ex1_2.xml11
-rw-r--r--doc/generated/examples/caching_ex1_4.xml17
-rw-r--r--doc/generated/examples/caching_ex1_5.xml15
-rw-r--r--doc/generated/examples/commandline_ARGLIST_1.xml6
-rw-r--r--doc/generated/examples/commandline_ARGUMENTS_1.xml12
-rw-r--r--doc/generated/examples/commandline_AddOption_1.xml4
-rw-r--r--doc/generated/examples/commandline_AddOption_2.xml4
-rw-r--r--doc/generated/examples/commandline_BUILD_TARGETS_1_1.xml16
-rw-r--r--doc/generated/examples/commandline_BoolVariable_1.xml4
-rw-r--r--doc/generated/examples/commandline_BoolVariable_2.xml4
-rw-r--r--doc/generated/examples/commandline_BoolVariable_3.xml4
-rw-r--r--doc/generated/examples/commandline_BoolVariable_4.xml4
-rw-r--r--doc/generated/examples/commandline_BoolVariable_5.xml7
-rw-r--r--doc/generated/examples/commandline_COMMAND_LINE_TARGETS_1.xml9
-rw-r--r--doc/generated/examples/commandline_DEFAULT_TARGETS_1_1.xml10
-rw-r--r--doc/generated/examples/commandline_DEFAULT_TARGETS_2_1.xml13
-rw-r--r--doc/generated/examples/commandline_Default1_1.xml10
-rw-r--r--doc/generated/examples/commandline_Default1_2.xml7
-rw-r--r--doc/generated/examples/commandline_Default2_1.xml10
-rw-r--r--doc/generated/examples/commandline_Default3_1.xml12
-rw-r--r--doc/generated/examples/commandline_Default4_1.xml9
-rw-r--r--doc/generated/examples/commandline_EnumVariable_1.xml8
-rw-r--r--doc/generated/examples/commandline_EnumVariable_2.xml6
-rw-r--r--doc/generated/examples/commandline_EnumVariable_3.xml14
-rw-r--r--doc/generated/examples/commandline_EnumVariable_ic1_1.xml10
-rw-r--r--doc/generated/examples/commandline_EnumVariable_ic2_1.xml8
-rw-r--r--doc/generated/examples/commandline_ListVariable_1.xml6
-rw-r--r--doc/generated/examples/commandline_ListVariable_2.xml6
-rw-r--r--doc/generated/examples/commandline_ListVariable_3.xml7
-rw-r--r--doc/generated/examples/commandline_PackageVariable_1.xml10
-rw-r--r--doc/generated/examples/commandline_PathVariable_1.xml6
-rw-r--r--doc/generated/examples/commandline_PathVariable_2.xml6
-rw-r--r--doc/generated/examples/commandline_SCONSFLAGS_1.xml11
-rw-r--r--doc/generated/examples/commandline_SetOption_1.xml5
-rw-r--r--doc/generated/examples/commandline_SetOption_2.xml6
-rw-r--r--doc/generated/examples/commandline_SetOption_3.xml9
-rw-r--r--doc/generated/examples/commandline_UnknownVariables_1.xml4
-rw-r--r--doc/generated/examples/commandline_Variables1_1.xml6
-rw-r--r--doc/generated/examples/commandline_Variables_Help_1.xml9
-rw-r--r--doc/generated/examples/commandline_Variables_custom_py_1_1.xml6
-rw-r--r--doc/generated/examples/commandline_Variables_custom_py_1_custom.py3
-rw-r--r--doc/generated/examples/commandline_Variables_custom_py_2_1.xml6
-rw-r--r--doc/generated/examples/depends_AlwaysBuild_1.xml7
-rw-r--r--doc/generated/examples/depends_AlwaysBuild_2.xml7
-rw-r--r--doc/generated/examples/depends_Requires_1.xml20
-rw-r--r--doc/generated/examples/depends_ex1_1.xml7
-rw-r--r--doc/generated/examples/depends_ex1_2.xml7
-rw-r--r--doc/generated/examples/depends_ex1_3.xml8
-rw-r--r--doc/generated/examples/depends_ex1_4.xml9
-rw-r--r--doc/generated/examples/depends_ex1_5.xml9
-rw-r--r--doc/generated/examples/depends_ex1_6.xml7
-rw-r--r--doc/generated/examples/depends_ex1_7.xml7
-rw-r--r--doc/generated/examples/depends_ex1_8.xml7
-rw-r--r--doc/generated/examples/depends_ex5_1.xml5
-rw-r--r--doc/generated/examples/depends_ex5_2.xml6
-rw-r--r--doc/generated/examples/depends_ignore_explicit_1.xml9
-rw-r--r--doc/generated/examples/depends_include_1.xml11
-rw-r--r--doc/generated/examples/depends_include_SConstruct3
-rw-r--r--doc/generated/examples/depends_include_hello.h3
-rw-r--r--doc/generated/examples/depends_macroinc_1.xml8
-rw-r--r--doc/generated/examples/depends_match_1.xml7
-rw-r--r--doc/generated/examples/depends_mixing_1.xml11
-rw-r--r--doc/generated/examples/depends_newer_1.xml7
-rw-r--r--doc/generated/examples/depends_no-Requires_1.xml14
-rw-r--r--doc/generated/examples/depends_parsedep_1.xml8
-rw-r--r--doc/generated/examples/environments_Append-nonexistent_1.xml5
-rw-r--r--doc/generated/examples/environments_Prepend-nonexistent_1.xml5
-rw-r--r--doc/generated/examples/environments_Replace-nonexistent_1.xml5
-rw-r--r--doc/generated/examples/environments_Replace1_1.xml5
-rw-r--r--doc/generated/examples/environments_Replace2_1.xml13
-rw-r--r--doc/generated/examples/environments_ex1_1.xml5
-rw-r--r--doc/generated/examples/environments_ex2_1.xml7
-rw-r--r--doc/generated/examples/environments_ex3_1.xml6
-rw-r--r--doc/generated/examples/environments_ex4_1.xml7
-rw-r--r--doc/generated/examples/environments_ex5_1.xml9
-rw-r--r--doc/generated/examples/environments_ex6_1.xml5
-rw-r--r--doc/generated/examples/environments_ex6b_1.xml7
-rw-r--r--doc/generated/examples/environments_ex6b_2.xml7
-rw-r--r--doc/generated/examples/environments_ex8_1.xml5
-rw-r--r--doc/generated/examples/environments_ex9_1.xml5
-rw-r--r--doc/generated/examples/environments_missing1_1.xml5
-rw-r--r--doc/generated/examples/environments_missing2_1.xml6
-rw-r--r--doc/generated/examples/environments_missing3_1.xml5
-rw-r--r--doc/generated/examples/factories_Chmod_1.xml5
-rw-r--r--doc/generated/examples/factories_Copy1_1.xml4
-rw-r--r--doc/generated/examples/factories_Copy2_1.xml4
-rw-r--r--doc/generated/examples/factories_Copy3_1.xml6
-rw-r--r--doc/generated/examples/factories_Delete1_1.xml7
-rw-r--r--doc/generated/examples/factories_Delete2_1.xml5
-rw-r--r--doc/generated/examples/factories_Execute_1.xml9
-rw-r--r--doc/generated/examples/factories_Mkdir_1.xml9
-rw-r--r--doc/generated/examples/factories_Move_1.xml6
-rw-r--r--doc/generated/examples/factories_Touch_1.xml5
-rw-r--r--doc/generated/examples/fileremoval_clean-ex1_1.xml7
-rw-r--r--doc/generated/examples/fileremoval_noclean-ex1_1.xml15
-rw-r--r--doc/generated/examples/fileremoval_precious-ex1_1.xml7
-rw-r--r--doc/generated/examples/hierarchy_Return_1.xml7
-rw-r--r--doc/generated/examples/hierarchy_Return_foo_SConscript5
-rw-r--r--doc/generated/examples/hierarchy_ex1_1.xml11
-rw-r--r--doc/generated/examples/hierarchy_ex1_prog1_SConscript4
-rw-r--r--doc/generated/examples/hierarchy_ex1_prog2_SConscript4
-rw-r--r--doc/generated/examples/hierarchy_ex2_1.xml7
-rw-r--r--doc/generated/examples/hierarchy_ex3_1.xml7
-rw-r--r--doc/generated/examples/install_ex1_1.xml7
-rw-r--r--doc/generated/examples/install_ex2_1.xml7
-rw-r--r--doc/generated/examples/install_ex3_1.xml9
-rw-r--r--doc/generated/examples/install_ex4_1.xml6
-rw-r--r--doc/generated/examples/install_ex5_1.xml9
-rw-r--r--doc/generated/examples/java_JAVACLASSDIR_1.xml5
-rw-r--r--doc/generated/examples/java_RMIC_1.xml5
-rw-r--r--doc/generated/examples/java_jar1_1.xml5
-rw-r--r--doc/generated/examples/java_jar2_1.xml7
-rw-r--r--doc/generated/examples/java_java-classes_1.xml6
-rw-r--r--doc/generated/examples/java_java-classes_2.xml11
-rw-r--r--doc/generated/examples/java_java_1.xml4
-rw-r--r--doc/generated/examples/java_javah_1.xml5
-rw-r--r--doc/generated/examples/java_javah_file_1.xml5
-rw-r--r--doc/generated/examples/lesssimple_ex2_1.xml7
-rw-r--r--doc/generated/examples/lesssimple_ex3_1.xml7
-rw-r--r--doc/generated/examples/lesssimple_ex3_2.xml8
-rw-r--r--doc/generated/examples/lesssimple_ex4_1.xml8
-rw-r--r--doc/generated/examples/lesssimple_ex5_1.xml10
-rw-r--r--doc/generated/examples/lesssimple_target_1.xml5
-rw-r--r--doc/generated/examples/lesssimple_target_2.xml6
-rw-r--r--doc/generated/examples/libraries_SharedLibrary_1.xml7
-rw-r--r--doc/generated/examples/libraries_SharedLibrary_2.xml9
-rw-r--r--doc/generated/examples/libraries_ex1_1.xml8
-rw-r--r--doc/generated/examples/libraries_ex1_2.xml7
-rw-r--r--doc/generated/examples/libraries_ex2_1.xml10
-rw-r--r--doc/generated/examples/libraries_ex2_2.xml10
-rw-r--r--doc/generated/examples/libraries_ex3_1.xml5
-rw-r--r--doc/generated/examples/libraries_ex3_2.xml6
-rw-r--r--doc/generated/examples/libraries_objects_1.xml7
-rw-r--r--doc/generated/examples/mergeflags_MergeFlags1_1.xml5
-rw-r--r--doc/generated/examples/mergeflags_MergeFlags2_1.xml5
-rw-r--r--doc/generated/examples/mergeflags_MergeFlags3_1.xml6
-rw-r--r--doc/generated/examples/misc_Exit_1.xml7
-rw-r--r--doc/generated/examples/misc_FindFile1a_1.xml6
-rw-r--r--doc/generated/examples/misc_FindFile1b_1.xml8
-rw-r--r--doc/generated/examples/misc_FindFile1d_1.xml7
-rw-r--r--doc/generated/examples/misc_FindFile2_1.xml6
-rw-r--r--doc/generated/examples/misc_FindFile2_2.xml6
-rw-r--r--doc/generated/examples/misc_FindFile3_1.xml5
-rw-r--r--doc/generated/examples/misc_Flatten1_1.xml6
-rw-r--r--doc/generated/examples/misc_Flatten2_1.xml6
-rw-r--r--doc/generated/examples/nodes_GetBuildPath_1.xml5
-rw-r--r--doc/generated/examples/nodes_ex1_1.xml6
-rw-r--r--doc/generated/examples/nodes_ex1_2.xml7
-rw-r--r--doc/generated/examples/nodes_exists_1.xml6
-rw-r--r--doc/generated/examples/nodes_print_1.xml7
-rw-r--r--doc/generated/examples/nodes_print_2.xml8
-rw-r--r--doc/generated/examples/output_Progress-TARGET_1.xml15
-rw-r--r--doc/generated/examples/output_ex1_1.xml10
-rw-r--r--doc/generated/examples/output_ex2_1.xml11
-rw-r--r--doc/generated/examples/output_ex2_2.xml9
-rw-r--r--doc/generated/examples/output_gbf2_1.xml9
-rw-r--r--doc/generated/examples/parseflags_ex1_1.xml8
-rw-r--r--doc/generated/examples/parseflags_ex1_2.xml9
-rw-r--r--doc/generated/examples/parseflags_ex2_1.xml6
-rw-r--r--doc/generated/examples/parseflags_ex3_1.xml8
-rw-r--r--doc/generated/examples/parseflags_ex4_1.xml8
-rw-r--r--doc/generated/examples/repositories_CPPPATH3_1.xml5
-rw-r--r--doc/generated/examples/repositories_CPPPATH_1.xml5
-rw-r--r--doc/generated/examples/repositories_ex1_1.xml5
-rw-r--r--doc/generated/examples/repositories_ex2_1.xml5
-rw-r--r--doc/generated/examples/repositories_ex3_1.xml5
-rw-r--r--doc/generated/examples/repositories_ex4_1.xml8
-rw-r--r--doc/generated/examples/repositories_quote1_1.xml5
-rw-r--r--doc/generated/examples/separate_builddir_1.xml9
-rw-r--r--doc/generated/examples/separate_builddir_sconscript_1.xml9
-rw-r--r--doc/generated/examples/separate_builddir_sconscript_SConstruct4
-rw-r--r--doc/generated/examples/separate_duplicate0_1.xml9
-rw-r--r--doc/generated/examples/separate_ex1_1.xml9
-rw-r--r--doc/generated/examples/separate_glob_builddir_sconscript_1.xml10
-rw-r--r--doc/generated/examples/sideeffect_parallel_1.xml5
-rw-r--r--doc/generated/examples/sideeffect_shared_1.xml5
-rw-r--r--doc/generated/examples/sideeffect_simple_1.xml10
-rw-r--r--doc/generated/examples/simple_Object_1.xml8
-rw-r--r--doc/generated/examples/simple_Object_2.xml8
-rw-r--r--doc/generated/examples/simple_clean_1.xml16
-rw-r--r--doc/generated/examples/simple_clean_2.xml17
-rw-r--r--doc/generated/examples/simple_declarative_1.xml14
-rw-r--r--doc/generated/examples/simple_ex1_1.xml9
-rw-r--r--doc/generated/examples/simple_ex1_2.xml10
-rw-r--r--doc/generated/examples/simple_ex1_3.xml10
-rw-r--r--doc/generated/examples/simple_ex1_4.xml6
-rw-r--r--doc/generated/examples/simple_java_1.xml8
-rw-r--r--doc/generated/examples/sourcecode_bitkeeper_1.xml6
-rw-r--r--doc/generated/examples/sourcecode_cvs_1.xml6
-rw-r--r--doc/generated/examples/sourcecode_rcs_1.xml6
-rw-r--r--doc/generated/examples/sourcecode_sccs_1.xml6
-rw-r--r--doc/generated/examples/tasks_ex1_1.xml7
-rw-r--r--doc/generated/examples/tasks_ex1_main.cpp3
-rw-r--r--doc/generated/examples/troubleshoot_Dump_1.xml74
-rw-r--r--doc/generated/examples/troubleshoot_Dump_2.xml107
-rw-r--r--doc/generated/examples/troubleshoot_Dump_ENV_1.xml9
-rw-r--r--doc/generated/examples/troubleshoot_Dump_ENV_2.xml11
-rw-r--r--doc/generated/examples/troubleshoot_explain1_1.xml8
-rw-r--r--doc/generated/examples/troubleshoot_explain1_2.xml5
-rw-r--r--doc/generated/examples/troubleshoot_explain2_1.xml13
-rw-r--r--doc/generated/examples/troubleshoot_explain3_1.xml17
-rw-r--r--doc/generated/examples/troubleshoot_findlibs_1.xml14
-rw-r--r--doc/generated/examples/troubleshoot_stacktrace_1.xml4
-rw-r--r--doc/generated/examples/troubleshoot_stacktrace_2.xml13
-rw-r--r--doc/generated/examples/troubleshoot_taskmastertrace_1.xml63
-rw-r--r--doc/generated/examples/troubleshoot_tree1_1.xml32
-rw-r--r--doc/generated/examples/troubleshoot_tree1_2.xml7
-rw-r--r--doc/generated/examples/troubleshoot_tree1_3.xml11
-rw-r--r--doc/generated/examples/troubleshoot_tree1_4.xml43
-rw-r--r--doc/generated/examples/troubleshoot_tree1_5.xml15
-rw-r--r--doc/generated/examples/troubleshoot_tree1_6.xml26
-rw-r--r--doc/generated/examples/troubleshoot_tree2_1.xml73
-rw-r--r--doc/generated/examples/troubleshoot_tree2_2.xml45
-rw-r--r--doc/generated/examples/variants_ex_1.xml11
-rw-r--r--doc/generated/examples/variants_ex_2.xml11
239 files changed, 2200 insertions, 0 deletions
diff --git a/doc/generated/examples/EnumVariable_map_1.xml b/doc/generated/examples/EnumVariable_map_1.xml
new file mode 100644
index 0000000..2b10a0f
--- /dev/null
+++ b/doc/generated/examples/EnumVariable_map_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLOR=navy foo.o</userinput>
+cc -o foo.o -c -DCOLOR="blue" foo.c
+</screen>
diff --git a/doc/generated/examples/addmethod_ex1_1.xml b/doc/generated/examples/addmethod_ex1_1.xml
new file mode 100644
index 0000000..8d46cc5
--- /dev/null
+++ b/doc/generated/examples/addmethod_ex1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q /</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+Install file: "hello" as "/usr/bin/hello"
+Install file: "hello" as "install/bin/hello"
+</screen>
diff --git a/doc/generated/examples/addmethod_ex2_1.xml b/doc/generated/examples/addmethod_ex2_1.xml
new file mode 100644
index 0000000..08cf5b4
--- /dev/null
+++ b/doc/generated/examples/addmethod_ex2_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o test_stuff.o -c test_stuff.c
+cc -o tests/test_stuff test_stuff.o
+</screen>
diff --git a/doc/generated/examples/addmethod_ex2_2.xml b/doc/generated/examples/addmethod_ex2_2.xml
new file mode 100644
index 0000000..f7b2110
--- /dev/null
+++ b/doc/generated/examples/addmethod_ex2_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+rc /fores.res res.rc
+cl /Fotest_stuff.obj /c test_stuff.c /nologo
+link /nologo /OUT:tests\test_stuff.exe test_stuff.obj res.res
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/alias_ex1_1.xml b/doc/generated/examples/alias_ex1_1.xml
new file mode 100644
index 0000000..a250016
--- /dev/null
+++ b/doc/generated/examples/alias_ex1_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q install</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+Install file: "hello" as "/usr/bin/hello"
+</screen>
diff --git a/doc/generated/examples/alias_ex2_1.xml b/doc/generated/examples/alias_ex2_1.xml
new file mode 100644
index 0000000..e49ba93
--- /dev/null
+++ b/doc/generated/examples/alias_ex2_1.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q install-bin</userinput>
+cc -o foo.o -c foo.c
+cc -o foo foo.o
+Install file: "foo" as "/usr/bin/foo"
+% <userinput>scons -Q install-lib</userinput>
+cc -o bar.o -c bar.c
+ar rc libbar.a bar.o
+ranlib libbar.a
+Install file: "libbar.a" as "/usr/lib/libbar.a"
+% <userinput>scons -Q -c /</userinput>
+Removed foo.o
+Removed foo
+Removed /usr/bin/foo
+Removed bar.o
+Removed libbar.a
+Removed /usr/lib/libbar.a
+% <userinput>scons -Q install</userinput>
+cc -o foo.o -c foo.c
+cc -o foo foo.o
+Install file: "foo" as "/usr/bin/foo"
+cc -o bar.o -c bar.c
+ar rc libbar.a bar.o
+ranlib libbar.a
+Install file: "libbar.a" as "/usr/lib/libbar.a"
+</screen>
diff --git a/doc/generated/examples/buildersbuiltin_ex1_1.xml b/doc/generated/examples/buildersbuiltin_ex1_1.xml
new file mode 100644
index 0000000..d3d4a8f
--- /dev/null
+++ b/doc/generated/examples/buildersbuiltin_ex1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q .</userinput>
+tar -c -f out1.tar file1 file2
+tar -c -f out2.tar directory
+</screen>
diff --git a/doc/generated/examples/buildersbuiltin_ex2_1.xml b/doc/generated/examples/buildersbuiltin_ex2_1.xml
new file mode 100644
index 0000000..4afbe11
--- /dev/null
+++ b/doc/generated/examples/buildersbuiltin_ex2_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q .</userinput>
+tar -c -z -f out.tar.gz directory
+</screen>
diff --git a/doc/generated/examples/buildersbuiltin_ex3_1.xml b/doc/generated/examples/buildersbuiltin_ex3_1.xml
new file mode 100644
index 0000000..0d2937c
--- /dev/null
+++ b/doc/generated/examples/buildersbuiltin_ex3_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q .</userinput>
+tar -c -z -f out.tgz directory
+</screen>
diff --git a/doc/generated/examples/buildersbuiltin_ex4_1.xml b/doc/generated/examples/buildersbuiltin_ex4_1.xml
new file mode 100644
index 0000000..e9a170d
--- /dev/null
+++ b/doc/generated/examples/buildersbuiltin_ex4_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q .</userinput>
+zip(["out.zip"], ["file1", "file2"])
+</screen>
diff --git a/doc/generated/examples/buildersbuiltin_libs_1.xml b/doc/generated/examples/buildersbuiltin_libs_1.xml
new file mode 100644
index 0000000..031e551
--- /dev/null
+++ b/doc/generated/examples/buildersbuiltin_libs_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o goodbye.o -c goodbye.c
+cc -o hello.o -c hello.c
+cc -o hello hello.o goodbye.o -L/usr/dir1 -Ldir2 -lfoo1 -lfoo2
+</screen>
diff --git a/doc/generated/examples/buildersbuiltin_libs_2.xml b/doc/generated/examples/buildersbuiltin_libs_2.xml
new file mode 100644
index 0000000..5c3c1ea
--- /dev/null
+++ b/doc/generated/examples/buildersbuiltin_libs_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fogoodbye.obj /c goodbye.c /nologo
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:hello.exe /LIBPATH:\usr\dir1 /LIBPATH:dir2 foo1.lib foo2.lib hello.obj goodbye.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/builderscommands_ex1_1.xml b/doc/generated/examples/builderscommands_ex1_1.xml
new file mode 100644
index 0000000..32ab8b8
--- /dev/null
+++ b/doc/generated/examples/builderscommands_ex1_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+sed 's/x/y/' &lt; foo.in &gt; foo.out
+</screen>
diff --git a/doc/generated/examples/builderscommands_ex2_1.xml b/doc/generated/examples/builderscommands_ex2_1.xml
new file mode 100644
index 0000000..fbacb6c
--- /dev/null
+++ b/doc/generated/examples/builderscommands_ex2_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+build(["foo.out"], ["foo.in"])
+</screen>
diff --git a/doc/generated/examples/builderswriting_MY_EMITTER_1.xml b/doc/generated/examples/builderswriting_MY_EMITTER_1.xml
new file mode 100644
index 0000000..da454e8
--- /dev/null
+++ b/doc/generated/examples/builderswriting_MY_EMITTER_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+my_command file1.input modify1.in &gt; file1.foo
+my_command file2.input modify2.in &gt; file2.foo
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex1_1.xml b/doc/generated/examples/builderswriting_ex1_1.xml
new file mode 100644
index 0000000..879bb91
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex1_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+foobuild &lt; file.input &gt; file.foo
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex2_1.xml b/doc/generated/examples/builderswriting_ex2_1.xml
new file mode 100644
index 0000000..15f7a79
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex2_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+AttributeError: 'SConsEnvironment' object has no attribute 'Program':
+ File "/home/my/project/SConstruct", line 4:
+ env.Program('hello.c')
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex3_1.xml b/doc/generated/examples/builderswriting_ex3_1.xml
new file mode 100644
index 0000000..b4e2cf7
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex3_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+foobuild &lt; file.input &gt; file.foo
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex4_1.xml b/doc/generated/examples/builderswriting_ex4_1.xml
new file mode 100644
index 0000000..87563c2
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex4_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+foobuild &lt; file1.input &gt; file1.foo
+foobuild &lt; file2.input &gt; file2.foo
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex5_1.xml b/doc/generated/examples/builderswriting_ex5_1.xml
new file mode 100644
index 0000000..0131734
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex5_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+build_function(["file.foo"], ["file.input"])
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex6_1.xml b/doc/generated/examples/builderswriting_ex6_1.xml
new file mode 100644
index 0000000..879bb91
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex6_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+foobuild &lt; file.input &gt; file.foo
+</screen>
diff --git a/doc/generated/examples/builderswriting_ex7_1.xml b/doc/generated/examples/builderswriting_ex7_1.xml
new file mode 100644
index 0000000..34ef7e1
--- /dev/null
+++ b/doc/generated/examples/builderswriting_ex7_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+foobuild file.foo new_target - file.input new_source
+</screen>
diff --git a/doc/generated/examples/caching_ex-random_1.xml b/doc/generated/examples/caching_ex-random_1.xml
new file mode 100644
index 0000000..c70dcb6
--- /dev/null
+++ b/doc/generated/examples/caching_ex-random_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f2.o -c f2.c
+cc -o f5.o -c f5.c
+cc -o f4.o -c f4.c
+cc -o f3.o -c f3.c
+cc -o f1.o -c f1.c
+cc -o prog f1.o f2.o f3.o f4.o f5.o
+</screen>
diff --git a/doc/generated/examples/caching_ex1_1.xml b/doc/generated/examples/caching_ex1_1.xml
new file mode 100644
index 0000000..93ce35d
--- /dev/null
+++ b/doc/generated/examples/caching_ex1_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q -c</userinput>
+Removed hello.o
+Removed hello
+% <userinput>scons -Q</userinput>
+Retrieved `hello.o' from cache
+Retrieved `hello' from cache
+</screen>
diff --git a/doc/generated/examples/caching_ex1_2.xml b/doc/generated/examples/caching_ex1_2.xml
new file mode 100644
index 0000000..e975cf5
--- /dev/null
+++ b/doc/generated/examples/caching_ex1_2.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q -c</userinput>
+Removed hello.o
+Removed hello
+% <userinput>scons -Q --cache-show</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/caching_ex1_4.xml b/doc/generated/examples/caching_ex1_4.xml
new file mode 100644
index 0000000..bca1d53
--- /dev/null
+++ b/doc/generated/examples/caching_ex1_4.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q -c</userinput>
+Removed hello.o
+Removed hello
+% <userinput>scons -Q</userinput>
+Retrieved `hello.o' from cache
+Retrieved `hello' from cache
+% <userinput>scons -Q -c</userinput>
+Removed hello.o
+Removed hello
+% <userinput>scons -Q --cache-disable</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/caching_ex1_5.xml b/doc/generated/examples/caching_ex1_5.xml
new file mode 100644
index 0000000..0d7d00c
--- /dev/null
+++ b/doc/generated/examples/caching_ex1_5.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --cache-disable</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q -c</userinput>
+Removed hello.o
+Removed hello
+% <userinput>scons -Q --cache-disable</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q --cache-force</userinput>
+scons: `.' is up to date.
+% <userinput>scons -Q</userinput>
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/commandline_ARGLIST_1.xml b/doc/generated/examples/commandline_ARGLIST_1.xml
new file mode 100644
index 0000000..071b8a1
--- /dev/null
+++ b/doc/generated/examples/commandline_ARGLIST_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q define=FOO</userinput>
+cc -o prog.o -c -DFOO prog.c
+% <userinput>scons -Q define=FOO define=BAR</userinput>
+cc -o prog.o -c -DFOO -DBAR prog.c
+</screen>
diff --git a/doc/generated/examples/commandline_ARGUMENTS_1.xml b/doc/generated/examples/commandline_ARGUMENTS_1.xml
new file mode 100644
index 0000000..710fa57
--- /dev/null
+++ b/doc/generated/examples/commandline_ARGUMENTS_1.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q debug=0</userinput>
+cc -o prog.o -c prog.c
+cc -o prog prog.o
+% <userinput>scons -Q debug=0</userinput>
+scons: `.' is up to date.
+% <userinput>scons -Q debug=1</userinput>
+cc -o prog.o -c -g prog.c
+cc -o prog prog.o
+% <userinput>scons -Q debug=1</userinput>
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/commandline_AddOption_1.xml b/doc/generated/examples/commandline_AddOption_1.xml
new file mode 100644
index 0000000..302f247
--- /dev/null
+++ b/doc/generated/examples/commandline_AddOption_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q -n</userinput>
+Install file: "foo.in" as "/usr/bin/foo.in"
+</screen>
diff --git a/doc/generated/examples/commandline_AddOption_2.xml b/doc/generated/examples/commandline_AddOption_2.xml
new file mode 100644
index 0000000..640fb4e
--- /dev/null
+++ b/doc/generated/examples/commandline_AddOption_2.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q -n --prefix=/tmp/install</userinput>
+Install file: "foo.in" as "/tmp/install/usr/bin/foo.in"
+</screen>
diff --git a/doc/generated/examples/commandline_BUILD_TARGETS_1_1.xml b/doc/generated/examples/commandline_BUILD_TARGETS_1_1.xml
new file mode 100644
index 0000000..ac2674f
--- /dev/null
+++ b/doc/generated/examples/commandline_BUILD_TARGETS_1_1.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+BUILD_TARGETS is ['prog1']
+cc -o prog1.o -c prog1.c
+cc -o prog1 prog1.o
+% <userinput>scons -Q prog2</userinput>
+BUILD_TARGETS is ['prog2']
+cc -o prog2.o -c prog2.c
+cc -o prog2 prog2.o
+% <userinput>scons -Q -c .</userinput>
+BUILD_TARGETS is ['.']
+Removed prog1.o
+Removed prog1
+Removed prog2.o
+Removed prog2
+</screen>
diff --git a/doc/generated/examples/commandline_BoolVariable_1.xml b/doc/generated/examples/commandline_BoolVariable_1.xml
new file mode 100644
index 0000000..2c17325
--- /dev/null
+++ b/doc/generated/examples/commandline_BoolVariable_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q RELEASE=yes foo.o</userinput>
+cc -o foo.o -c -DRELEASE_BUILD=True foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_BoolVariable_2.xml b/doc/generated/examples/commandline_BoolVariable_2.xml
new file mode 100644
index 0000000..86bb6d9
--- /dev/null
+++ b/doc/generated/examples/commandline_BoolVariable_2.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q RELEASE=t foo.o</userinput>
+cc -o foo.o -c -DRELEASE_BUILD=True foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_BoolVariable_3.xml b/doc/generated/examples/commandline_BoolVariable_3.xml
new file mode 100644
index 0000000..f85dd56
--- /dev/null
+++ b/doc/generated/examples/commandline_BoolVariable_3.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q RELEASE=no foo.o</userinput>
+cc -o foo.o -c -DRELEASE_BUILD=False foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_BoolVariable_4.xml b/doc/generated/examples/commandline_BoolVariable_4.xml
new file mode 100644
index 0000000..2a7cb5f
--- /dev/null
+++ b/doc/generated/examples/commandline_BoolVariable_4.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q RELEASE=f foo.o</userinput>
+cc -o foo.o -c -DRELEASE_BUILD=False foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_BoolVariable_5.xml b/doc/generated/examples/commandline_BoolVariable_5.xml
new file mode 100644
index 0000000..387f5ca
--- /dev/null
+++ b/doc/generated/examples/commandline_BoolVariable_5.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q RELEASE=bad_value foo.o</userinput>
+
+scons: *** Error converting option: RELEASE
+Invalid value for boolean option: bad_value
+File "/home/my/project/SConstruct", line 4, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/commandline_COMMAND_LINE_TARGETS_1.xml b/doc/generated/examples/commandline_COMMAND_LINE_TARGETS_1.xml
new file mode 100644
index 0000000..646635e
--- /dev/null
+++ b/doc/generated/examples/commandline_COMMAND_LINE_TARGETS_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o foo.o -c foo.c
+cc -o foo foo.o
+% <userinput>scons -Q bar</userinput>
+Don't forget to copy `bar' to the archive!
+cc -o bar.o -c bar.c
+cc -o bar bar.o
+</screen>
diff --git a/doc/generated/examples/commandline_DEFAULT_TARGETS_1_1.xml b/doc/generated/examples/commandline_DEFAULT_TARGETS_1_1.xml
new file mode 100644
index 0000000..69a30cb
--- /dev/null
+++ b/doc/generated/examples/commandline_DEFAULT_TARGETS_1_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+DEFAULT_TARGETS is ['prog1']
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o prog1.o -c prog1.c
+cc -o prog1 prog1.o
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/commandline_DEFAULT_TARGETS_2_1.xml b/doc/generated/examples/commandline_DEFAULT_TARGETS_2_1.xml
new file mode 100644
index 0000000..1fd1bc7
--- /dev/null
+++ b/doc/generated/examples/commandline_DEFAULT_TARGETS_2_1.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+DEFAULT_TARGETS is now ['prog1']
+DEFAULT_TARGETS is now ['prog1', 'prog2']
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o prog1.o -c prog1.c
+cc -o prog1 prog1.o
+cc -o prog2.o -c prog2.c
+cc -o prog2 prog2.o
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/commandline_Default1_1.xml b/doc/generated/examples/commandline_Default1_1.xml
new file mode 100644
index 0000000..edc1812
--- /dev/null
+++ b/doc/generated/examples/commandline_Default1_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q</userinput>
+scons: `hello' is up to date.
+% <userinput>scons -Q goodbye</userinput>
+cc -o goodbye.o -c goodbye.c
+cc -o goodbye goodbye.o
+</screen>
diff --git a/doc/generated/examples/commandline_Default1_2.xml b/doc/generated/examples/commandline_Default1_2.xml
new file mode 100644
index 0000000..cb5907d
--- /dev/null
+++ b/doc/generated/examples/commandline_Default1_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q .</userinput>
+cc -o goodbye.o -c goodbye.c
+cc -o goodbye goodbye.o
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/commandline_Default2_1.xml b/doc/generated/examples/commandline_Default2_1.xml
new file mode 100644
index 0000000..1cf267a
--- /dev/null
+++ b/doc/generated/examples/commandline_Default2_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o prog1.o -c prog1.c
+cc -o prog1 prog1.o
+cc -o prog3.o -c prog3.c
+cc -o prog3 prog3.o
+% <userinput>scons -Q .</userinput>
+cc -o prog2.o -c prog2.c
+cc -o prog2 prog2.o
+</screen>
diff --git a/doc/generated/examples/commandline_Default3_1.xml b/doc/generated/examples/commandline_Default3_1.xml
new file mode 100644
index 0000000..5409437
--- /dev/null
+++ b/doc/generated/examples/commandline_Default3_1.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o prog1/foo.o -c prog1/foo.c
+cc -o prog1/main.o -c prog1/main.c
+cc -o prog1/main prog1/main.o prog1/foo.o
+% <userinput>scons -Q</userinput>
+scons: `prog1' is up to date.
+% <userinput>scons -Q .</userinput>
+cc -o prog2/bar.o -c prog2/bar.c
+cc -o prog2/main.o -c prog2/main.c
+cc -o prog2/main prog2/main.o prog2/bar.o
+</screen>
diff --git a/doc/generated/examples/commandline_Default4_1.xml b/doc/generated/examples/commandline_Default4_1.xml
new file mode 100644
index 0000000..81acde4
--- /dev/null
+++ b/doc/generated/examples/commandline_Default4_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+scons: *** No targets specified and no Default() targets found. Stop.
+% <userinput>scons -Q .</userinput>
+cc -o prog1.o -c prog1.c
+cc -o prog1 prog1.o
+cc -o prog2.o -c prog2.c
+cc -o prog2 prog2.o
+</screen>
diff --git a/doc/generated/examples/commandline_EnumVariable_1.xml b/doc/generated/examples/commandline_EnumVariable_1.xml
new file mode 100644
index 0000000..d1d4bed
--- /dev/null
+++ b/doc/generated/examples/commandline_EnumVariable_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLOR=red foo.o</userinput>
+cc -o foo.o -c -DCOLOR="red" foo.c
+% <userinput>scons -Q COLOR=blue foo.o</userinput>
+cc -o foo.o -c -DCOLOR="blue" foo.c
+% <userinput>scons -Q COLOR=green foo.o</userinput>
+cc -o foo.o -c -DCOLOR="green" foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_EnumVariable_2.xml b/doc/generated/examples/commandline_EnumVariable_2.xml
new file mode 100644
index 0000000..e3310ae
--- /dev/null
+++ b/doc/generated/examples/commandline_EnumVariable_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLOR=magenta foo.o</userinput>
+
+scons: *** Invalid value for option COLOR: magenta. Valid values are: ('red', 'green', 'blue')
+File "/home/my/project/SConstruct", line 5, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/commandline_EnumVariable_3.xml b/doc/generated/examples/commandline_EnumVariable_3.xml
new file mode 100644
index 0000000..a3928dc
--- /dev/null
+++ b/doc/generated/examples/commandline_EnumVariable_3.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLOR=Red foo.o</userinput>
+
+scons: *** Invalid value for option COLOR: Red. Valid values are: ('red', 'green', 'blue')
+File "/home/my/project/SConstruct", line 5, in &lt;module&gt;
+% <userinput>scons -Q COLOR=BLUE foo.o</userinput>
+
+scons: *** Invalid value for option COLOR: BLUE. Valid values are: ('red', 'green', 'blue')
+File "/home/my/project/SConstruct", line 5, in &lt;module&gt;
+% <userinput>scons -Q COLOR=nAvY foo.o</userinput>
+
+scons: *** Invalid value for option COLOR: nAvY. Valid values are: ('red', 'green', 'blue')
+File "/home/my/project/SConstruct", line 5, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/commandline_EnumVariable_ic1_1.xml b/doc/generated/examples/commandline_EnumVariable_ic1_1.xml
new file mode 100644
index 0000000..4e2a45a
--- /dev/null
+++ b/doc/generated/examples/commandline_EnumVariable_ic1_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLOR=Red foo.o</userinput>
+cc -o foo.o -c -DCOLOR="Red" foo.c
+% <userinput>scons -Q COLOR=BLUE foo.o</userinput>
+cc -o foo.o -c -DCOLOR="BLUE" foo.c
+% <userinput>scons -Q COLOR=nAvY foo.o</userinput>
+cc -o foo.o -c -DCOLOR="blue" foo.c
+% <userinput>scons -Q COLOR=green foo.o</userinput>
+cc -o foo.o -c -DCOLOR="green" foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_EnumVariable_ic2_1.xml b/doc/generated/examples/commandline_EnumVariable_ic2_1.xml
new file mode 100644
index 0000000..407419a
--- /dev/null
+++ b/doc/generated/examples/commandline_EnumVariable_ic2_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLOR=Red foo.o</userinput>
+cc -o foo.o -c -DCOLOR="red" foo.c
+% <userinput>scons -Q COLOR=nAvY foo.o</userinput>
+cc -o foo.o -c -DCOLOR="blue" foo.c
+% <userinput>scons -Q COLOR=GREEN foo.o</userinput>
+cc -o foo.o -c -DCOLOR="green" foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_ListVariable_1.xml b/doc/generated/examples/commandline_ListVariable_1.xml
new file mode 100644
index 0000000..48adb7d
--- /dev/null
+++ b/doc/generated/examples/commandline_ListVariable_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLORS=red,blue foo.o</userinput>
+cc -o foo.o -c -DCOLORS="red blue" foo.c
+% <userinput>scons -Q COLORS=blue,green,red foo.o</userinput>
+cc -o foo.o -c -DCOLORS="blue green red" foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_ListVariable_2.xml b/doc/generated/examples/commandline_ListVariable_2.xml
new file mode 100644
index 0000000..67f3361
--- /dev/null
+++ b/doc/generated/examples/commandline_ListVariable_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLORS=all foo.o</userinput>
+cc -o foo.o -c -DCOLORS="red green blue" foo.c
+% <userinput>scons -Q COLORS=none foo.o</userinput>
+cc -o foo.o -c -DCOLORS="" foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_ListVariable_3.xml b/doc/generated/examples/commandline_ListVariable_3.xml
new file mode 100644
index 0000000..f03f4fe
--- /dev/null
+++ b/doc/generated/examples/commandline_ListVariable_3.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q COLORS=magenta foo.o</userinput>
+
+scons: *** Error converting option: COLORS
+Invalid value(s) for option: magenta
+File "/home/my/project/SConstruct", line 5, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/commandline_PackageVariable_1.xml b/doc/generated/examples/commandline_PackageVariable_1.xml
new file mode 100644
index 0000000..03de914
--- /dev/null
+++ b/doc/generated/examples/commandline_PackageVariable_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q foo.o</userinput>
+cc -o foo.o -c -DPACKAGE="/opt/location" foo.c
+% <userinput>scons -Q PACKAGE=/usr/local/location foo.o</userinput>
+cc -o foo.o -c -DPACKAGE="/usr/local/location" foo.c
+% <userinput>scons -Q PACKAGE=yes foo.o</userinput>
+cc -o foo.o -c -DPACKAGE="True" foo.c
+% <userinput>scons -Q PACKAGE=no foo.o</userinput>
+cc -o foo.o -c -DPACKAGE="False" foo.c
+</screen>
diff --git a/doc/generated/examples/commandline_PathVariable_1.xml b/doc/generated/examples/commandline_PathVariable_1.xml
new file mode 100644
index 0000000..f80a299
--- /dev/null
+++ b/doc/generated/examples/commandline_PathVariable_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q foo.o</userinput>
+cc -o foo.o -c -DCONFIG_FILE="/etc/my_config" foo.c
+% <userinput>scons -Q CONFIG=/usr/local/etc/other_config foo.o</userinput>
+scons: `foo.o' is up to date.
+</screen>
diff --git a/doc/generated/examples/commandline_PathVariable_2.xml b/doc/generated/examples/commandline_PathVariable_2.xml
new file mode 100644
index 0000000..e24f8f2
--- /dev/null
+++ b/doc/generated/examples/commandline_PathVariable_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q CONFIG=/does/not/exist foo.o</userinput>
+
+scons: *** Path for option CONFIG does not exist: /does/not/exist
+File "/home/my/project/SConstruct", line 6, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/commandline_SCONSFLAGS_1.xml b/doc/generated/examples/commandline_SCONSFLAGS_1.xml
new file mode 100644
index 0000000..4261677
--- /dev/null
+++ b/doc/generated/examples/commandline_SCONSFLAGS_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+ ... [build output] ...
+scons: done building targets.
+% <userinput>export SCONSFLAGS="-Q"</userinput>
+% <userinput>scons</userinput>
+ ... [build output] ...
+</screen>
diff --git a/doc/generated/examples/commandline_SetOption_1.xml b/doc/generated/examples/commandline_SetOption_1.xml
new file mode 100644
index 0000000..c3b878e
--- /dev/null
+++ b/doc/generated/examples/commandline_SetOption_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+running with -j 2
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/commandline_SetOption_2.xml b/doc/generated/examples/commandline_SetOption_2.xml
new file mode 100644
index 0000000..d7bbf30
--- /dev/null
+++ b/doc/generated/examples/commandline_SetOption_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>export NUM_CPU="4"</userinput>
+% <userinput>scons -Q</userinput>
+running with -j 4
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/commandline_SetOption_3.xml b/doc/generated/examples/commandline_SetOption_3.xml
new file mode 100644
index 0000000..f4ca2f1
--- /dev/null
+++ b/doc/generated/examples/commandline_SetOption_3.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q -j 7</userinput>
+running with -j 7
+scons: `.' is up to date.
+% <userinput>export NUM_CPU="4"</userinput>
+% <userinput>scons -Q -j 3</userinput>
+running with -j 3
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/commandline_UnknownVariables_1.xml b/doc/generated/examples/commandline_UnknownVariables_1.xml
new file mode 100644
index 0000000..c6880d6
--- /dev/null
+++ b/doc/generated/examples/commandline_UnknownVariables_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q NOT_KNOWN=foo</userinput>
+Unknown variables: ['NOT_KNOWN']
+</screen>
diff --git a/doc/generated/examples/commandline_Variables1_1.xml b/doc/generated/examples/commandline_Variables1_1.xml
new file mode 100644
index 0000000..22754a3
--- /dev/null
+++ b/doc/generated/examples/commandline_Variables1_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q RELEASE=1</userinput>
+cc -o bar.o -c -DRELEASE_BUILD=1 bar.c
+cc -o foo.o -c -DRELEASE_BUILD=1 foo.c
+cc -o foo foo.o bar.o
+</screen>
diff --git a/doc/generated/examples/commandline_Variables_Help_1.xml b/doc/generated/examples/commandline_Variables_Help_1.xml
new file mode 100644
index 0000000..0134479
--- /dev/null
+++ b/doc/generated/examples/commandline_Variables_Help_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q -h</userinput>
+
+RELEASE: Set to 1 to build for release
+ default: 0
+ actual: 0
+
+Use scons -H for help about command-line options.
+</screen>
diff --git a/doc/generated/examples/commandline_Variables_custom_py_1_1.xml b/doc/generated/examples/commandline_Variables_custom_py_1_1.xml
new file mode 100644
index 0000000..77d3564
--- /dev/null
+++ b/doc/generated/examples/commandline_Variables_custom_py_1_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o bar.o -c -DRELEASE_BUILD=1 bar.c
+cc -o foo.o -c -DRELEASE_BUILD=1 foo.c
+cc -o foo foo.o bar.o
+</screen>
diff --git a/doc/generated/examples/commandline_Variables_custom_py_1_custom.py b/doc/generated/examples/commandline_Variables_custom_py_1_custom.py
new file mode 100644
index 0000000..f2acb0d
--- /dev/null
+++ b/doc/generated/examples/commandline_Variables_custom_py_1_custom.py
@@ -0,0 +1,3 @@
+
+ RELEASE = 1
+
diff --git a/doc/generated/examples/commandline_Variables_custom_py_2_1.xml b/doc/generated/examples/commandline_Variables_custom_py_2_1.xml
new file mode 100644
index 0000000..7ab5d74
--- /dev/null
+++ b/doc/generated/examples/commandline_Variables_custom_py_2_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o bar.o -c -DRELEASE_BUILD=0 bar.c
+cc -o foo.o -c -DRELEASE_BUILD=0 foo.c
+cc -o foo foo.o bar.o
+</screen>
diff --git a/doc/generated/examples/depends_AlwaysBuild_1.xml b/doc/generated/examples/depends_AlwaysBuild_1.xml
new file mode 100644
index 0000000..534c297
--- /dev/null
+++ b/doc/generated/examples/depends_AlwaysBuild_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q</userinput>
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/depends_AlwaysBuild_2.xml b/doc/generated/examples/depends_AlwaysBuild_2.xml
new file mode 100644
index 0000000..9a7325f
--- /dev/null
+++ b/doc/generated/examples/depends_AlwaysBuild_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello.o</userinput>
+scons: `hello.o' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_Requires_1.xml b/doc/generated/examples/depends_Requires_1.xml
new file mode 100644
index 0000000..50b2f56
--- /dev/null
+++ b/doc/generated/examples/depends_Requires_1.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o version.o -c version.c
+cc -o hello.o -c hello.c
+cc -o hello version.o hello.o
+% <userinput>sleep 1</userinput>
+% <userinput>scons -Q hello</userinput>
+cc -o version.o -c version.c
+scons: `hello' is up to date.
+% <userinput>sleep 1</userinput>
+% [CHANGE THE CONTENTS OF hello.c]
+% <userinput>scons -Q hello</userinput>
+cc -o version.o -c version.c
+cc -o hello.o -c hello.c
+cc -o hello version.o hello.o
+% <userinput>sleep 1</userinput>
+% <userinput>scons -Q hello</userinput>
+cc -o version.o -c version.c
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_1.xml b/doc/generated/examples/depends_ex1_1.xml
new file mode 100644
index 0000000..f9b35dd
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q</userinput>
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_2.xml b/doc/generated/examples/depends_ex1_2.xml
new file mode 100644
index 0000000..254f641
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_3.xml b/doc/generated/examples/depends_ex1_3.xml
new file mode 100644
index 0000000..a4cf4e3
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_3.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>touch hello.c</userinput>
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_4.xml b/doc/generated/examples/depends_ex1_4.xml
new file mode 100644
index 0000000..7e1f860
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_4.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% [CHANGE THE CONTENTS OF hello.c]
+% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/depends_ex1_5.xml b/doc/generated/examples/depends_ex1_5.xml
new file mode 100644
index 0000000..abbe64e
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_5.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% [CHANGE A COMMENT IN hello.c]
+% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_6.xml b/doc/generated/examples/depends_ex1_6.xml
new file mode 100644
index 0000000..75e1f80
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_6.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --implicit-cache hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_7.xml b/doc/generated/examples/depends_ex1_7.xml
new file mode 100644
index 0000000..2b7e30a
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_7.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --implicit-deps-changed hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex1_8.xml b/doc/generated/examples/depends_ex1_8.xml
new file mode 100644
index 0000000..957707d
--- /dev/null
+++ b/doc/generated/examples/depends_ex1_8.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --implicit-deps-unchanged hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_ex5_1.xml b/doc/generated/examples/depends_ex5_1.xml
new file mode 100644
index 0000000..2d1f868
--- /dev/null
+++ b/doc/generated/examples/depends_ex5_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c -Iinclude -I/home/project/inc hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/depends_ex5_2.xml b/doc/generated/examples/depends_ex5_2.xml
new file mode 100644
index 0000000..57da64f
--- /dev/null
+++ b/doc/generated/examples/depends_ex5_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q hello.exe</userinput>
+cl /Fohello.obj /c hello.c /nologo /Iinclude /I\home\project\inc
+link /nologo /OUT:hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/depends_ignore_explicit_1.xml b/doc/generated/examples/depends_ignore_explicit_1.xml
new file mode 100644
index 0000000..2607131
--- /dev/null
+++ b/doc/generated/examples/depends_ignore_explicit_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+scons: `.' is up to date.
+% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_include_1.xml b/doc/generated/examples/depends_include_1.xml
new file mode 100644
index 0000000..6f63e9a
--- /dev/null
+++ b/doc/generated/examples/depends_include_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c -I. hello.c
+cc -o hello hello.o
+% <userinput>scons -Q hello</userinput>
+scons: `hello' is up to date.
+% [CHANGE THE CONTENTS OF hello.h]
+% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c -I. hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/depends_include_SConstruct b/doc/generated/examples/depends_include_SConstruct
new file mode 100644
index 0000000..5f6d7f5
--- /dev/null
+++ b/doc/generated/examples/depends_include_SConstruct
@@ -0,0 +1,3 @@
+
+ Program('hello.c', CPPPATH = '.')
+
diff --git a/doc/generated/examples/depends_include_hello.h b/doc/generated/examples/depends_include_hello.h
new file mode 100644
index 0000000..c9046b3
--- /dev/null
+++ b/doc/generated/examples/depends_include_hello.h
@@ -0,0 +1,3 @@
+
+ #define string "world"
+
diff --git a/doc/generated/examples/depends_macroinc_1.xml b/doc/generated/examples/depends_macroinc_1.xml
new file mode 100644
index 0000000..8f211cc
--- /dev/null
+++ b/doc/generated/examples/depends_macroinc_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c -I. hello.c
+cc -o hello hello.o
+% [CHANGE CONTENTS OF foo.h]
+% <userinput>scons -Q</userinput>
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/depends_match_1.xml b/doc/generated/examples/depends_match_1.xml
new file mode 100644
index 0000000..c024b2a
--- /dev/null
+++ b/doc/generated/examples/depends_match_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello.o</userinput>
+cc -o hello.o -c hello.c
+% <userinput>touch -t 198901010000 hello.c</userinput>
+% <userinput>scons -Q hello.o</userinput>
+cc -o hello.o -c hello.c
+</screen>
diff --git a/doc/generated/examples/depends_mixing_1.xml b/doc/generated/examples/depends_mixing_1.xml
new file mode 100644
index 0000000..10152b2
--- /dev/null
+++ b/doc/generated/examples/depends_mixing_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o program1.o -c -I. program1.c
+cc -o prog-MD5 program1.o
+cc -o program2.o -c -I. program2.c
+cc -o prog-timestamp program2.o
+% <userinput>touch inc.h</userinput>
+% <userinput>scons -Q</userinput>
+cc -o program2.o -c -I. program2.c
+cc -o prog-timestamp program2.o
+</screen>
diff --git a/doc/generated/examples/depends_newer_1.xml b/doc/generated/examples/depends_newer_1.xml
new file mode 100644
index 0000000..9f13c31
--- /dev/null
+++ b/doc/generated/examples/depends_newer_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello.o</userinput>
+cc -o hello.o -c hello.c
+% <userinput>touch hello.c</userinput>
+% <userinput>scons -Q hello.o</userinput>
+cc -o hello.o -c hello.c
+</screen>
diff --git a/doc/generated/examples/depends_no-Requires_1.xml b/doc/generated/examples/depends_no-Requires_1.xml
new file mode 100644
index 0000000..5e9bb00
--- /dev/null
+++ b/doc/generated/examples/depends_no-Requires_1.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q hello</userinput>
+cc -o hello.o -c hello.c
+cc -o version.o -c version.c
+cc -o hello hello.o version.o
+% <userinput>sleep 1</userinput>
+% <userinput>scons -Q hello</userinput>
+cc -o version.o -c version.c
+cc -o hello hello.o version.o
+% <userinput>sleep 1</userinput>
+% <userinput>scons -Q hello</userinput>
+cc -o version.o -c version.c
+cc -o hello hello.o version.o
+</screen>
diff --git a/doc/generated/examples/depends_parsedep_1.xml b/doc/generated/examples/depends_parsedep_1.xml
new file mode 100644
index 0000000..585e89c
--- /dev/null
+++ b/doc/generated/examples/depends_parsedep_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c -MD -MF hello.d -I. hello.c
+cc -o hello hello.o
+% [CHANGE CONTENTS OF foo.h]
+% <userinput>scons -Q</userinput>
+cc -o hello.o -c -MD -MF hello.d -I. hello.c
+</screen>
diff --git a/doc/generated/examples/environments_Append-nonexistent_1.xml b/doc/generated/examples/environments_Append-nonexistent_1.xml
new file mode 100644
index 0000000..6597dd4
--- /dev/null
+++ b/doc/generated/examples/environments_Append-nonexistent_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+NEW_VARIABLE = added
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_Prepend-nonexistent_1.xml b/doc/generated/examples/environments_Prepend-nonexistent_1.xml
new file mode 100644
index 0000000..6597dd4
--- /dev/null
+++ b/doc/generated/examples/environments_Prepend-nonexistent_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+NEW_VARIABLE = added
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_Replace-nonexistent_1.xml b/doc/generated/examples/environments_Replace-nonexistent_1.xml
new file mode 100644
index 0000000..eb8b95c
--- /dev/null
+++ b/doc/generated/examples/environments_Replace-nonexistent_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+NEW_VARIABLE = xyzzy
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_Replace1_1.xml b/doc/generated/examples/environments_Replace1_1.xml
new file mode 100644
index 0000000..372d6ae
--- /dev/null
+++ b/doc/generated/examples/environments_Replace1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o foo.o -c -DDEFINE2 foo.c
+cc -o foo foo.o
+</screen>
diff --git a/doc/generated/examples/environments_Replace2_1.xml b/doc/generated/examples/environments_Replace2_1.xml
new file mode 100644
index 0000000..fe949ef
--- /dev/null
+++ b/doc/generated/examples/environments_Replace2_1.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+CCFLAGS = -DDEFINE1
+CCFLAGS = -DDEFINE2
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o bar.o -c -DDEFINE2 bar.c
+cc -o bar bar.o
+cc -o foo.o -c -DDEFINE2 foo.c
+cc -o foo foo.o
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/environments_ex1_1.xml b/doc/generated/examples/environments_ex1_1.xml
new file mode 100644
index 0000000..28bc8ca
--- /dev/null
+++ b/doc/generated/examples/environments_ex1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+gcc -o foo.o -c -O2 foo.c
+gcc -o foo foo.o
+</screen>
diff --git a/doc/generated/examples/environments_ex2_1.xml b/doc/generated/examples/environments_ex2_1.xml
new file mode 100644
index 0000000..248cd28
--- /dev/null
+++ b/doc/generated/examples/environments_ex2_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o bar.o -c -g bar.c
+cc -o bar bar.o
+cc -o foo.o -c -O2 foo.c
+cc -o foo foo.o
+</screen>
diff --git a/doc/generated/examples/environments_ex3_1.xml b/doc/generated/examples/environments_ex3_1.xml
new file mode 100644
index 0000000..1c2d620
--- /dev/null
+++ b/doc/generated/examples/environments_ex3_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+
+scons: *** Two environments with different actions were specified for the same target: foo.o
+File "/home/my/project/SConstruct", line 6, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/environments_ex4_1.xml b/doc/generated/examples/environments_ex4_1.xml
new file mode 100644
index 0000000..69ac649
--- /dev/null
+++ b/doc/generated/examples/environments_ex4_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o foo-dbg.o -c -g foo.c
+cc -o foo-dbg foo-dbg.o
+cc -o foo-opt.o -c -O2 foo.c
+cc -o foo-opt foo-opt.o
+</screen>
diff --git a/doc/generated/examples/environments_ex5_1.xml b/doc/generated/examples/environments_ex5_1.xml
new file mode 100644
index 0000000..d50f349
--- /dev/null
+++ b/doc/generated/examples/environments_ex5_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+gcc -o foo.o -c foo.c
+gcc -o foo foo.o
+gcc -o foo-dbg.o -c -g foo.c
+gcc -o foo-dbg foo-dbg.o
+gcc -o foo-opt.o -c -O2 foo.c
+gcc -o foo-opt foo-opt.o
+</screen>
diff --git a/doc/generated/examples/environments_ex6_1.xml b/doc/generated/examples/environments_ex6_1.xml
new file mode 100644
index 0000000..bef56a3
--- /dev/null
+++ b/doc/generated/examples/environments_ex6_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+CC is: cc
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_ex6b_1.xml b/doc/generated/examples/environments_ex6b_1.xml
new file mode 100644
index 0000000..dbcc502
--- /dev/null
+++ b/doc/generated/examples/environments_ex6b_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+key = OBJSUFFIX, value = .o
+key = LIBSUFFIX, value = .a
+key = PROGSUFFIX, value =
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_ex6b_2.xml b/doc/generated/examples/environments_ex6b_2.xml
new file mode 100644
index 0000000..f6fb554
--- /dev/null
+++ b/doc/generated/examples/environments_ex6b_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+key = OBJSUFFIX, value = .obj
+key = LIBSUFFIX, value = .lib
+key = PROGSUFFIX, value = .exe
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_ex8_1.xml b/doc/generated/examples/environments_ex8_1.xml
new file mode 100644
index 0000000..1749195
--- /dev/null
+++ b/doc/generated/examples/environments_ex8_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o foo.o -c -DMY_VALUE -DLAST foo.c
+cc -o foo foo.o
+</screen>
diff --git a/doc/generated/examples/environments_ex9_1.xml b/doc/generated/examples/environments_ex9_1.xml
new file mode 100644
index 0000000..aebefcc
--- /dev/null
+++ b/doc/generated/examples/environments_ex9_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o foo.o -c -DFIRST -DMY_VALUE foo.c
+cc -o foo foo.o
+</screen>
diff --git a/doc/generated/examples/environments_missing1_1.xml b/doc/generated/examples/environments_missing1_1.xml
new file mode 100644
index 0000000..d58b27b
--- /dev/null
+++ b/doc/generated/examples/environments_missing1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+value is: -&gt;&lt;-
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/environments_missing2_1.xml b/doc/generated/examples/environments_missing2_1.xml
new file mode 100644
index 0000000..911ecd2
--- /dev/null
+++ b/doc/generated/examples/environments_missing2_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+value is:
+scons: *** NameError `MISSING' trying to evaluate `$MISSING'
+File "/home/my/project/SConstruct", line 3, in &lt;module&gt;
+</screen>
diff --git a/doc/generated/examples/environments_missing3_1.xml b/doc/generated/examples/environments_missing3_1.xml
new file mode 100644
index 0000000..d58b27b
--- /dev/null
+++ b/doc/generated/examples/environments_missing3_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+value is: -&gt;&lt;-
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/factories_Chmod_1.xml b/doc/generated/examples/factories_Chmod_1.xml
new file mode 100644
index 0000000..59bccf5
--- /dev/null
+++ b/doc/generated/examples/factories_Chmod_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Copy("file.out", "file.in")
+Chmod("file.out", 0755)
+</screen>
diff --git a/doc/generated/examples/factories_Copy1_1.xml b/doc/generated/examples/factories_Copy1_1.xml
new file mode 100644
index 0000000..c0be7f8
--- /dev/null
+++ b/doc/generated/examples/factories_Copy1_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Copy("file.out", "file.in")
+</screen>
diff --git a/doc/generated/examples/factories_Copy2_1.xml b/doc/generated/examples/factories_Copy2_1.xml
new file mode 100644
index 0000000..c0be7f8
--- /dev/null
+++ b/doc/generated/examples/factories_Copy2_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Copy("file.out", "file.in")
+</screen>
diff --git a/doc/generated/examples/factories_Copy3_1.xml b/doc/generated/examples/factories_Copy3_1.xml
new file mode 100644
index 0000000..20702c8
--- /dev/null
+++ b/doc/generated/examples/factories_Copy3_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Copy("tempfile", "file.in")
+modify tempfile
+Copy("file.out", "tempfile")
+</screen>
diff --git a/doc/generated/examples/factories_Delete1_1.xml b/doc/generated/examples/factories_Delete1_1.xml
new file mode 100644
index 0000000..5cfde55
--- /dev/null
+++ b/doc/generated/examples/factories_Delete1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Delete("tempfile")
+Copy("tempfile", "file.in")
+modify tempfile
+Copy("file.out", "tempfile")
+</screen>
diff --git a/doc/generated/examples/factories_Delete2_1.xml b/doc/generated/examples/factories_Delete2_1.xml
new file mode 100644
index 0000000..3bdb3f1
--- /dev/null
+++ b/doc/generated/examples/factories_Delete2_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Delete("file.out")
+Copy("file.out", "file.in")
+</screen>
diff --git a/doc/generated/examples/factories_Execute_1.xml b/doc/generated/examples/factories_Execute_1.xml
new file mode 100644
index 0000000..1956439
--- /dev/null
+++ b/doc/generated/examples/factories_Execute_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+Mkdir("/tmp/my_temp_directory")
+scons: done reading SConscript files.
+scons: Building targets ...
+scons: `.' is up to date.
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/factories_Mkdir_1.xml b/doc/generated/examples/factories_Mkdir_1.xml
new file mode 100644
index 0000000..ae58dac
--- /dev/null
+++ b/doc/generated/examples/factories_Mkdir_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Delete("tempdir")
+Mkdir("tempdir")
+Copy("tempdir/file.in", "file.in")
+process tempdir
+Move("file.out", "tempdir/output_file")
+scons: *** [file.out] tempdir/output_file: No such file or directory
+</screen>
diff --git a/doc/generated/examples/factories_Move_1.xml b/doc/generated/examples/factories_Move_1.xml
new file mode 100644
index 0000000..2bd008d
--- /dev/null
+++ b/doc/generated/examples/factories_Move_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Copy("tempfile", "file.in")
+modify tempfile
+Move("file.out", "tempfile")
+</screen>
diff --git a/doc/generated/examples/factories_Touch_1.xml b/doc/generated/examples/factories_Touch_1.xml
new file mode 100644
index 0000000..aacde9e
--- /dev/null
+++ b/doc/generated/examples/factories_Touch_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Copy("file.out", "file.in")
+Touch("file.out")
+</screen>
diff --git a/doc/generated/examples/fileremoval_clean-ex1_1.xml b/doc/generated/examples/fileremoval_clean-ex1_1.xml
new file mode 100644
index 0000000..bb09707
--- /dev/null
+++ b/doc/generated/examples/fileremoval_clean-ex1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+build -o foo.out foo.in
+% <userinput>scons -Q -c</userinput>
+Removed foo.out
+Removed foo.log
+</screen>
diff --git a/doc/generated/examples/fileremoval_noclean-ex1_1.xml b/doc/generated/examples/fileremoval_noclean-ex1_1.xml
new file mode 100644
index 0000000..ab36c3f
--- /dev/null
+++ b/doc/generated/examples/fileremoval_noclean-ex1_1.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f1.o -c f1.c
+cc -o f2.o -c f2.c
+cc -o f3.o -c f3.c
+ar rc libfoo.a f1.o f2.o f3.o
+% <userinput>scons -c</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Cleaning targets ...
+Removed f1.o
+Removed f2.o
+Removed f3.o
+scons: done cleaning targets.
+</screen>
diff --git a/doc/generated/examples/fileremoval_precious-ex1_1.xml b/doc/generated/examples/fileremoval_precious-ex1_1.xml
new file mode 100644
index 0000000..e8227e6
--- /dev/null
+++ b/doc/generated/examples/fileremoval_precious-ex1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f1.o -c f1.c
+cc -o f2.o -c f2.c
+cc -o f3.o -c f3.c
+ar rc libfoo.a f1.o f2.o f3.o
+</screen>
diff --git a/doc/generated/examples/hierarchy_Return_1.xml b/doc/generated/examples/hierarchy_Return_1.xml
new file mode 100644
index 0000000..64b981a
--- /dev/null
+++ b/doc/generated/examples/hierarchy_Return_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o bar/bar.o -c bar/bar.c
+cc -o foo/foo.o -c foo/foo.c
+ar rc libprog.a foo/foo.o bar/bar.o
+ranlib libprog.a
+</screen>
diff --git a/doc/generated/examples/hierarchy_Return_foo_SConscript b/doc/generated/examples/hierarchy_Return_foo_SConscript
new file mode 100644
index 0000000..5d74264
--- /dev/null
+++ b/doc/generated/examples/hierarchy_Return_foo_SConscript
@@ -0,0 +1,5 @@
+
+ Import('env')
+ obj = env.Object('foo.c')
+ Return('obj')
+
diff --git a/doc/generated/examples/hierarchy_ex1_1.xml b/doc/generated/examples/hierarchy_ex1_1.xml
new file mode 100644
index 0000000..50beb93
--- /dev/null
+++ b/doc/generated/examples/hierarchy_ex1_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o prog1/foo1.o -c prog1/foo1.c
+cc -o prog1/foo2.o -c prog1/foo2.c
+cc -o prog1/main.o -c prog1/main.c
+cc -o prog1/prog1 prog1/main.o prog1/foo1.o prog1/foo2.o
+cc -o prog2/bar1.o -c prog2/bar1.c
+cc -o prog2/bar2.o -c prog2/bar2.c
+cc -o prog2/main.o -c prog2/main.c
+cc -o prog2/prog2 prog2/main.o prog2/bar1.o prog2/bar2.o
+</screen>
diff --git a/doc/generated/examples/hierarchy_ex1_prog1_SConscript b/doc/generated/examples/hierarchy_ex1_prog1_SConscript
new file mode 100644
index 0000000..425f1b8
--- /dev/null
+++ b/doc/generated/examples/hierarchy_ex1_prog1_SConscript
@@ -0,0 +1,4 @@
+
+ env = Environment()
+ env.Program('prog1', ['main.c', 'foo1.c', 'foo2.c'])
+
diff --git a/doc/generated/examples/hierarchy_ex1_prog2_SConscript b/doc/generated/examples/hierarchy_ex1_prog2_SConscript
new file mode 100644
index 0000000..fb529b4
--- /dev/null
+++ b/doc/generated/examples/hierarchy_ex1_prog2_SConscript
@@ -0,0 +1,4 @@
+
+ env = Environment()
+ env.Program('prog2', ['main.c', 'bar1.c', 'bar2.c'])
+
diff --git a/doc/generated/examples/hierarchy_ex2_1.xml b/doc/generated/examples/hierarchy_ex2_1.xml
new file mode 100644
index 0000000..1f781f8
--- /dev/null
+++ b/doc/generated/examples/hierarchy_ex2_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o lib/foo1.o -c lib/foo1.c
+cc -o src/prog/foo2.o -c src/prog/foo2.c
+cc -o src/prog/main.o -c src/prog/main.c
+cc -o src/prog/prog src/prog/main.o lib/foo1.o src/prog/foo2.o
+</screen>
diff --git a/doc/generated/examples/hierarchy_ex3_1.xml b/doc/generated/examples/hierarchy_ex3_1.xml
new file mode 100644
index 0000000..cb5a0ce
--- /dev/null
+++ b/doc/generated/examples/hierarchy_ex3_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o src/prog/foo2.o -c src/prog/foo2.c
+cc -o src/prog/main.o -c src/prog/main.c
+cc -o /usr/joe/lib/foo1.o -c /usr/joe/lib/foo1.c
+cc -o src/prog/prog src/prog/main.o /usr/joe/lib/foo1.o src/prog/foo2.o
+</screen>
diff --git a/doc/generated/examples/install_ex1_1.xml b/doc/generated/examples/install_ex1_1.xml
new file mode 100644
index 0000000..69a9f28
--- /dev/null
+++ b/doc/generated/examples/install_ex1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q /usr/bin</userinput>
+Install file: "hello" as "/usr/bin/hello"
+</screen>
diff --git a/doc/generated/examples/install_ex2_1.xml b/doc/generated/examples/install_ex2_1.xml
new file mode 100644
index 0000000..66caba3
--- /dev/null
+++ b/doc/generated/examples/install_ex2_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+% <userinput>scons -Q install</userinput>
+Install file: "hello" as "/usr/bin/hello"
+</screen>
diff --git a/doc/generated/examples/install_ex3_1.xml b/doc/generated/examples/install_ex3_1.xml
new file mode 100644
index 0000000..5e79808
--- /dev/null
+++ b/doc/generated/examples/install_ex3_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q install</userinput>
+cc -o goodbye.o -c goodbye.c
+cc -o goodbye goodbye.o
+Install file: "goodbye" as "/usr/bin/goodbye"
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+Install file: "hello" as "/usr/bin/hello"
+</screen>
diff --git a/doc/generated/examples/install_ex4_1.xml b/doc/generated/examples/install_ex4_1.xml
new file mode 100644
index 0000000..277ab7a
--- /dev/null
+++ b/doc/generated/examples/install_ex4_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q install</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+Install file: "hello" as "/usr/bin/hello-new"
+</screen>
diff --git a/doc/generated/examples/install_ex5_1.xml b/doc/generated/examples/install_ex5_1.xml
new file mode 100644
index 0000000..9cfc178
--- /dev/null
+++ b/doc/generated/examples/install_ex5_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q install</userinput>
+cc -o goodbye.o -c goodbye.c
+cc -o goodbye goodbye.o
+Install file: "goodbye" as "/usr/bin/goodbye-new"
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+Install file: "hello" as "/usr/bin/hello-new"
+</screen>
diff --git a/doc/generated/examples/java_JAVACLASSDIR_1.xml b/doc/generated/examples/java_JAVACLASSDIR_1.xml
new file mode 100644
index 0000000..e87345e
--- /dev/null
+++ b/doc/generated/examples/java_JAVACLASSDIR_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src/pkg/sub src/pkg/sub/Example1.java src/pkg/sub/Example2.java src/pkg/sub/Example3.java
+javah -d native -classpath classes pkg.sub.Example1 pkg.sub.Example2 pkg.sub.Example3
+</screen>
diff --git a/doc/generated/examples/java_RMIC_1.xml b/doc/generated/examples/java_RMIC_1.xml
new file mode 100644
index 0000000..be8c953
--- /dev/null
+++ b/doc/generated/examples/java_RMIC_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src/pkg/sub src/pkg/sub/Example1.java src/pkg/sub/Example2.java
+rmic -d outdir -classpath classes pkg.sub.Example1 pkg.sub.Example2
+</screen>
diff --git a/doc/generated/examples/java_jar1_1.xml b/doc/generated/examples/java_jar1_1.xml
new file mode 100644
index 0000000..6f5afa0
--- /dev/null
+++ b/doc/generated/examples/java_jar1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src src/Example1.java src/Example2.java src/Example3.java
+jar cf test.jar classes
+</screen>
diff --git a/doc/generated/examples/java_jar2_1.xml b/doc/generated/examples/java_jar2_1.xml
new file mode 100644
index 0000000..70e161b
--- /dev/null
+++ b/doc/generated/examples/java_jar2_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath prog1 prog1/Example1.java prog1/Example2.java
+javac -d classes -sourcepath prog2 prog2/Example3.java prog2/Example4.java
+jar cf prog1.jar -C classes Example1.class -C classes Example2.class
+jar cf prog2.jar -C classes Example3.class -C classes Example4.class
+</screen>
diff --git a/doc/generated/examples/java_java-classes_1.xml b/doc/generated/examples/java_java-classes_1.xml
new file mode 100644
index 0000000..2ebc85c
--- /dev/null
+++ b/doc/generated/examples/java_java-classes_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src src/Example1.java src/Example2.java src/Example3.java
+% <userinput>scons -Q classes</userinput>
+scons: `classes' is up to date.
+</screen>
diff --git a/doc/generated/examples/java_java-classes_2.xml b/doc/generated/examples/java_java-classes_2.xml
new file mode 100644
index 0000000..9a24f70
--- /dev/null
+++ b/doc/generated/examples/java_java-classes_2.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src src/Example1.java src/Example2.java src/Example3.java
+% <userinput>scons -Q -c classes</userinput>
+Removed classes/Example1.class
+Removed classes/AdditionalClass1.class
+Removed classes/Example2$Inner2.class
+Removed classes/Example2.class
+Removed classes/Example3.class
+Removed classes/AdditionalClass3.class
+</screen>
diff --git a/doc/generated/examples/java_java_1.xml b/doc/generated/examples/java_java_1.xml
new file mode 100644
index 0000000..a6e69c1
--- /dev/null
+++ b/doc/generated/examples/java_java_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src src/Example1.java src/Example2.java src/Example3.java
+</screen>
diff --git a/doc/generated/examples/java_javah_1.xml b/doc/generated/examples/java_javah_1.xml
new file mode 100644
index 0000000..e87345e
--- /dev/null
+++ b/doc/generated/examples/java_javah_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src/pkg/sub src/pkg/sub/Example1.java src/pkg/sub/Example2.java src/pkg/sub/Example3.java
+javah -d native -classpath classes pkg.sub.Example1 pkg.sub.Example2 pkg.sub.Example3
+</screen>
diff --git a/doc/generated/examples/java_javah_file_1.xml b/doc/generated/examples/java_javah_file_1.xml
new file mode 100644
index 0000000..a0e74d5
--- /dev/null
+++ b/doc/generated/examples/java_javah_file_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+javac -d classes -sourcepath src/pkg/sub src/pkg/sub/Example1.java src/pkg/sub/Example2.java src/pkg/sub/Example3.java
+javah -o native.h -classpath classes pkg.sub.Example1 pkg.sub.Example2 pkg.sub.Example3
+</screen>
diff --git a/doc/generated/examples/lesssimple_ex2_1.xml b/doc/generated/examples/lesssimple_ex2_1.xml
new file mode 100644
index 0000000..834f88c
--- /dev/null
+++ b/doc/generated/examples/lesssimple_ex2_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o file1.o -c file1.c
+cc -o file2.o -c file2.c
+cc -o prog.o -c prog.c
+cc -o prog prog.o file1.o file2.o
+</screen>
diff --git a/doc/generated/examples/lesssimple_ex3_1.xml b/doc/generated/examples/lesssimple_ex3_1.xml
new file mode 100644
index 0000000..415205b
--- /dev/null
+++ b/doc/generated/examples/lesssimple_ex3_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o file1.o -c file1.c
+cc -o file2.o -c file2.c
+cc -o prog.o -c prog.c
+cc -o program prog.o file1.o file2.o
+</screen>
diff --git a/doc/generated/examples/lesssimple_ex3_2.xml b/doc/generated/examples/lesssimple_ex3_2.xml
new file mode 100644
index 0000000..2eee32b
--- /dev/null
+++ b/doc/generated/examples/lesssimple_ex3_2.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fofile1.obj /c file1.c /nologo
+cl /Fofile2.obj /c file2.c /nologo
+cl /Foprog.obj /c prog.c /nologo
+link /nologo /OUT:program.exe prog.obj file1.obj file2.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/lesssimple_ex4_1.xml b/doc/generated/examples/lesssimple_ex4_1.xml
new file mode 100644
index 0000000..4d9267e
--- /dev/null
+++ b/doc/generated/examples/lesssimple_ex4_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o bar1.o -c bar1.c
+cc -o bar2.o -c bar2.c
+cc -o bar bar1.o bar2.o
+cc -o foo.o -c foo.c
+cc -o foo foo.o
+</screen>
diff --git a/doc/generated/examples/lesssimple_ex5_1.xml b/doc/generated/examples/lesssimple_ex5_1.xml
new file mode 100644
index 0000000..e1c35d4
--- /dev/null
+++ b/doc/generated/examples/lesssimple_ex5_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o bar1.o -c bar1.c
+cc -o bar2.o -c bar2.c
+cc -o common1.o -c common1.c
+cc -o common2.o -c common2.c
+cc -o bar bar1.o bar2.o common1.o common2.o
+cc -o foo.o -c foo.c
+cc -o foo foo.o common1.o common2.o
+</screen>
diff --git a/doc/generated/examples/lesssimple_target_1.xml b/doc/generated/examples/lesssimple_target_1.xml
new file mode 100644
index 0000000..76f0de9
--- /dev/null
+++ b/doc/generated/examples/lesssimple_target_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o new_hello hello.o
+</screen>
diff --git a/doc/generated/examples/lesssimple_target_2.xml b/doc/generated/examples/lesssimple_target_2.xml
new file mode 100644
index 0000000..0babd04
--- /dev/null
+++ b/doc/generated/examples/lesssimple_target_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:new_hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/libraries_SharedLibrary_1.xml b/doc/generated/examples/libraries_SharedLibrary_1.xml
new file mode 100644
index 0000000..80df708
--- /dev/null
+++ b/doc/generated/examples/libraries_SharedLibrary_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f1.os -c f1.c
+cc -o f2.os -c f2.c
+cc -o f3.os -c f3.c
+cc -o libfoo.so -shared f1.os f2.os f3.os
+</screen>
diff --git a/doc/generated/examples/libraries_SharedLibrary_2.xml b/doc/generated/examples/libraries_SharedLibrary_2.xml
new file mode 100644
index 0000000..c2894d5
--- /dev/null
+++ b/doc/generated/examples/libraries_SharedLibrary_2.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fof1.obj /c f1.c /nologo
+cl /Fof2.obj /c f2.c /nologo
+cl /Fof3.obj /c f3.c /nologo
+link /nologo /dll /out:foo.dll /implib:foo.lib f1.obj f2.obj f3.obj
+RegServerFunc(target, source, env)
+embedManifestDllCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/libraries_ex1_1.xml b/doc/generated/examples/libraries_ex1_1.xml
new file mode 100644
index 0000000..0449b31
--- /dev/null
+++ b/doc/generated/examples/libraries_ex1_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f1.o -c f1.c
+cc -o f2.o -c f2.c
+cc -o f3.o -c f3.c
+ar rc libfoo.a f1.o f2.o f3.o
+ranlib libfoo.a
+</screen>
diff --git a/doc/generated/examples/libraries_ex1_2.xml b/doc/generated/examples/libraries_ex1_2.xml
new file mode 100644
index 0000000..9256d4f
--- /dev/null
+++ b/doc/generated/examples/libraries_ex1_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fof1.obj /c f1.c /nologo
+cl /Fof2.obj /c f2.c /nologo
+cl /Fof3.obj /c f3.c /nologo
+lib /nologo /OUT:foo.lib f1.obj f2.obj f3.obj
+</screen>
diff --git a/doc/generated/examples/libraries_ex2_1.xml b/doc/generated/examples/libraries_ex2_1.xml
new file mode 100644
index 0000000..7389203
--- /dev/null
+++ b/doc/generated/examples/libraries_ex2_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f1.o -c f1.c
+cc -o f2.o -c f2.c
+cc -o f3.o -c f3.c
+ar rc libfoo.a f1.o f2.o f3.o
+ranlib libfoo.a
+cc -o prog.o -c prog.c
+cc -o prog prog.o -L. -lfoo -lbar
+</screen>
diff --git a/doc/generated/examples/libraries_ex2_2.xml b/doc/generated/examples/libraries_ex2_2.xml
new file mode 100644
index 0000000..17ec5b5
--- /dev/null
+++ b/doc/generated/examples/libraries_ex2_2.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fof1.obj /c f1.c /nologo
+cl /Fof2.obj /c f2.c /nologo
+cl /Fof3.obj /c f3.c /nologo
+lib /nologo /OUT:foo.lib f1.obj f2.obj f3.obj
+cl /Foprog.obj /c prog.c /nologo
+link /nologo /OUT:prog.exe /LIBPATH:. foo.lib bar.lib prog.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/libraries_ex3_1.xml b/doc/generated/examples/libraries_ex3_1.xml
new file mode 100644
index 0000000..1b4fb3c
--- /dev/null
+++ b/doc/generated/examples/libraries_ex3_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o prog.o -c prog.c
+cc -o prog prog.o -L/usr/lib -L/usr/local/lib -lm
+</screen>
diff --git a/doc/generated/examples/libraries_ex3_2.xml b/doc/generated/examples/libraries_ex3_2.xml
new file mode 100644
index 0000000..2a64da1
--- /dev/null
+++ b/doc/generated/examples/libraries_ex3_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Foprog.obj /c prog.c /nologo
+link /nologo /OUT:prog.exe /LIBPATH:\usr\lib /LIBPATH:\usr\local\lib m.lib prog.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/libraries_objects_1.xml b/doc/generated/examples/libraries_objects_1.xml
new file mode 100644
index 0000000..97623d9
--- /dev/null
+++ b/doc/generated/examples/libraries_objects_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f1.o -c f1.c
+cc -o f3.o -c f3.c
+ar rc libfoo.a f1.o f2.o f3.o f4.o
+ranlib libfoo.a
+</screen>
diff --git a/doc/generated/examples/mergeflags_MergeFlags1_1.xml b/doc/generated/examples/mergeflags_MergeFlags1_1.xml
new file mode 100644
index 0000000..a5a6915
--- /dev/null
+++ b/doc/generated/examples/mergeflags_MergeFlags1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+['-option', '-O1', '-whatever', '-O3']
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/mergeflags_MergeFlags2_1.xml b/doc/generated/examples/mergeflags_MergeFlags2_1.xml
new file mode 100644
index 0000000..d807d66
--- /dev/null
+++ b/doc/generated/examples/mergeflags_MergeFlags2_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+['/include', '/usr/local/include', '/usr/include', '/usr/opt/include']
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/mergeflags_MergeFlags3_1.xml b/doc/generated/examples/mergeflags_MergeFlags3_1.xml
new file mode 100644
index 0000000..324d960
--- /dev/null
+++ b/doc/generated/examples/mergeflags_MergeFlags3_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+['-option', '-O1', '-whatever', '-O3']
+['/include', '/usr/local/include', '/usr/include', '/usr/opt/include']
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/misc_Exit_1.xml b/doc/generated/examples/misc_Exit_1.xml
new file mode 100644
index 0000000..65ccf9b
--- /dev/null
+++ b/doc/generated/examples/misc_Exit_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q FUTURE=1</userinput>
+The FUTURE option is not supported yet!
+% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/misc_FindFile1a_1.xml b/doc/generated/examples/misc_FindFile1a_1.xml
new file mode 100644
index 0000000..2b18f6e
--- /dev/null
+++ b/doc/generated/examples/misc_FindFile1a_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+None
+&lt;class 'SCons.Node.FS.File'&gt; exists
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/misc_FindFile1b_1.xml b/doc/generated/examples/misc_FindFile1b_1.xml
new file mode 100644
index 0000000..f16dc95
--- /dev/null
+++ b/doc/generated/examples/misc_FindFile1b_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+nonesuch.h: None
+config.h: config.h
+private.h: src/include/private.h
+dist.h: include/dist.h
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/misc_FindFile1d_1.xml b/doc/generated/examples/misc_FindFile1d_1.xml
new file mode 100644
index 0000000..e0e8e8d
--- /dev/null
+++ b/doc/generated/examples/misc_FindFile1d_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+sub1/multiple
+sub2/multiple
+sub3/multiple
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/misc_FindFile2_1.xml b/doc/generated/examples/misc_FindFile2_1.xml
new file mode 100644
index 0000000..5aea252
--- /dev/null
+++ b/doc/generated/examples/misc_FindFile2_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+leaf
+derived
+cat &gt; derived leaf
+</screen>
diff --git a/doc/generated/examples/misc_FindFile2_2.xml b/doc/generated/examples/misc_FindFile2_2.xml
new file mode 100644
index 0000000..5aea252
--- /dev/null
+++ b/doc/generated/examples/misc_FindFile2_2.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+leaf
+derived
+cat &gt; derived leaf
+</screen>
diff --git a/doc/generated/examples/misc_FindFile3_1.xml b/doc/generated/examples/misc_FindFile3_1.xml
new file mode 100644
index 0000000..026212c
--- /dev/null
+++ b/doc/generated/examples/misc_FindFile3_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+build/leaf
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/misc_Flatten1_1.xml b/doc/generated/examples/misc_Flatten1_1.xml
new file mode 100644
index 0000000..b25ef5f
--- /dev/null
+++ b/doc/generated/examples/misc_Flatten1_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o prog1.o -c prog1.c
+cc -o prog2.o -c -DFOO prog2.c
+cc -o prog1 prog1.o prog2.o
+</screen>
diff --git a/doc/generated/examples/misc_Flatten2_1.xml b/doc/generated/examples/misc_Flatten2_1.xml
new file mode 100644
index 0000000..5c9502d
--- /dev/null
+++ b/doc/generated/examples/misc_Flatten2_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+AttributeError: 'NodeList' object has no attribute 'abspath':
+ File "/home/my/project/SConstruct", line 8:
+ print object_file.abspath
+</screen>
diff --git a/doc/generated/examples/nodes_GetBuildPath_1.xml b/doc/generated/examples/nodes_GetBuildPath_1.xml
new file mode 100644
index 0000000..d8160f3
--- /dev/null
+++ b/doc/generated/examples/nodes_GetBuildPath_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+['foo.c', 'sub/dir/value']
+scons: `.' is up to date.
+</screen>
diff --git a/doc/generated/examples/nodes_ex1_1.xml b/doc/generated/examples/nodes_ex1_1.xml
new file mode 100644
index 0000000..fc72480
--- /dev/null
+++ b/doc/generated/examples/nodes_ex1_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o goodbye.o -c -DGOODBYE goodbye.c
+cc -o hello.o -c -DHELLO hello.c
+cc -o hello hello.o goodbye.o
+</screen>
diff --git a/doc/generated/examples/nodes_ex1_2.xml b/doc/generated/examples/nodes_ex1_2.xml
new file mode 100644
index 0000000..cc92ae6
--- /dev/null
+++ b/doc/generated/examples/nodes_ex1_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fogoodbye.obj /c goodbye.c -DGOODBYE
+cl /Fohello.obj /c hello.c -DHELLO
+link /nologo /OUT:hello.exe hello.obj goodbye.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/nodes_exists_1.xml b/doc/generated/examples/nodes_exists_1.xml
new file mode 100644
index 0000000..c618a6c
--- /dev/null
+++ b/doc/generated/examples/nodes_exists_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+hello does not exist!
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/nodes_print_1.xml b/doc/generated/examples/nodes_print_1.xml
new file mode 100644
index 0000000..dd8fcbb
--- /dev/null
+++ b/doc/generated/examples/nodes_print_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+The object file is: hello.o
+The program file is: hello
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/nodes_print_2.xml b/doc/generated/examples/nodes_print_2.xml
new file mode 100644
index 0000000..58bb703
--- /dev/null
+++ b/doc/generated/examples/nodes_print_2.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+The object file is: hello.obj
+The program file is: hello.exe
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/output_Progress-TARGET_1.xml b/doc/generated/examples/output_Progress-TARGET_1.xml
new file mode 100644
index 0000000..29abc9f
--- /dev/null
+++ b/doc/generated/examples/output_Progress-TARGET_1.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+Evaluating SConstruct
+Evaluating f1.c
+Evaluating f1.o
+cc -o f1.o -c f1.c
+Evaluating f1
+cc -o f1 f1.o
+Evaluating f2.c
+Evaluating f2.o
+cc -o f2.o -c f2.c
+Evaluating f2
+cc -o f2 f2.o
+Evaluating .
+</screen>
diff --git a/doc/generated/examples/output_ex1_1.xml b/doc/generated/examples/output_ex1_1.xml
new file mode 100644
index 0000000..2576b31
--- /dev/null
+++ b/doc/generated/examples/output_ex1_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -h</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+
+Type: 'scons program' to build the production program,
+ 'scons debug' to build the debug version.
+
+Use scons -H for help about command-line options.
+</screen>
diff --git a/doc/generated/examples/output_ex2_1.xml b/doc/generated/examples/output_ex2_1.xml
new file mode 100644
index 0000000..e206c33
--- /dev/null
+++ b/doc/generated/examples/output_ex2_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -h</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+
+Type: 'scons program' to build the production program.
+
+Type: 'scons windebug' to build the Windows debug version.
+
+Use scons -H for help about command-line options.
+</screen>
diff --git a/doc/generated/examples/output_ex2_2.xml b/doc/generated/examples/output_ex2_2.xml
new file mode 100644
index 0000000..126fc54
--- /dev/null
+++ b/doc/generated/examples/output_ex2_2.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -h</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+
+Type: 'scons program' to build the production program.
+
+Use scons -H for help about command-line options.
+</screen>
diff --git a/doc/generated/examples/output_gbf2_1.xml b/doc/generated/examples/output_gbf2_1.xml
new file mode 100644
index 0000000..e72965f
--- /dev/null
+++ b/doc/generated/examples/output_gbf2_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+scons: `.' is up to date.
+Build succeeded.
+% <userinput>scons -Q fail=1</userinput>
+scons: *** [target] Source `source' not found, needed by target `target'.
+FAILED!!!!
+Failed building target: Source `source' not found, needed by target `target'.
+</screen>
diff --git a/doc/generated/examples/parseflags_ex1_1.xml b/doc/generated/examples/parseflags_ex1_1.xml
new file mode 100644
index 0000000..d385662
--- /dev/null
+++ b/doc/generated/examples/parseflags_ex1_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+CPPPATH ['/opt/include']
+LIBPATH ['/opt/lib']
+LIBS ['foo']
+cc -o f1.o -c -I/opt/include f1.c
+cc -o f1 f1.o -L/opt/lib -lfoo
+</screen>
diff --git a/doc/generated/examples/parseflags_ex1_2.xml b/doc/generated/examples/parseflags_ex1_2.xml
new file mode 100644
index 0000000..29985a2
--- /dev/null
+++ b/doc/generated/examples/parseflags_ex1_2.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+CPPPATH ['/opt/include']
+LIBPATH ['/opt/lib']
+LIBS ['foo']
+cl /Fof1.obj /c f1.c /nologo /I\opt\include
+link /nologo /OUT:f1.exe /LIBPATH:\opt\lib foo.lib f1.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/parseflags_ex2_1.xml b/doc/generated/examples/parseflags_ex2_1.xml
new file mode 100644
index 0000000..8026ca0
--- /dev/null
+++ b/doc/generated/examples/parseflags_ex2_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+CCFLAGS -whatever
+cc -o f1.o -c -whatever f1.c
+cc -o f1 f1.o
+</screen>
diff --git a/doc/generated/examples/parseflags_ex3_1.xml b/doc/generated/examples/parseflags_ex3_1.xml
new file mode 100644
index 0000000..d385662
--- /dev/null
+++ b/doc/generated/examples/parseflags_ex3_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+CPPPATH ['/opt/include']
+LIBPATH ['/opt/lib']
+LIBS ['foo']
+cc -o f1.o -c -I/opt/include f1.c
+cc -o f1 f1.o -L/opt/lib -lfoo
+</screen>
diff --git a/doc/generated/examples/parseflags_ex4_1.xml b/doc/generated/examples/parseflags_ex4_1.xml
new file mode 100644
index 0000000..d385662
--- /dev/null
+++ b/doc/generated/examples/parseflags_ex4_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+CPPPATH ['/opt/include']
+LIBPATH ['/opt/lib']
+LIBS ['foo']
+cc -o f1.o -c -I/opt/include f1.c
+cc -o f1 f1.o -L/opt/lib -lfoo
+</screen>
diff --git a/doc/generated/examples/repositories_CPPPATH3_1.xml b/doc/generated/examples/repositories_CPPPATH3_1.xml
new file mode 100644
index 0000000..558678d
--- /dev/null
+++ b/doc/generated/examples/repositories_CPPPATH3_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c -Idir1 -I/r1/dir1 -I/r2/dir1 -Idir2 -I/r1/dir2 -I/r2/dir2 -Idir3 -I/r1/dir3 -I/r2/dir3 hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/repositories_CPPPATH_1.xml b/doc/generated/examples/repositories_CPPPATH_1.xml
new file mode 100644
index 0000000..f5ad671
--- /dev/null
+++ b/doc/generated/examples/repositories_CPPPATH_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c -I. -I/usr/repository1 hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/repositories_ex1_1.xml b/doc/generated/examples/repositories_ex1_1.xml
new file mode 100644
index 0000000..d1250c2
--- /dev/null
+++ b/doc/generated/examples/repositories_ex1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/repositories_ex2_1.xml b/doc/generated/examples/repositories_ex2_1.xml
new file mode 100644
index 0000000..146a074
--- /dev/null
+++ b/doc/generated/examples/repositories_ex2_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c /usr/repository1/hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/repositories_ex3_1.xml b/doc/generated/examples/repositories_ex3_1.xml
new file mode 100644
index 0000000..b3f07a2
--- /dev/null
+++ b/doc/generated/examples/repositories_ex3_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c /usr/repository2/hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/repositories_ex4_1.xml b/doc/generated/examples/repositories_ex4_1.xml
new file mode 100644
index 0000000..1d3e41a
--- /dev/null
+++ b/doc/generated/examples/repositories_ex4_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>cd /usr/repository1</userinput>
+% <userinput>scons -Q</userinput>
+cc -o file1.o -c file1.c
+cc -o file2.o -c file2.c
+cc -o hello.o -c hello.c
+cc -o hello hello.o file1.o file2.o
+</screen>
diff --git a/doc/generated/examples/repositories_quote1_1.xml b/doc/generated/examples/repositories_quote1_1.xml
new file mode 100644
index 0000000..e9f362d
--- /dev/null
+++ b/doc/generated/examples/repositories_quote1_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o hello.o -c -I. -I/usr/repository1 /usr/repository1/hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/separate_builddir_1.xml b/doc/generated/examples/separate_builddir_1.xml
new file mode 100644
index 0000000..e470a6d
--- /dev/null
+++ b/doc/generated/examples/separate_builddir_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>ls src</userinput>
+hello.c
+% <userinput>scons -Q</userinput>
+cc -o build/hello.o -c build/hello.c
+cc -o build/hello build/hello.o
+% <userinput>ls build</userinput>
+hello hello.c hello.o
+</screen>
diff --git a/doc/generated/examples/separate_builddir_sconscript_1.xml b/doc/generated/examples/separate_builddir_sconscript_1.xml
new file mode 100644
index 0000000..34a07bd
--- /dev/null
+++ b/doc/generated/examples/separate_builddir_sconscript_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>ls src</userinput>
+SConscript hello.c
+% <userinput>scons -Q</userinput>
+cc -o build/hello.o -c build/hello.c
+cc -o build/hello build/hello.o
+% <userinput>ls build</userinput>
+SConscript hello hello.c hello.o
+</screen>
diff --git a/doc/generated/examples/separate_builddir_sconscript_SConstruct b/doc/generated/examples/separate_builddir_sconscript_SConstruct
new file mode 100644
index 0000000..c3da725
--- /dev/null
+++ b/doc/generated/examples/separate_builddir_sconscript_SConstruct
@@ -0,0 +1,4 @@
+
+ VariantDir('build', 'src')
+ SConscript('build/SConscript')
+
diff --git a/doc/generated/examples/separate_duplicate0_1.xml b/doc/generated/examples/separate_duplicate0_1.xml
new file mode 100644
index 0000000..13a25d3
--- /dev/null
+++ b/doc/generated/examples/separate_duplicate0_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>ls src</userinput>
+hello.c
+% <userinput>scons -Q</userinput>
+cc -o build/hello.o -c src/hello.c
+cc -o build/hello build/hello.o
+% <userinput>ls build</userinput>
+hello hello.o
+</screen>
diff --git a/doc/generated/examples/separate_ex1_1.xml b/doc/generated/examples/separate_ex1_1.xml
new file mode 100644
index 0000000..34a07bd
--- /dev/null
+++ b/doc/generated/examples/separate_ex1_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>ls src</userinput>
+SConscript hello.c
+% <userinput>scons -Q</userinput>
+cc -o build/hello.o -c build/hello.c
+cc -o build/hello build/hello.o
+% <userinput>ls build</userinput>
+SConscript hello hello.c hello.o
+</screen>
diff --git a/doc/generated/examples/separate_glob_builddir_sconscript_1.xml b/doc/generated/examples/separate_glob_builddir_sconscript_1.xml
new file mode 100644
index 0000000..95b7650
--- /dev/null
+++ b/doc/generated/examples/separate_glob_builddir_sconscript_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>ls src</userinput>
+SConscript f1.c f2.c f2.h
+% <userinput>scons -Q</userinput>
+cc -o build/f1.o -c build/f1.c
+cc -o build/f2.o -c build/f2.c
+cc -o build/hello build/f1.o build/f2.o
+% <userinput>ls build</userinput>
+SConscript f1.c f1.o f2.c f2.h f2.o hello
+</screen>
diff --git a/doc/generated/examples/sideeffect_parallel_1.xml b/doc/generated/examples/sideeffect_parallel_1.xml
new file mode 100644
index 0000000..18f834a
--- /dev/null
+++ b/doc/generated/examples/sideeffect_parallel_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --jobs=2</userinput>
+echo &gt; file1.out data1
+echo &gt; file2.out data2
+</screen>
diff --git a/doc/generated/examples/sideeffect_shared_1.xml b/doc/generated/examples/sideeffect_shared_1.xml
new file mode 100644
index 0000000..11cfec7
--- /dev/null
+++ b/doc/generated/examples/sideeffect_shared_1.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --jobs=2</userinput>
+./build --log logfile.txt file1.in file1.out
+./build --log logfile.txt file2.in file2.out
+</screen>
diff --git a/doc/generated/examples/sideeffect_simple_1.xml b/doc/generated/examples/sideeffect_simple_1.xml
new file mode 100644
index 0000000..9fdf074
--- /dev/null
+++ b/doc/generated/examples/sideeffect_simple_1.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --jobs=2</userinput>
+ File "/home/my/project/SConstruct", line 4
+
+ 'echo &gt;$TARGET data1; echo &gt;log updated file1'))
+
+ ^
+
+SyntaxError: invalid syntax
+</screen>
diff --git a/doc/generated/examples/simple_Object_1.xml b/doc/generated/examples/simple_Object_1.xml
new file mode 100644
index 0000000..33a86a7
--- /dev/null
+++ b/doc/generated/examples/simple_Object_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o hello.o -c hello.c
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/simple_Object_2.xml b/doc/generated/examples/simple_Object_2.xml
new file mode 100644
index 0000000..42b773a
--- /dev/null
+++ b/doc/generated/examples/simple_Object_2.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cl /Fohello.obj /c hello.c /nologo
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/simple_clean_1.xml b/doc/generated/examples/simple_clean_1.xml
new file mode 100644
index 0000000..0affa24
--- /dev/null
+++ b/doc/generated/examples/simple_clean_1.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+scons: done building targets.
+% <userinput>scons -c</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Cleaning targets ...
+Removed hello.o
+Removed hello
+scons: done cleaning targets.
+</screen>
diff --git a/doc/generated/examples/simple_clean_2.xml b/doc/generated/examples/simple_clean_2.xml
new file mode 100644
index 0000000..3ccedf4
--- /dev/null
+++ b/doc/generated/examples/simple_clean_2.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+scons: done building targets.
+C:\&gt;<userinput>scons -c</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Cleaning targets ...
+Removed hello.obj
+Removed hello.exe
+scons: done cleaning targets.
+</screen>
diff --git a/doc/generated/examples/simple_declarative_1.xml b/doc/generated/examples/simple_declarative_1.xml
new file mode 100644
index 0000000..effcd54
--- /dev/null
+++ b/doc/generated/examples/simple_declarative_1.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+Calling Program('hello.c')
+Calling Program('goodbye.c')
+Finished calling Program()
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o goodbye.o -c goodbye.c
+cc -o goodbye goodbye.o
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/simple_ex1_1.xml b/doc/generated/examples/simple_ex1_1.xml
new file mode 100644
index 0000000..a855deb
--- /dev/null
+++ b/doc/generated/examples/simple_ex1_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/simple_ex1_2.xml b/doc/generated/examples/simple_ex1_2.xml
new file mode 100644
index 0000000..b3d11cd
--- /dev/null
+++ b/doc/generated/examples/simple_ex1_2.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/simple_ex1_3.xml b/doc/generated/examples/simple_ex1_3.xml
new file mode 100644
index 0000000..b3d11cd
--- /dev/null
+++ b/doc/generated/examples/simple_ex1_3.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/simple_ex1_4.xml b/doc/generated/examples/simple_ex1_4.xml
new file mode 100644
index 0000000..4087bcf
--- /dev/null
+++ b/doc/generated/examples/simple_ex1_4.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q</userinput>
+cl /Fohello.obj /c hello.c /nologo
+link /nologo /OUT:hello.exe hello.obj
+embedManifestExeCheck(target, source, env)
+</screen>
diff --git a/doc/generated/examples/simple_java_1.xml b/doc/generated/examples/simple_java_1.xml
new file mode 100644
index 0000000..53cc8aa
--- /dev/null
+++ b/doc/generated/examples/simple_java_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+scons: Building targets ...
+javac -d classes -sourcepath src src/hello.java
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/sourcecode_bitkeeper_1.xml b/doc/generated/examples/sourcecode_bitkeeper_1.xml
new file mode 100644
index 0000000..c02c973
--- /dev/null
+++ b/doc/generated/examples/sourcecode_bitkeeper_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+bk get hello.c
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/sourcecode_cvs_1.xml b/doc/generated/examples/sourcecode_cvs_1.xml
new file mode 100644
index 0000000..c2165cb
--- /dev/null
+++ b/doc/generated/examples/sourcecode_cvs_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cvs -d /usr/local/CVS co hello.c
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/sourcecode_rcs_1.xml b/doc/generated/examples/sourcecode_rcs_1.xml
new file mode 100644
index 0000000..75def9c
--- /dev/null
+++ b/doc/generated/examples/sourcecode_rcs_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+co hello.c
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/sourcecode_sccs_1.xml b/doc/generated/examples/sourcecode_sccs_1.xml
new file mode 100644
index 0000000..0be5f83
--- /dev/null
+++ b/doc/generated/examples/sourcecode_sccs_1.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+sccs get hello.c
+cc -o hello.o -c hello.c
+cc -o hello hello.o
+</screen>
diff --git a/doc/generated/examples/tasks_ex1_1.xml b/doc/generated/examples/tasks_ex1_1.xml
new file mode 100644
index 0000000..f8b323e
--- /dev/null
+++ b/doc/generated/examples/tasks_ex1_1.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o app main.cpp
+cat &lt; foo.bar2 &gt; foo.cpp
+cc -o app2 main2.cpp foo.cpp
+cat &lt; test.bar &gt; test.h
+</screen>
diff --git a/doc/generated/examples/tasks_ex1_main.cpp b/doc/generated/examples/tasks_ex1_main.cpp
new file mode 100644
index 0000000..2a37cad
--- /dev/null
+++ b/doc/generated/examples/tasks_ex1_main.cpp
@@ -0,0 +1,3 @@
+
+#include "test.h"
+
diff --git a/doc/generated/examples/troubleshoot_Dump_1.xml b/doc/generated/examples/troubleshoot_Dump_1.xml
new file mode 100644
index 0000000..d1191eb
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_Dump_1.xml
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+{ 'BUILDERS': {'_InternalInstall': &lt;function InstallBuilderWrapper at 0x700000&amp;gt;, '_InternalInstallVersionedLib': &lt;function InstallVersionedBuilderWrapper at 0x700000&amp;gt;, '_InternalInstallAs': &lt;function InstallAsBuilderWrapper at 0x700000&amp;gt;},
+ 'CONFIGUREDIR': '#/.sconf_temp',
+ 'CONFIGURELOG': '#/config.log',
+ 'CPPSUFFIXES': [ '.c',
+ '.C',
+ '.cxx',
+ '.cpp',
+ '.c++',
+ '.cc',
+ '.h',
+ '.H',
+ '.hxx',
+ '.hpp',
+ '.hh',
+ '.F',
+ '.fpp',
+ '.FPP',
+ '.m',
+ '.mm',
+ '.S',
+ '.spp',
+ '.SPP',
+ '.sx'],
+ 'DSUFFIXES': ['.d'],
+ 'Dir': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'Dirs': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'ENV': { 'PATH': '/usr/local/bin:/opt/bin:/bin:/usr/bin'},
+ 'ESCAPE': &lt;function escape at 0x700000&amp;gt;,
+ 'File': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'HOST_ARCH': None,
+ 'HOST_OS': None,
+ 'IDLSUFFIXES': ['.idl', '.IDL'],
+ 'INSTALL': &lt;function copyFunc at 0x700000&amp;gt;,
+ 'INSTALLVERSIONEDLIB': &lt;function copyFuncVersionedLib at 0x700000&amp;gt;,
+ 'LIBPREFIX': 'lib',
+ 'LIBPREFIXES': ['$LIBPREFIX'],
+ 'LIBSUFFIX': '.a',
+ 'LIBSUFFIXES': ['$LIBSUFFIX', '$SHLIBSUFFIX'],
+ 'MAXLINELENGTH': 128072,
+ 'OBJPREFIX': '',
+ 'OBJSUFFIX': '.o',
+ 'PLATFORM': 'posix',
+ 'PROGPREFIX': '',
+ 'PROGSUFFIX': '',
+ 'PSPAWN': &lt;function piped_env_spawn at 0x700000&amp;gt;,
+ 'RDirs': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'SCANNERS': [],
+ 'SHELL': 'sh',
+ 'SHLIBPREFIX': '$LIBPREFIX',
+ 'SHLIBSUFFIX': '.so',
+ 'SHOBJPREFIX': '$OBJPREFIX',
+ 'SHOBJSUFFIX': '$OBJSUFFIX',
+ 'SPAWN': &lt;function spawnvpe_spawn at 0x700000&amp;gt;,
+ 'TARGET_ARCH': None,
+ 'TARGET_OS': None,
+ 'TEMPFILE': &lt;class 'SCons.Platform.TempFileMunge'&gt;,
+ 'TEMPFILEPREFIX': '@',
+ 'TOOLS': ['install', 'install'],
+ '_CPPDEFFLAGS': '${_defines(CPPDEFPREFIX, CPPDEFINES, CPPDEFSUFFIX, __env__)}',
+ '_CPPINCFLAGS': '$( ${_concat(INCPREFIX, CPPPATH, INCSUFFIX, __env__, RDirs, TARGET, SOURCE)} $)',
+ '_LIBDIRFLAGS': '$( ${_concat(LIBDIRPREFIX, LIBPATH, LIBDIRSUFFIX, __env__, RDirs, TARGET, SOURCE)} $)',
+ '_LIBFLAGS': '${_concat(LIBLINKPREFIX, LIBS, LIBLINKSUFFIX, __env__)}',
+ '__RPATH': '$_RPATH',
+ '_concat': &lt;function _concat at 0x700000&amp;gt;,
+ '_defines': &lt;function _defines at 0x700000&amp;gt;,
+ '_stripixes': &lt;function _stripixes at 0x700000&amp;gt;}
+scons: done reading SConscript files.
+scons: Building targets ...
+scons: `.' is up to date.
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/troubleshoot_Dump_2.xml b/doc/generated/examples/troubleshoot_Dump_2.xml
new file mode 100644
index 0000000..2fdb1bc
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_Dump_2.xml
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons</userinput>
+scons: Reading SConscript files ...
+{ 'BUILDERS': {'_InternalInstallVersionedLib': &lt;function InstallVersionedBuilderWrapper at 0x700000&amp;gt;, '_InternalInstall': &lt;function InstallBuilderWrapper at 0x700000&amp;gt;, 'Object': &lt;SCons.Builder.CompositeBuilder object at 0x700000&amp;gt;, 'PCH': &lt;SCons.Builder.BuilderBase object at 0x700000&amp;gt;, 'RES': &lt;SCons.Builder.BuilderBase object at 0x700000&amp;gt;, 'SharedObject': &lt;SCons.Builder.CompositeBuilder object at 0x700000&amp;gt;, 'StaticObject': &lt;SCons.Builder.CompositeBuilder object at 0x700000&amp;gt;, '_InternalInstallAs': &lt;function InstallAsBuilderWrapper at 0x700000&amp;gt;},
+ 'CC': 'cl',
+ 'CCCOM': &lt;SCons.Action.FunctionAction object at 0x700000&amp;gt;,
+ 'CCFLAGS': ['/nologo'],
+ 'CCPCHFLAGS': ['${(PCH and "/Yu%s \\"/Fp%s\\""%(PCHSTOP or "",File(PCH))) or ""}'],
+ 'CCPDBFLAGS': ['${(PDB and "/Z7") or ""}'],
+ 'CFILESUFFIX': '.c',
+ 'CFLAGS': [],
+ 'CONFIGUREDIR': '#/.sconf_temp',
+ 'CONFIGURELOG': '#/config.log',
+ 'CPPDEFPREFIX': '/D',
+ 'CPPDEFSUFFIX': '',
+ 'CPPSUFFIXES': [ '.c',
+ '.C',
+ '.cxx',
+ '.cpp',
+ '.c++',
+ '.cc',
+ '.h',
+ '.H',
+ '.hxx',
+ '.hpp',
+ '.hh',
+ '.F',
+ '.fpp',
+ '.FPP',
+ '.m',
+ '.mm',
+ '.S',
+ '.spp',
+ '.SPP',
+ '.sx'],
+ 'CXX': '$CC',
+ 'CXXCOM': '${TEMPFILE("$CXX $_MSVC_OUTPUT_FLAG /c $CHANGED_SOURCES $CXXFLAGS $CCFLAGS $_CCCOMCOM")}',
+ 'CXXFILESUFFIX': '.cc',
+ 'CXXFLAGS': ['$(', '/TP', '$)'],
+ 'DSUFFIXES': ['.d'],
+ 'Dir': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'Dirs': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'ENV': { 'PATH': 'C:\\WINDOWS\\System32',
+ 'PATHEXT': '.COM;.EXE;.BAT;.CMD',
+ 'SystemRoot': 'C:\\WINDOWS'},
+ 'ESCAPE': &lt;function escape at 0x700000&amp;gt;,
+ 'File': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'HOST_ARCH': '',
+ 'HOST_OS': 'win32',
+ 'IDLSUFFIXES': ['.idl', '.IDL'],
+ 'INCPREFIX': '/I',
+ 'INCSUFFIX': '',
+ 'INSTALL': &lt;function copyFunc at 0x700000&amp;gt;,
+ 'INSTALLVERSIONEDLIB': &lt;function copyFuncVersionedLib at 0x700000&amp;gt;,
+ 'LIBPREFIX': '',
+ 'LIBPREFIXES': ['$LIBPREFIX'],
+ 'LIBSUFFIX': '.lib',
+ 'LIBSUFFIXES': ['$LIBSUFFIX'],
+ 'MAXLINELENGTH': 2048,
+ 'MSVC_SETUP_RUN': True,
+ 'OBJPREFIX': '',
+ 'OBJSUFFIX': '.obj',
+ 'PCHCOM': '$CXX /Fo${TARGETS[1]} $CXXFLAGS $CCFLAGS $CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS /c $SOURCES /Yc$PCHSTOP /Fp${TARGETS[0]} $CCPDBFLAGS $PCHPDBFLAGS',
+ 'PCHPDBFLAGS': ['${(PDB and "/Yd") or ""}'],
+ 'PLATFORM': 'win32',
+ 'PROGPREFIX': '',
+ 'PROGSUFFIX': '.exe',
+ 'PSPAWN': &lt;function piped_spawn at 0x700000&amp;gt;,
+ 'RC': 'rc',
+ 'RCCOM': &lt;SCons.Action.FunctionAction object at 0x700000&amp;gt;,
+ 'RCFLAGS': [],
+ 'RCSUFFIXES': ['.rc', '.rc2'],
+ 'RDirs': &lt;SCons.Defaults.Variable_Method_Caller object at 0x700000&amp;gt;,
+ 'SCANNERS': [],
+ 'SHCC': '$CC',
+ 'SHCCCOM': &lt;SCons.Action.FunctionAction object at 0x700000&amp;gt;,
+ 'SHCCFLAGS': ['$CCFLAGS'],
+ 'SHCFLAGS': ['$CFLAGS'],
+ 'SHCXX': '$CXX',
+ 'SHCXXCOM': '${TEMPFILE("$SHCXX $_MSVC_OUTPUT_FLAG /c $CHANGED_SOURCES $SHCXXFLAGS $SHCCFLAGS $_CCCOMCOM")}',
+ 'SHCXXFLAGS': ['$CXXFLAGS'],
+ 'SHELL': None,
+ 'SHLIBPREFIX': '',
+ 'SHLIBSUFFIX': '.dll',
+ 'SHOBJPREFIX': '$OBJPREFIX',
+ 'SHOBJSUFFIX': '$OBJSUFFIX',
+ 'SPAWN': &lt;function spawn at 0x700000&amp;gt;,
+ 'STATIC_AND_SHARED_OBJECTS_ARE_THE_SAME': 1,
+ 'TARGET_ARCH': '',
+ 'TARGET_OS': 'win32',
+ 'TEMPFILE': &lt;class 'SCons.Platform.TempFileMunge'&gt;,
+ 'TEMPFILEPREFIX': '@',
+ 'TOOLS': ['msvc', 'install', 'install'],
+ '_CCCOMCOM': '$CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS $CCPCHFLAGS $CCPDBFLAGS',
+ '_CPPDEFFLAGS': '${_defines(CPPDEFPREFIX, CPPDEFINES, CPPDEFSUFFIX, __env__)}',
+ '_CPPINCFLAGS': '$( ${_concat(INCPREFIX, CPPPATH, INCSUFFIX, __env__, RDirs, TARGET, SOURCE)} $)',
+ '_LIBDIRFLAGS': '$( ${_concat(LIBDIRPREFIX, LIBPATH, LIBDIRSUFFIX, __env__, RDirs, TARGET, SOURCE)} $)',
+ '_LIBFLAGS': '${_concat(LIBLINKPREFIX, LIBS, LIBLINKSUFFIX, __env__)}',
+ '_MSVC_OUTPUT_FLAG': &lt;function msvc_output_flag at 0x700000&amp;gt;,
+ '_concat': &lt;function _concat at 0x700000&amp;gt;,
+ '_defines': &lt;function _defines at 0x700000&amp;gt;,
+ '_stripixes': &lt;function _stripixes at 0x700000&amp;gt;}
+scons: done reading SConscript files.
+scons: Building targets ...
+scons: `.' is up to date.
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/troubleshoot_Dump_ENV_1.xml b/doc/generated/examples/troubleshoot_Dump_ENV_1.xml
new file mode 100644
index 0000000..818bbcc
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_Dump_ENV_1.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons</userinput>
+scons: Reading SConscript files ...
+{ 'PATH': '/usr/local/bin:/opt/bin:/bin:/usr/bin'}
+scons: done reading SConscript files.
+scons: Building targets ...
+scons: `.' is up to date.
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/troubleshoot_Dump_ENV_2.xml b/doc/generated/examples/troubleshoot_Dump_ENV_2.xml
new file mode 100644
index 0000000..4ea3a2f
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_Dump_ENV_2.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons</userinput>
+scons: Reading SConscript files ...
+{ 'PATH': 'C:\\WINDOWS\\System32',
+ 'PATHEXT': '.COM;.EXE;.BAT;.CMD',
+ 'SystemRoot': 'C:\\WINDOWS'}
+scons: done reading SConscript files.
+scons: Building targets ...
+scons: `.' is up to date.
+scons: done building targets.
+</screen>
diff --git a/doc/generated/examples/troubleshoot_explain1_1.xml b/doc/generated/examples/troubleshoot_explain1_1.xml
new file mode 100644
index 0000000..50fb303
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_explain1_1.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cp file.in file.oout
+% <userinput>scons -Q</userinput>
+cp file.in file.oout
+% <userinput>scons -Q</userinput>
+cp file.in file.oout
+</screen>
diff --git a/doc/generated/examples/troubleshoot_explain1_2.xml b/doc/generated/examples/troubleshoot_explain1_2.xml
new file mode 100644
index 0000000..a58a2d3
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_explain1_2.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --debug=explain</userinput>
+scons: building `file.out' because it doesn't exist
+cp file.in file.oout
+</screen>
diff --git a/doc/generated/examples/troubleshoot_explain2_1.xml b/doc/generated/examples/troubleshoot_explain2_1.xml
new file mode 100644
index 0000000..3b5374f
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_explain2_1.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o file1.o -c file1.c
+cc -o file2.o -c file2.c
+cc -o file3.o -c file3.c
+cc -o prog file1.o file2.o file3.o
+% [CHANGE THE CONTENTS OF file2.c]
+% <userinput>scons -Q --debug=explain</userinput>
+scons: rebuilding `file2.o' because `file2.c' changed
+cc -o file2.o -c file2.c
+scons: rebuilding `prog' because `file2.o' changed
+cc -o prog file1.o file2.o file3.o
+</screen>
diff --git a/doc/generated/examples/troubleshoot_explain3_1.xml b/doc/generated/examples/troubleshoot_explain3_1.xml
new file mode 100644
index 0000000..7e89a26
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_explain3_1.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+cc -o file1.o -c -I. file1.c
+cc -o file2.o -c -I. file2.c
+cc -o file3.o -c -I. file3.c
+cc -o prog file1.o file2.o file3.o
+% [CHANGE THE CONTENTS OF hello.h]
+% <userinput>scons -Q --debug=explain</userinput>
+scons: rebuilding `file1.o' because `hello.h' changed
+cc -o file1.o -c -I. file1.c
+scons: rebuilding `file3.o' because `hello.h' changed
+cc -o file3.o -c -I. file3.c
+scons: rebuilding `prog' because:
+ `file1.o' changed
+ `file3.o' changed
+cc -o prog file1.o file2.o file3.o
+</screen>
diff --git a/doc/generated/examples/troubleshoot_findlibs_1.xml b/doc/generated/examples/troubleshoot_findlibs_1.xml
new file mode 100644
index 0000000..0b34b73
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_findlibs_1.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --debug=findlibs</userinput>
+ findlibs: looking for 'libfoo.a' in 'libs1' ...
+ findlibs: ... FOUND 'libfoo.a' in 'libs1'
+ findlibs: looking for 'libfoo.so' in 'libs1' ...
+ findlibs: looking for 'libfoo.so' in 'libs2' ...
+ findlibs: looking for 'libbar.a' in 'libs1' ...
+ findlibs: looking for 'libbar.a' in 'libs2' ...
+ findlibs: ... FOUND 'libbar.a' in 'libs2'
+ findlibs: looking for 'libbar.so' in 'libs1' ...
+ findlibs: looking for 'libbar.so' in 'libs2' ...
+cc -o prog.o -c prog.c
+cc -o prog prog.o -Llibs1 -Llibs2 -lfoo -lbar
+</screen>
diff --git a/doc/generated/examples/troubleshoot_stacktrace_1.xml b/doc/generated/examples/troubleshoot_stacktrace_1.xml
new file mode 100644
index 0000000..7228f77
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_stacktrace_1.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q</userinput>
+scons: *** [prog.o] Source `prog.c' not found, needed by target `prog.o'.
+</screen>
diff --git a/doc/generated/examples/troubleshoot_stacktrace_2.xml b/doc/generated/examples/troubleshoot_stacktrace_2.xml
new file mode 100644
index 0000000..6b88dd1
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_stacktrace_2.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --debug=stacktrace</userinput>
+scons: *** [prog.o] Source `prog.c' not found, needed by target `prog.o'.
+scons: internal stack trace:
+ File "bootstrap/src/engine/SCons/Job.py", line 199, in start
+ task.prepare()
+ File "bootstrap/src/engine/SCons/Script/Main.py", line 168, in prepare
+ return SCons.Taskmaster.OutOfDateTask.prepare(self)
+ File "bootstrap/src/engine/SCons/Taskmaster.py", line 189, in prepare
+ executor.prepare()
+ File "bootstrap/src/engine/SCons/Executor.py", line 392, in prepare
+ raise SCons.Errors.StopError(msg % (s, self.batches[0].targets[0]))
+</screen>
diff --git a/doc/generated/examples/troubleshoot_taskmastertrace_1.xml b/doc/generated/examples/troubleshoot_taskmastertrace_1.xml
new file mode 100644
index 0000000..f1c2582
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_taskmastertrace_1.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --taskmastertrace=- prog</userinput>
+
+Taskmaster: Looking for a node to evaluate
+Taskmaster: Considering node &lt;no_state 0 'prog'&gt; and its children:
+Taskmaster: &lt;no_state 0 'prog.o'&gt;
+Taskmaster: adjusted ref count: &lt;pending 1 'prog'&gt;, child 'prog.o'
+Taskmaster: Considering node &lt;no_state 0 'prog.o'&gt; and its children:
+Taskmaster: &lt;no_state 0 'prog.c'&gt;
+Taskmaster: &lt;no_state 0 'inc.h'&gt;
+Taskmaster: adjusted ref count: &lt;pending 1 'prog.o'&gt;, child 'prog.c'
+Taskmaster: adjusted ref count: &lt;pending 2 'prog.o'&gt;, child 'inc.h'
+Taskmaster: Considering node &lt;no_state 0 'prog.c'&gt; and its children:
+Taskmaster: Evaluating &lt;pending 0 'prog.c'&gt;
+
+Task.make_ready_current(): node &lt;pending 0 'prog.c'&gt;
+Task.prepare(): node &lt;up_to_date 0 'prog.c'&gt;
+Task.executed_with_callbacks(): node &lt;up_to_date 0 'prog.c'&gt;
+Task.postprocess(): node &lt;up_to_date 0 'prog.c'&gt;
+Task.postprocess(): removing &lt;up_to_date 0 'prog.c'&gt;
+Task.postprocess(): adjusted parent ref count &lt;pending 1 'prog.o'&gt;
+
+Taskmaster: Looking for a node to evaluate
+Taskmaster: Considering node &lt;no_state 0 'inc.h'&gt; and its children:
+Taskmaster: Evaluating &lt;pending 0 'inc.h'&gt;
+
+Task.make_ready_current(): node &lt;pending 0 'inc.h'&gt;
+Task.prepare(): node &lt;up_to_date 0 'inc.h'&gt;
+Task.executed_with_callbacks(): node &lt;up_to_date 0 'inc.h'&gt;
+Task.postprocess(): node &lt;up_to_date 0 'inc.h'&gt;
+Task.postprocess(): removing &lt;up_to_date 0 'inc.h'&gt;
+Task.postprocess(): adjusted parent ref count &lt;pending 0 'prog.o'&gt;
+
+Taskmaster: Looking for a node to evaluate
+Taskmaster: Considering node &lt;pending 0 'prog.o'&gt; and its children:
+Taskmaster: &lt;up_to_date 0 'prog.c'&gt;
+Taskmaster: &lt;up_to_date 0 'inc.h'&gt;
+Taskmaster: Evaluating &lt;pending 0 'prog.o'&gt;
+
+Task.make_ready_current(): node &lt;pending 0 'prog.o'&gt;
+Task.prepare(): node &lt;executing 0 'prog.o'&gt;
+Task.execute(): node &lt;executing 0 'prog.o'&gt;
+cc -o prog.o -c -I. prog.c
+Task.executed_with_callbacks(): node &lt;executing 0 'prog.o'&gt;
+Task.postprocess(): node &lt;executed 0 'prog.o'&gt;
+Task.postprocess(): removing &lt;executed 0 'prog.o'&gt;
+Task.postprocess(): adjusted parent ref count &lt;pending 0 'prog'&gt;
+
+Taskmaster: Looking for a node to evaluate
+Taskmaster: Considering node &lt;pending 0 'prog'&gt; and its children:
+Taskmaster: &lt;executed 0 'prog.o'&gt;
+Taskmaster: Evaluating &lt;pending 0 'prog'&gt;
+
+Task.make_ready_current(): node &lt;pending 0 'prog'&gt;
+Task.prepare(): node &lt;executing 0 'prog'&gt;
+Task.execute(): node &lt;executing 0 'prog'&gt;
+cc -o prog prog.o
+Task.executed_with_callbacks(): node &lt;executing 0 'prog'&gt;
+Task.postprocess(): node &lt;executed 0 'prog'&gt;
+
+Taskmaster: Looking for a node to evaluate
+Taskmaster: No candidate anymore.
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree1_1.xml b/doc/generated/examples/troubleshoot_tree1_1.xml
new file mode 100644
index 0000000..c082c0e
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree1_1.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=all</userinput>
+cc -o f1.o -c -I. f1.c
+cc -o f2.o -c -I. f2.c
+cc -o f3.o -c -I. f3.c
+cc -o prog f1.o f2.o f3.o
++-.
+ +-SConstruct
+ +-f1.c
+ +-f1.o
+ | +-f1.c
+ | +-inc.h
+ +-f2.c
+ +-f2.o
+ | +-f2.c
+ | +-inc.h
+ +-f3.c
+ +-f3.o
+ | +-f3.c
+ | +-inc.h
+ +-inc.h
+ +-prog
+ +-f1.o
+ | +-f1.c
+ | +-inc.h
+ +-f2.o
+ | +-f2.c
+ | +-inc.h
+ +-f3.o
+ +-f3.c
+ +-inc.h
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree1_2.xml b/doc/generated/examples/troubleshoot_tree1_2.xml
new file mode 100644
index 0000000..0a27f8b
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree1_2.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=all f2.o</userinput>
+cc -o f2.o -c -I. f2.c
++-f2.o
+ +-f2.c
+ +-inc.h
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree1_3.xml b/doc/generated/examples/troubleshoot_tree1_3.xml
new file mode 100644
index 0000000..7d26ee9
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree1_3.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=all f1.o f3.o</userinput>
+cc -o f1.o -c -I. f1.c
++-f1.o
+ +-f1.c
+ +-inc.h
+cc -o f3.o -c -I. f3.c
++-f3.o
+ +-f3.c
+ +-inc.h
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree1_4.xml b/doc/generated/examples/troubleshoot_tree1_4.xml
new file mode 100644
index 0000000..0d974db
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree1_4.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=status</userinput>
+cc -o f1.o -c -I. f1.c
+cc -o f2.o -c -I. f2.c
+cc -o f3.o -c -I. f3.c
+cc -o prog f1.o f2.o f3.o
+ E = exists
+ R = exists in repository only
+ b = implicit builder
+ B = explicit builder
+ S = side effect
+ P = precious
+ A = always build
+ C = current
+ N = no clean
+ H = no cache
+
+[E b ]+-.
+[E C ] +-SConstruct
+[E C ] +-f1.c
+[E B C ] +-f1.o
+[E C ] | +-f1.c
+[E C ] | +-inc.h
+[E C ] +-f2.c
+[E B C ] +-f2.o
+[E C ] | +-f2.c
+[E C ] | +-inc.h
+[E C ] +-f3.c
+[E B C ] +-f3.o
+[E C ] | +-f3.c
+[E C ] | +-inc.h
+[E C ] +-inc.h
+[E B C ] +-prog
+[E B C ] +-f1.o
+[E C ] | +-f1.c
+[E C ] | +-inc.h
+[E B C ] +-f2.o
+[E C ] | +-f2.c
+[E C ] | +-inc.h
+[E B C ] +-f3.o
+[E C ] +-f3.c
+[E C ] +-inc.h
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree1_5.xml b/doc/generated/examples/troubleshoot_tree1_5.xml
new file mode 100644
index 0000000..a219aef
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree1_5.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=derived</userinput>
+cc -o f1.o -c -I. f1.c
+cc -o f2.o -c -I. f2.c
+cc -o f3.o -c -I. f3.c
+cc -o prog f1.o f2.o f3.o
++-.
+ +-f1.o
+ +-f2.o
+ +-f3.o
+ +-prog
+ +-f1.o
+ +-f2.o
+ +-f3.o
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree1_6.xml b/doc/generated/examples/troubleshoot_tree1_6.xml
new file mode 100644
index 0000000..4d3c972
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree1_6.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=derived,status</userinput>
+cc -o f1.o -c -I. f1.c
+cc -o f2.o -c -I. f2.c
+cc -o f3.o -c -I. f3.c
+cc -o prog f1.o f2.o f3.o
+ E = exists
+ R = exists in repository only
+ b = implicit builder
+ B = explicit builder
+ S = side effect
+ P = precious
+ A = always build
+ C = current
+ N = no clean
+ H = no cache
+
+[E b ]+-.
+[E B C ] +-f1.o
+[E B C ] +-f2.o
+[E B C ] +-f3.o
+[E B C ] +-prog
+[E B C ] +-f1.o
+[E B C ] +-f2.o
+[E B C ] +-f3.o
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree2_1.xml b/doc/generated/examples/troubleshoot_tree2_1.xml
new file mode 100644
index 0000000..7b786e3
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree2_1.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=all</userinput>
+cc -o f1.o -c -I. f1.c
+cc -o f2.o -c -I. f2.c
+cc -o f3.o -c -I. f3.c
+ar rc libfoo.a f1.o f2.o f3.o
+ranlib libfoo.a
+cc -o prog1.o -c -I. prog1.c
+cc -o prog1 prog1.o -L. -lfoo
+cc -o prog2.o -c -I. prog2.c
+cc -o prog2 prog2.o -L. -lfoo
++-.
+ +-SConstruct
+ +-f1.c
+ +-f1.o
+ | +-f1.c
+ | +-inc.h
+ +-f2.c
+ +-f2.o
+ | +-f2.c
+ | +-inc.h
+ +-f3.c
+ +-f3.o
+ | +-f3.c
+ | +-inc.h
+ +-inc.h
+ +-libfoo.a
+ | +-f1.o
+ | | +-f1.c
+ | | +-inc.h
+ | +-f2.o
+ | | +-f2.c
+ | | +-inc.h
+ | +-f3.o
+ | +-f3.c
+ | +-inc.h
+ +-prog1
+ | +-prog1.o
+ | | +-prog1.c
+ | | +-inc.h
+ | +-libfoo.a
+ | +-f1.o
+ | | +-f1.c
+ | | +-inc.h
+ | +-f2.o
+ | | +-f2.c
+ | | +-inc.h
+ | +-f3.o
+ | +-f3.c
+ | +-inc.h
+ +-prog1.c
+ +-prog1.o
+ | +-prog1.c
+ | +-inc.h
+ +-prog2
+ | +-prog2.o
+ | | +-prog2.c
+ | | +-inc.h
+ | +-libfoo.a
+ | +-f1.o
+ | | +-f1.c
+ | | +-inc.h
+ | +-f2.o
+ | | +-f2.c
+ | | +-inc.h
+ | +-f3.o
+ | +-f3.c
+ | +-inc.h
+ +-prog2.c
+ +-prog2.o
+ +-prog2.c
+ +-inc.h
+</screen>
diff --git a/doc/generated/examples/troubleshoot_tree2_2.xml b/doc/generated/examples/troubleshoot_tree2_2.xml
new file mode 100644
index 0000000..2338622
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_tree2_2.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --tree=prune</userinput>
+cc -o f1.o -c -I. f1.c
+cc -o f2.o -c -I. f2.c
+cc -o f3.o -c -I. f3.c
+ar rc libfoo.a f1.o f2.o f3.o
+ranlib libfoo.a
+cc -o prog1.o -c -I. prog1.c
+cc -o prog1 prog1.o -L. -lfoo
+cc -o prog2.o -c -I. prog2.c
+cc -o prog2 prog2.o -L. -lfoo
++-.
+ +-SConstruct
+ +-f1.c
+ +-f1.o
+ | +-f1.c
+ | +-inc.h
+ +-f2.c
+ +-f2.o
+ | +-f2.c
+ | +-inc.h
+ +-f3.c
+ +-f3.o
+ | +-f3.c
+ | +-inc.h
+ +-inc.h
+ +-libfoo.a
+ | +-[f1.o]
+ | +-[f2.o]
+ | +-[f3.o]
+ +-prog1
+ | +-prog1.o
+ | | +-prog1.c
+ | | +-inc.h
+ | +-[libfoo.a]
+ +-prog1.c
+ +-[prog1.o]
+ +-prog2
+ | +-prog2.o
+ | | +-prog2.c
+ | | +-inc.h
+ | +-[libfoo.a]
+ +-prog2.c
+ +-[prog2.o]
+</screen>
diff --git a/doc/generated/examples/variants_ex_1.xml b/doc/generated/examples/variants_ex_1.xml
new file mode 100644
index 0000000..cbc47ab
--- /dev/null
+++ b/doc/generated/examples/variants_ex_1.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q OS=linux</userinput>
+Install file: "build/linux/world/world.h" as "export/linux/include/world.h"
+cc -o build/linux/hello/hello.o -c -Iexport/linux/include build/linux/hello/hello.c
+cc -o build/linux/world/world.o -c -Iexport/linux/include build/linux/world/world.c
+ar rc build/linux/world/libworld.a build/linux/world/world.o
+ranlib build/linux/world/libworld.a
+Install file: "build/linux/world/libworld.a" as "export/linux/lib/libworld.a"
+cc -o build/linux/hello/hello build/linux/hello/hello.o -Lexport/linux/lib -lworld
+Install file: "build/linux/hello/hello" as "export/linux/bin/hello"
+</screen>
diff --git a/doc/generated/examples/variants_ex_2.xml b/doc/generated/examples/variants_ex_2.xml
new file mode 100644
index 0000000..ac883de
--- /dev/null
+++ b/doc/generated/examples/variants_ex_2.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">C:\&gt;<userinput>scons -Q OS=windows</userinput>
+Install file: "build/windows/world/world.h" as "export/windows/include/world.h"
+cl /Fobuild\windows\hello\hello.obj /c build\windows\hello\hello.c /nologo /Iexport\windows\include
+cl /Fobuild\windows\world\world.obj /c build\windows\world\world.c /nologo /Iexport\windows\include
+lib /nologo /OUT:build\windows\world\world.lib build\windows\world\world.obj
+Install file: "build/windows/world/world.lib" as "export/windows/lib/world.lib"
+link /nologo /OUT:build\windows\hello\hello.exe /LIBPATH:export\windows\lib world.lib build\windows\hello\hello.obj
+embedManifestExeCheck(target, source, env)
+Install file: "build/windows/hello/hello.exe" as "export/windows/bin/hello.exe"
+</screen>