mirror of
https://github.com/Relintai/scons_gd.git
synced 2025-03-12 18:38:59 +01:00
88 lines
2.6 KiB
XML
88 lines
2.6 KiB
XML
|
<?xml version='1.0'?>
|
||
|
|
<!DOCTYPE sconsdoc [
|
||
|
|
<!ENTITY % scons SYSTEM "../scons.mod">
|
||
|
|
%scons;
|
||
|
|
]>
|
||
|
|
|
||
|
|
<section id="sect-Command"
|
||
|
|
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 http://www.scons.org/dbxsd/v1.0/scons.xsd">
|
||
|
|
<title>The Command Builder</title>
|
||
|
|
|
||
|
|
<!--
|
||
|
|
|
||
|
|
__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<Command> method
|
||
|
|
|
||
|
|
The C<Command> method is a catchall method which can be used to arrange for
|
||
|
|
any build action to be executed to update the target. For this command, a
|
||
|
|
target file and list of inputs is provided. In addition, a build action
|
||
|
|
is specified as the last argument. The build action is typically a
|
||
|
|
command line or lines, but may also contain Perl code to be executed;
|
||
|
|
see the section above on build actions for details.
|
||
|
|
|
||
|
|
The C<Command> method is called as follows:
|
||
|
|
|
||
|
|
Command $env <target>, <inputs>, <build action>;
|
||
|
|
|
||
|
|
The target is made dependent upon the list of input files specified, and the
|
||
|
|
inputs must be built successfully or Cons will not attempt to build the
|
||
|
|
target.
|
||
|
|
|
||
|
|
To specify a command with multiple targets, you can specify a reference to a
|
||
|
|
list of targets. In Perl, a list reference can be created by enclosing a
|
||
|
|
list in square brackets. Hence the following command:
|
||
|
|
|
||
|
|
Command $env ['foo.h', 'foo.c'], 'foo.template', q(
|
||
|
|
gen %1
|
||
|
|
);
|
||
|
|
|
||
|
|
could be used in a case where the command C<gen> creates two files, both
|
||
|
|
F<foo.h> and F<foo.c>.
|
||
|
|
|
||
|
|
-->
|
||
|
|
|
||
|
|
<para>
|
||
|
|
|
||
|
|
X
|
||
|
|
|
||
|
|
</para>
|
||
|
|
|
||
|
|
<section>
|
||
|
|
<title>The &Command; Method</title>
|
||
|
|
|
||
|
|
<para>
|
||
|
|
|
||
|
|
X
|
||
|
|
|
||
|
|
</para>
|
||
|
|
|
||
|
|
</section>
|
||
|
|
|
||
|
|
</section>
|