diff options
author | Steven Knight <knight@baldmt.com> | 2006-02-13 03:52:41 (GMT) |
---|---|---|
committer | Steven Knight <knight@baldmt.com> | 2006-02-13 03:52:41 (GMT) |
commit | 804ff6d25ac70aabcd913fe44d441799867a7dd7 (patch) | |
tree | 004e8fcfa1e69736fcbbf7590da8036b9a8ae4eb /doc/user/precious.sgml | |
parent | f325a0ceb04f04d045862eee8373a586011e4ebf (diff) | |
download | SCons-804ff6d25ac70aabcd913fe44d441799867a7dd7.zip SCons-804ff6d25ac70aabcd913fe44d441799867a7dd7.tar.gz SCons-804ff6d25ac70aabcd913fe44d441799867a7dd7.tar.bz2 |
Add a NoClean() function. (Steven Johnson)
Diffstat (limited to 'doc/user/precious.sgml')
-rw-r--r-- | doc/user/precious.sgml | 84 |
1 files changed, 0 insertions, 84 deletions
diff --git a/doc/user/precious.sgml b/doc/user/precious.sgml deleted file mode 100644 index 6e80c85..0000000 --- a/doc/user/precious.sgml +++ /dev/null @@ -1,84 +0,0 @@ -<!-- - - __COPYRIGHT__ - - Permission is hereby granted, free of charge, to any person obtaining - a copy of this software and associated documentation files (the - "Software"), to deal in the Software without restriction, including - without limitation the rights to use, copy, modify, merge, publish, - distribute, sublicense, and/or sell copies of the Software, and to - permit persons to whom the Software is furnished to do so, subject to - the following conditions: - - The above copyright notice and this permission notice shall be included - in all copies or substantial portions of the Software. - - THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY - KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE - WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND - NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE - LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION - OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION - WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - ---> - -<!-- - -=head2 The C<AfterBuild> method - -The C<AfterBuild> method evaluates the specified perl string after -building the given file or files (or finding that they are up to date). -The eval will happen once per specified file. C<AfterBuild> is called -as follows: - - AfterBuild $env 'foo.o', qq(print "foo.o is up to date!\n"); - -The perl string is evaluated in the C<script> package, and has access -to all variables and subroutines defined in the F<Conscript> file in -which the C<AfterBuild> method is called. - ---> - - <para> - - By default, &SCons; removes targets before building them. - Sometimes, however, this is not what you want. - For example, you may want to update a library incrementally, - not by having it deleted and then rebuilt from all - of the constituent object files. - In such cases, you can use the - &Precious; method to prevent - &SCons; from removing the target before it is built: - - </para> - - <programlisting> - env = Environment() - lib = env.Library('foo', ['f1.c', 'f2.c', 'f3.c']) - env.Precious(lib) - </programlisting> - - <para> - - Although the output doesn't look any different, - &SCons; does not, in fact, - delete the target library before rebuilding it: - - </para> - - <screen> - % <userinput>scons -Q</userinput> - cc -c -o f1.o f1.c - cc -c -o f2.o f2.c - cc -c -o f3.o f3.c - ar r libfoo.a f1.o f2.o f3.o - ranlib libfoo.a - </screen> - - <para> - - &SCons; will, however, still delete files marked as &Precious; - when the <literal>-c</literal> option is used. - - </para> |