@@ -200,21 +200,21 @@ directory <samp>common</samp> inside the jar file <samp>common.jar</samp>.</p> | |||||
<p>The short version: Use <code>import</code> if you intend to override a target, otherwise | <p>The short version: Use <code>import</code> if you intend to override a target, otherwise | ||||
use <code>include</code>.</p> | use <code>include</code>.</p> | ||||
<p>When using <code>import</code> the imported targets are available by up to two names. Their | |||||
<p>When <code>import</code> is used, the imported targets are available by up to two names: their | |||||
"normal" name without any prefix and potentially with a prefixed name (the value of | "normal" name without any prefix and potentially with a prefixed name (the value of | ||||
the <var>as</var> attribute or the imported project's <var>name</var> attribute, if any).</p> | the <var>as</var> attribute or the imported project's <var>name</var> attribute, if any).</p> | ||||
<p>When using <code>include</code> the included targets are only available in the prefixed form.</p> | |||||
<p>When <code>include</code> is used, the included targets are only available in the prefixed form.</p> | |||||
<p>When using <code>import</code>, the imported target's <var>depends</var> attribute remains | |||||
<p>When <code>import</code> is used, the imported target's <var>depends</var> attribute remains | |||||
unchanged, i.e. it uses "normal" names and allows you to override targets in the dependency | unchanged, i.e. it uses "normal" names and allows you to override targets in the dependency | ||||
list.</p> | list.</p> | ||||
<p>When using <code>include</code>, the included targets cannot be overridden and | |||||
<p>When <code>include</code> is used, the included targets cannot be overridden and | |||||
their <var>depends</var> attributes are rewritten so that prefixed names are used. This allows | their <var>depends</var> attributes are rewritten so that prefixed names are used. This allows | ||||
writers of the included file to control which target is invoked as part of the dependencies.</p> | writers of the included file to control which target is invoked as part of the dependencies.</p> | ||||
<p>It is possible to <code>include</code> the same file more than once by using different prefixes, | |||||
<p>It is possible to <code>include</code> the same file more than once by using different prefixes; | |||||
it is not possible to <code>import</code> the same file more than once.</p> | it is not possible to <code>import</code> the same file more than once.</p> | ||||
<h4>Examples</h4> | <h4>Examples</h4> | ||||
@@ -195,21 +195,21 @@ directory <samp>common</samp> inside the jar file <samp>common.jar</samp>.</p> | |||||
<p>The short version: Use <code>import</code> if you intend to override a target, otherwise | <p>The short version: Use <code>import</code> if you intend to override a target, otherwise | ||||
use <code>include</code>.</p> | use <code>include</code>.</p> | ||||
<p>When using <code>import</code> the imported targets are available by up to two names. Their | |||||
<p>When <code>import</code> is used, the imported targets are available by up to two names: their | |||||
"normal" name without any prefix and potentially with a prefixed name (the value of | "normal" name without any prefix and potentially with a prefixed name (the value of | ||||
the <var>as</var> attribute or the imported project's <var>name</var> attribute, if any).</p> | the <var>as</var> attribute or the imported project's <var>name</var> attribute, if any).</p> | ||||
<p>When using <code>include</code> the included targets are only available in the prefixed form.</p> | |||||
<p>When <code>include</code> is used, the included targets are only available in the prefixed form.</p> | |||||
<p>When using <code>import</code>, the imported target's <var>depends</var> attribute remains | |||||
<p>When <code>import</code> is used, the imported target's <var>depends</var> attribute remains | |||||
unchanged, i.e. it uses "normal" names and allows you to override targets in the dependency | unchanged, i.e. it uses "normal" names and allows you to override targets in the dependency | ||||
list.</p> | list.</p> | ||||
<p>When using <code>include</code>, the included targets cannot be overridden and | |||||
<p>When <code>include</code> is used, the included targets cannot be overridden and | |||||
their <var>depends</var> attributes are rewritten so that prefixed names are used. This allows | their <var>depends</var> attributes are rewritten so that prefixed names are used. This allows | ||||
writers of the included file to control which target is invoked as part of the dependencies.</p> | writers of the included file to control which target is invoked as part of the dependencies.</p> | ||||
<p>It is possible to <code>include</code> the same file more than once by using different prefixes, | |||||
<p>It is possible to <code>include</code> the same file more than once by using different prefixes; | |||||
it is not possible to <code>import</code> the same file more than once.</p> | it is not possible to <code>import</code> the same file more than once.</p> | ||||
<h4>Examples</h4> | <h4>Examples</h4> | ||||