summaryrefslogtreecommitdiff
path: root/doc/man/scons.xml
diff options
context:
space:
mode:
authorWilliam Deegan <bill@baddogconsulting.com>2017-06-20 18:27:16 +0000
committerWilliam Deegan <bill@baddogconsulting.com>2017-06-20 18:27:16 +0000
commit6278b8158495c2b72480d083de85e6cbbac02e97 (patch)
treee543d978cb355faf9898b7477cf39d7f3cee6825 /doc/man/scons.xml
parent708de3f2daef718632216ca19ab0674293884929 (diff)
parentc7e8750d36e818f04fb4c5780c704d504cf2be6d (diff)
downloadscons-6278b8158495c2b72480d083de85e6cbbac02e97.tar.gz
Merged in grbd/scons (pull request #481)
Addition of support for nested tools, tools within a sub-directory
Diffstat (limited to 'doc/man/scons.xml')
-rw-r--r--doc/man/scons.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/man/scons.xml b/doc/man/scons.xml
index b68f27ae..3268860b 100644
--- a/doc/man/scons.xml
+++ b/doc/man/scons.xml
@@ -2187,6 +2187,22 @@ platform name when the Environment is constructed. Changing the PATH
variable after the Environment is constructed will not cause the tools to
be redetected.</para>
+<para> One feature now present within Scons is the ability to have nested tools.
+Tools which can be located within a subdirectory in the toolpath.
+With a nested tool name the dot represents a directory seperator</para>
+
+<programlisting>
+# namespaced builder
+env = Environment(ENV = os.environ, tools = ['SubDir1.SubDir2.SomeTool'])
+env.SomeTool(targets, sources)
+
+# Search Paths
+# SCons\Tool\SubDir1\SubDir2\SomeTool.py
+# SCons\Tool\SubDir1\SubDir2\SomeTool\__init__.py
+# .\site_scons\site_tools\SubDir1\SubDir2\SomeTool.py
+# .\site_scons\site_tools\SubDir1\SubDir2\SomeTool\__init__.py
+</programlisting>
+
<para>SCons supports the following tool specifications out of the box:</para>
<!-- '\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -->