diff options
author | Steven Knight <knight@baldmt.com> | 2005-01-04 13:23:05 (GMT) |
---|---|---|
committer | Steven Knight <knight@baldmt.com> | 2005-01-04 13:23:05 (GMT) |
commit | d93f05865083c27a642cb2db5fe0729e550cccfe (patch) | |
tree | bb3d22ae7ad6c96ff18ec746a6d676807dfb05fc /doc | |
parent | 916ed5005004b8beeaf07da497066853c7821755 (diff) | |
download | SCons-d93f05865083c27a642cb2db5fe0729e550cccfe.zip SCons-d93f05865083c27a642cb2db5fe0729e550cccfe.tar.gz SCons-d93f05865083c27a642cb2db5fe0729e550cccfe.tar.bz2 |
Have ParseDepends() env.subst() the specified file name. Add an only_one keyword argument that will sanity check that the file only contains one dependency target.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man/scons.1 | 26 |
1 files changed, 24 insertions, 2 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1 index 16a7986..417ced4 100644 --- a/doc/man/scons.1 +++ b/doc/man/scons.1 @@ -3318,7 +3318,7 @@ construction variable. .TP .RI ParseDepends( filename ", [" must_exist ]) .TP -.RI env.ParseDepends( filename ", [" must_exist ]) +.RI env.ParseDepends( filename ", [" must_exist " " only_one ]) Parses the contents of the specified .I filename as a list of dependencies in the style of @@ -3326,6 +3326,7 @@ as a list of dependencies in the style of or .BR mkdep , and explicitly establishes all of the listed dependencies. + By default, it is not an error if the specified @@ -3339,13 +3340,34 @@ scons throw an exception and generate an error if the file does not exist, or is otherwise inaccessible. + +The optional +.I only_one +argument may be set to a non-zero +value to have +scons +thrown an exception and +generate an error +if the file contains dependency +information for more than one target. +This can provide a small sanity check +for files intended to be generated +by, for example, the +.B gcc -M +flag, +which should typically only +write dependency information for +one output file into a corresponding +.B .d +file. + The .I filename and all of the files listed therein will be interpreted relative to the directory of the .I SConscript -file which called the +file which calls the .B ParseDepends function. |