From: garyo <garyo@fdb21ef1-2011-0410-befe-b5e4ea1792b1>
Date: Thu, 2 Oct 2008 01:43:53 +0000 (+0000)
Subject: Add Users Guide example of using $SOURCE substitution in a target name in a Command... 
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=26ab6d070c704b6f7e21522dc0a038022c647643;p=scons.git

Add Users Guide example of using $SOURCE substitution in a target name in a Command builder.  Just doc.

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

diff --git a/doc/user/builders-commands.in b/doc/user/builders-commands.in
index 7265a233..d8240522 100644
--- a/doc/user/builders-commands.in
+++ b/doc/user/builders-commands.in
@@ -131,3 +131,26 @@
   <scons_output example="ex2">
     <scons_output_command>scons -Q</scons_output_command>
   </scons_output>
+
+  <para>
+
+  Note that &cv-link-SOURCE; and &cv-link-TARGET; are expanded 
+  in the source and target as well as of SCons 1.1,
+  so you can write:
+
+  </para>
+
+  <scons_example name="ex3">
+     <file name="SConstruct" printme="1">
+     env.Command('${SOURCE.basename}.out', 'foo.in', build)
+     </file>
+  </scons_example>
+
+
+  <para>
+
+  which does the same thing as the previous example, but allows you
+  to avoid repeating yourself.
+
+  </para>
+
diff --git a/doc/user/builders-commands.xml b/doc/user/builders-commands.xml
index 15a6015c..fcb2a96d 100644
--- a/doc/user/builders-commands.xml
+++ b/doc/user/builders-commands.xml
@@ -123,3 +123,24 @@
     % <userinput>scons -Q</userinput>
     build(["foo.out"], ["foo.in"])
   </screen>
+
+  <para>
+
+  Note that &cv-link-SOURCE; and &cv-link-TARGET; are expanded 
+  in the source and target as well as of SCons 1.1,
+  so you can write:
+
+  </para>
+
+  <programlisting>
+     env.Command('${SOURCE.basename}.out', 'foo.in', build)
+  </programlisting>
+
+
+  <para>
+
+  which does the same thing as the previous example, but allows you
+  to avoid repeating yourself.
+
+  </para>
+