-
-
Notifications
You must be signed in to change notification settings - Fork 320
/
apbs24.html
47 lines (39 loc) · 7.15 KB
/
apbs24.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.24 PhingTask</title><link rel="stylesheet" type="text/css" href="book.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Phing User Guide"><link rel="up" href="apb.html" title="Appendix B. Core tasks"><link rel="prev" href="apbs23.html" title="B.23 MoveTask"><link rel="next" href="apbs25.html" title="B.25 PhingCallTask"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.24 PhingTask </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="apbs23.html">Prev</a> </td><th width="60%" align="center">Appendix B. Core tasks</th><td width="20%" align="right"> <a accesskey="n" href="apbs25.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="PhingTask"></a>B.24 PhingTask </h2></div></div></div>
<p>This task calls another build file. You may specify the target that is to be called
within the build file. Additionally, the <code class="literal"><phing></code> Tag may contain
<code class="literal"><property></code> Tags (see <a class="xref" href="apbs27.html" title="B.27 PropertyTask">Section B.27, “PropertyTask ”</a>).</p>
<div class="table"><a name="idp47494528"></a><p class="formal-object-title"><span class="label">Table B.24: </span><span class="title">Attributes</span></p><div class="table-contents">
<table summary="Attributes" border="1"><colgroup><col class="name"><col class="type"><col class="description"><col class="default"><col class="required"></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th><th>Required</th></tr></thead><tbody><tr><td><code class="literal">inheritAll</code></td><td><code class="literal">Boolean</code></td><td>If true, pass all properties to the new phing project.</td><td><code class="literal">true</code></td><td>No</td></tr><tr><td><code class="literal">inheritRefs</code></td><td><code class="literal">Boolean</code></td><td>If true, pass all references to the new phing project.</td><td><code class="literal">false</code></td><td>No</td></tr><tr><td><code class="literal">dir</code></td><td><code class="literal">String</code></td><td>The directory to use as a base directory for the new phing project.
Default is the current project's basedir, unless inheritall has been set
to <code class="literal">false</code>, in which case it doesn't have a default
value. This will override the basedir setting of the called
project.</td><td>n/a</td><td>No</td></tr><tr><td><code class="literal">phingFile</code></td><td><code class="literal">String</code></td><td>The build file to use. Defaults to "build.xml". This file is expected
to be a filename relative to the dir attribute given.</td><td>n/a</td><td>Yes</td></tr><tr><td><code class="literal">target</code></td><td><code class="literal">String</code></td><td>The target of the new Phing project to execute. Default is the new
project's default target.</td><td>n/a</td><td>No</td></tr><tr><td><code class="literal">haltonfailure</code></td><td><code class="literal">Boolean</code></td><td>If true, fail the build process when the called build fails</td><td><code class="literal">false</code></td><td>No</td></tr></tbody></table>
</div></div><br class="table-break">
<div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp47527600"></a>B.24.1 Examples</h3></div></div></div>
<pre class="programlisting"><!-- Call target "xslttest" from buildfile "alternativebuildfile.xml" -->
<phing phingfile="alternativebuild.xml" inheritRefs="true" target="xslttest" />
<!-- Do a more complex call -->
<phing phingfile="somebuild.xml" target="sometarget">
<property name="foo" value="bar" />
<property name="anotherone" value="32" />
</phing></pre>
</div>
<div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp47529776"></a>B.24.2 Supported Nested Tags</h3></div></div></div>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
<p><code class="literal"><a class="link" href="apds03.html" title="D.3 FileSet">fileset</a></code></p>
</li></ul></div>
</div>
<div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp47533136"></a>B.24.3 Base directory of the new project</h3></div></div></div>
<p>The base directory of the new project is set dependant on the <code class="literal">dir</code> and
the <code class="literal">inheritAll</code> attribute. This is important to keep in mind or
else you might run into bugs in your<code class="filename"> build.xml</code>'s. The following
table shows when which value is used:</p>
<div class="table"><a name="idp47535840"></a><p class="formal-object-title"><span class="label">Table B.25: </span><span class="title">How attributes are used</span></p><div class="table-contents">
<table summary="How attributes are used" border="1"><colgroup><col class="name"><col class="type"><col class="description"></colgroup><thead><tr><th><code class="literal">dir</code></th><th><code class="literal">inheritAll</code></th><th>new project's basedir</th></tr></thead><tbody><tr><td>value provided</td><td><code class="literal">true</code></td><td>value of <code class="literal">dir</code> attribute</td></tr><tr><td>value provided</td><td><code class="literal">false</code></td><td>value of <code class="literal">dir</code> attribute</td></tr><tr><td><code class="literal">omitted</code></td><td><code class="literal">true</code></td><td>basedir of calling task (the build file containing the
<code class="literal"><phing></code> call.</td></tr><tr><td><code class="literal">omitted</code></td><td><code class="literal">false</code></td><td>basedir attribute of the <code class="literal"><project></code> element
of the new project</td></tr></tbody></table>
</div></div><br class="table-break">
</div>
</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="apbs23.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="apb.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="apbs25.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">B.23 MoveTask </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> B.25 PhingCallTask </td></tr></table></div></body></html>