uniform style of notes and new feature markersmaster
| @@ -59,7 +59,7 @@ parameterize your subprojects.</p> | |||||
| <p>Properties defined on the command line cannot be overridden by | <p>Properties defined on the command line cannot be overridden by | ||||
| nested <code><property></code> elements. <em>Since Ant | nested <code><property></code> elements. <em>Since Ant | ||||
| 1.8.0.</em> the same is true for nested structures | |||||
| 1.8.0</em> the same is true for nested structures | |||||
| of <code><ant></code> tasks: if a build file <em>A</em> | of <code><ant></code> tasks: if a build file <em>A</em> | ||||
| invokes <em>B</em> via an <code><ant></code> task setting a | invokes <em>B</em> via an <code><ant></code> task setting a | ||||
| property with a nested <code><property></code> element | property with a nested <code><property></code> element | ||||
| @@ -42,7 +42,7 @@ | |||||
| supergrammar specified by the glib attribute) is newer than the | supergrammar specified by the glib attribute) is newer than the | ||||
| generated files. | generated files. | ||||
| </p> | </p> | ||||
| <p><strong>Note:</strong> This task depends on external libraries not | |||||
| <p><strong>Note</strong>: This task depends on external libraries not | |||||
| included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information.</p> | for more information.</p> | ||||
| <p>Antlr 2.7.1 Note: | <p>Antlr 2.7.1 Note: | ||||
| @@ -29,7 +29,7 @@ | |||||
| <p> | <p> | ||||
| Stores the Apache Ant version (when used as task) or checks for a specific Ant version | Stores the Apache Ant version (when used as task) or checks for a specific Ant version | ||||
| (when used as condition). | (when used as condition). | ||||
| <b>Since Ant 1.7.0</b> | |||||
| <em>Since Ant 1.7.0</em> | |||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| @@ -95,7 +95,7 @@ to send input to it is via the input and inputstring attributes.</p> | |||||
| <td valign="top">dir</td> | <td valign="top">dir</td> | ||||
| <td valign="top">the directory in which the command should be executed.</td> | <td valign="top">the directory in which the command should be executed.</td> | ||||
| <td align="center" valign="top">No.<br/> | <td align="center" valign="top">No.<br/> | ||||
| <strong>Note:</strong> the default used when dir has not been | |||||
| <strong>Note</strong>: the default used when dir has not been | |||||
| specified depends on the <code>vmlauncher</code> attribute. If | specified depends on the <code>vmlauncher</code> attribute. If | ||||
| <code>vmlauncher</code> is <code>true</code> the task will use | <code>vmlauncher</code> is <code>true</code> the task will use | ||||
| the current working directory, otherwise it uses the project's basedir. | the current working directory, otherwise it uses the project's basedir. | ||||
| @@ -233,7 +233,7 @@ to send input to it is via the input and inputstring attributes.</p> | |||||
| <i>both</i>. If set to <i>file</i>, only the names of plain | <i>both</i>. If set to <i>file</i>, only the names of plain | ||||
| files will be sent to the command. If set to <i>dir</i>, only | files will be sent to the command. If set to <i>dir</i>, only | ||||
| the names of directories are considered.<br> | the names of directories are considered.<br> | ||||
| <strong>Note:</strong> The type attribute does not apply to | |||||
| <strong>Note</strong>: The type attribute does not apply to | |||||
| nested <i>dirset</i>s - <i>dirset</i>s always implicitly | nested <i>dirset</i>s - <i>dirset</i>s always implicitly | ||||
| assume type to be <i>dir</i>.</td> | assume type to be <i>dir</i>.</td> | ||||
| <td align="center" valign="top">No, default is <i>file</i></td> | <td align="center" valign="top">No, default is <i>file</i></td> | ||||
| @@ -272,31 +272,31 @@ to send input to it is via the input and inputstring attributes.</p> | |||||
| <td valign="top">maxparallel</td> | <td valign="top">maxparallel</td> | ||||
| <td valign="top">Limit the amount of parallelism by passing at | <td valign="top">Limit the amount of parallelism by passing at | ||||
| most this many sourcefiles at once. Set it to <= 0 for | most this many sourcefiles at once. Set it to <= 0 for | ||||
| unlimited. <em>Since Ant 1.6.</em></td> | |||||
| unlimited. <em>Since Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No, unlimited by default</td> | <td align="center" valign="top">No, unlimited by default</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">addsourcefile</td> | <td valign="top">addsourcefile</td> | ||||
| <td valign="top">Whether source file names should be added to the | <td valign="top">Whether source file names should be added to the | ||||
| command automatically. <em>Since Ant 1.6.</em></td> | |||||
| command automatically. <em>Since Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No, default is <i>true</i></td> | <td align="center" valign="top">No, default is <i>true</i></td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">verbose</td> | <td valign="top">verbose</td> | ||||
| <td valign="top">Whether to print a summary after execution or not. | <td valign="top">Whether to print a summary after execution or not. | ||||
| <em>Since Ant 1.6.</em></td> | |||||
| <em>Since Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No, default <i>false</i></td> | <td align="center" valign="top">No, default <i>false</i></td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">ignoremissing</td> | <td valign="top">ignoremissing</td> | ||||
| <td valign="top">Whether to ignore nonexistent files specified | <td valign="top">Whether to ignore nonexistent files specified | ||||
| via filelists. <em>Since Ant 1.6.2.</em></td> | |||||
| via filelists. <em>Since Ant 1.6.2</em>.</td> | |||||
| <td align="center" valign="top">No, default is <i>true</i></td> | <td align="center" valign="top">No, default is <i>true</i></td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">force</td> | <td valign="top">force</td> | ||||
| <td valign="top">Whether to bypass timestamp comparisons | <td valign="top">Whether to bypass timestamp comparisons | ||||
| for target files. <em>Since Ant 1.6.3.</em></td> | |||||
| for target files. <em>Since Ant 1.6.3</em>.</td> | |||||
| <td align="center" valign="top">No, default is <i>false</i></td> | <td align="center" valign="top">No, default is <i>false</i></td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| @@ -386,7 +386,7 @@ specified if you also define a nested mapper.</p> | |||||
| system command via nested <code><env></code> elements. See the | system command via nested <code><env></code> elements. See the | ||||
| description in the section about <a href="exec.html#env">exec</a></p> | description in the section about <a href="exec.html#env">exec</a></p> | ||||
| <h4>redirector</h4> | <h4>redirector</h4> | ||||
| <i><b>Since Ant 1.6.2</b></i> | |||||
| <em>Since Ant 1.6.2</em> | |||||
| <p>A nested <a href="../Types/redirector.html">I/O Redirector</a> | <p>A nested <a href="../Types/redirector.html">I/O Redirector</a> | ||||
| can be specified. <apply>'s behavior is like that of | can be specified. <apply>'s behavior is like that of | ||||
| <a href="exec.html#redirector">exec</a> with regard to | <a href="exec.html#redirector">exec</a> with regard to | ||||
| @@ -25,7 +25,7 @@ | |||||
| <body> | <body> | ||||
| <h2 id="attrib">Attrib</h2> | <h2 id="attrib">Attrib</h2> | ||||
| <p><em>Since Apache Ant 1.6.</em></p> | |||||
| <p><em>Since Apache Ant 1.6</em>.</p> | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Changes the attributes of a file or all files inside specified | <p>Changes the attributes of a file or all files inside specified | ||||
| @@ -39,7 +39,7 @@ href="../Types/filelist.html">FileList</a>s can be specified using | |||||
| nested <code><fileset></code>, <code><dirset></code> and | nested <code><fileset></code>, <code><dirset></code> and | ||||
| <code><filelist></code> elements.</p> | <code><filelist></code> elements.</p> | ||||
| <p>Starting with Ant 1.7, this task supports arbitrary <a | |||||
| <p><em>Since Ant 1.7</em>, this task supports arbitrary <a | |||||
| href="../Types/resources.html#collection">Resource Collection</a>s | href="../Types/resources.html#collection">Resource Collection</a>s | ||||
| as nested elements.</p> | as nested elements.</p> | ||||
| @@ -96,7 +96,7 @@ directory tree), so you'll have to experiment a little.</p--> | |||||
| <td valign="top">One of <i>file</i>, <i>dir</i> or <i>both</i>. If set to | <td valign="top">One of <i>file</i>, <i>dir</i> or <i>both</i>. If set to | ||||
| <i>file</i>, only the permissions of plain files are going to be changed. | <i>file</i>, only the permissions of plain files are going to be changed. | ||||
| If set to <i>dir</i>, only the directories are considered.<br> | If set to <i>dir</i>, only the directories are considered.<br> | ||||
| <strong>Note:</strong> The type attribute does not apply to | |||||
| <strong>Note</strong>: The type attribute does not apply to | |||||
| nested <i>dirset</i>s - <i>dirset</i>s always implicitly | nested <i>dirset</i>s - <i>dirset</i>s always implicitly | ||||
| assume type to be <i>dir</i>.</td> | assume type to be <i>dir</i>.</td> | ||||
| <td align="center" valign="top">No, default is <i>file</i></td> | <td align="center" valign="top">No, default is <i>file</i></td> | ||||
| @@ -117,7 +117,7 @@ directory tree), so you'll have to experiment a little.</p--> | |||||
| <td valign="top">maxparallel</td> | <td valign="top">maxparallel</td> | ||||
| <td valign="top">Limit the amount of parallelism by passing at | <td valign="top">Limit the amount of parallelism by passing at | ||||
| most this many sourcefiles at once. Set it to <= 0 for | most this many sourcefiles at once. Set it to <= 0 for | ||||
| unlimited. Defaults to unlimited. <em>Since Ant 1.6.</em></td> | |||||
| unlimited. Defaults to unlimited. <em>Since Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr--> | </tr--> | ||||
| <tr> | <tr> | ||||
| @@ -32,7 +32,7 @@ mapped as XML attributes. This is an unusual task that makes use of Ant's intern | |||||
| processing mechanisms to reload a previously declared reference by means of the 'id' | processing mechanisms to reload a previously declared reference by means of the 'id' | ||||
| attribute, then treats the declared <code>augment</code> element as though it were the | attribute, then treats the declared <code>augment</code> element as though it were the | ||||
| original element. | original element. | ||||
| <b>Since Apache Ant 1.8.1</b></p> | |||||
| <em>Since Apache Ant 1.8.1</em></p> | |||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| <table> | <table> | ||||
| @@ -40,7 +40,7 @@ on some other project which import them. This task helps then to modify the | |||||
| target dependencies but only in your context. | target dependencies but only in your context. | ||||
| </p> | </p> | ||||
| <p>Note: this task is quite equivalent to the definition of an intermediate | |||||
| <p><strong>Note</strong>: this task is quite equivalent to the definition of an intermediate | |||||
| target which will be the bridge between the target to bind and the extension | target which will be the bridge between the target to bind and the extension | ||||
| point. For instance: | point. For instance: | ||||
| </p> | </p> | ||||
| @@ -55,7 +55,7 @@ This task basically avoid the creation of a target. | |||||
| it may not be used in a target. This is making the target dependency graph static | it may not be used in a target. This is making the target dependency graph static | ||||
| and predictable as soon as every build file is loaded.</p> | and predictable as soon as every build file is loaded.</p> | ||||
| <p><b>Since Apache Ant 1.8.2</b></p> | |||||
| <p><em>Since Apache Ant 1.8.2</em></p> | |||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| <table> | <table> | ||||
| @@ -59,7 +59,7 @@ operation may fail when using such an incompatible client. | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">package</td> | <td valign="top">package</td> | ||||
| <td valign="top">the package/module to check out. <b>Note:</b> | |||||
| <td valign="top">the package/module to check out. <strong>Note</strong>: | |||||
| multiple attributes can be split using spaces. Use a nested | multiple attributes can be split using spaces. Use a nested | ||||
| <module> element if you want to specify a module with | <module> element if you want to specify a module with | ||||
| spaces in its name.</td> | spaces in its name.</td> | ||||
| @@ -25,7 +25,7 @@ | |||||
| <body> | <body> | ||||
| <h2 id="chgrp">Chgrp</h2> | <h2 id="chgrp">Chgrp</h2> | ||||
| <p><em>Since Apache Ant 1.6.</em></p> | |||||
| <p><em>Since Apache Ant 1.6</em>.</p> | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Changes the group of a file or all files inside specified | <p>Changes the group of a file or all files inside specified | ||||
| @@ -92,7 +92,7 @@ could use as initial value for these experiments.</p> | |||||
| <i>both</i>. If set to <i>file</i>, only the group of | <i>both</i>. If set to <i>file</i>, only the group of | ||||
| plain files are going to be changed. If set to <i>dir</i>, only | plain files are going to be changed. If set to <i>dir</i>, only | ||||
| the directories are considered.<br> | the directories are considered.<br> | ||||
| <strong>Note:</strong> The type attribute does not apply to | |||||
| <strong>Note</strong>: The type attribute does not apply to | |||||
| nested <i>dirset</i>s - <i>dirset</i>s always implicitly | nested <i>dirset</i>s - <i>dirset</i>s always implicitly | ||||
| assume type to be <i>dir</i>.</td> | assume type to be <i>dir</i>.</td> | ||||
| <td align="center" valign="top">No, default is <i>file</i></td> | <td align="center" valign="top">No, default is <i>file</i></td> | ||||
| @@ -39,10 +39,10 @@ FileSet's attributes and nested elements directly. More sets can be | |||||
| specified using nested <code><fileset></code> or | specified using nested <code><fileset></code> or | ||||
| <code><dirset></code> (<em>since Apache Ant 1.6</em>) elements.</p> | <code><dirset></code> (<em>since Apache Ant 1.6</em>) elements.</p> | ||||
| <p>Starting with Ant 1.6, this task also supports nested <a | |||||
| <p><em>Since Ant 1.6</em>, this task also supports nested <a | |||||
| href="../Types/filelist.html">filelist</a>s.</p> | href="../Types/filelist.html">filelist</a>s.</p> | ||||
| <p>Starting with Ant 1.7, this task supports arbitrary <a | |||||
| <p><em>Since Ant 1.7</em>, this task supports arbitrary <a | |||||
| href="../Types/resources.html#collection">Resource Collection</a>s | href="../Types/resources.html#collection">Resource Collection</a>s | ||||
| as nested elements.</p> | as nested elements.</p> | ||||
| @@ -83,7 +83,7 @@ could use as initial value for these experiments.</p> | |||||
| <td valign="top">dir</td> | <td valign="top">dir</td> | ||||
| <td valign="top">the directory which holds the files whose permissions | <td valign="top">the directory which holds the files whose permissions | ||||
| must be changed.<br/> | must be changed.<br/> | ||||
| <b>Note:</b> for backwards compatibility | |||||
| <strong>Note</strong>: for backwards compatibility | |||||
| reasons <code><chmod dir="some-dir"/></code> will | reasons <code><chmod dir="some-dir"/></code> will | ||||
| only change the permissions on "some-dir" but not recurse into | only change the permissions on "some-dir" but not recurse into | ||||
| it, unless you also specify any patterns.</td> | it, unless you also specify any patterns.</td> | ||||
| @@ -123,7 +123,7 @@ could use as initial value for these experiments.</p> | |||||
| <i>both</i>. If set to <i>file</i>, only the permissions of | <i>both</i>. If set to <i>file</i>, only the permissions of | ||||
| plain files are going to be changed. If set to <i>dir</i>, only | plain files are going to be changed. If set to <i>dir</i>, only | ||||
| the directories are considered.<br> | the directories are considered.<br> | ||||
| <strong>Note:</strong> The type attribute does not apply to | |||||
| <strong>Note</strong>: The type attribute does not apply to | |||||
| nested <i>dirset</i>s - <i>dirset</i>s always implicitly | nested <i>dirset</i>s - <i>dirset</i>s always implicitly | ||||
| assume type to be <i>dir</i>.</td> | assume type to be <i>dir</i>.</td> | ||||
| <td align="center" valign="top">No, default is <i>file</i></td> | <td align="center" valign="top">No, default is <i>file</i></td> | ||||
| @@ -132,13 +132,13 @@ could use as initial value for these experiments.</p> | |||||
| <td valign="top">maxparallel</td> | <td valign="top">maxparallel</td> | ||||
| <td valign="top">Limit the amount of parallelism by passing at | <td valign="top">Limit the amount of parallelism by passing at | ||||
| most this many sourcefiles at once. Set it to <= 0 for | most this many sourcefiles at once. Set it to <= 0 for | ||||
| unlimited. Defaults to unlimited. <em>Since Ant 1.6.</em></td> | |||||
| unlimited. Defaults to unlimited. <em>Since Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">verbose</td> | <td valign="top">verbose</td> | ||||
| <td valign="top">Whether to print a summary after execution or not. | <td valign="top">Whether to print a summary after execution or not. | ||||
| Defaults to <code>false</code>. <em>Since Ant 1.6.</em></td> | |||||
| Defaults to <code>false</code>. <em>Since Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -25,7 +25,7 @@ | |||||
| <body> | <body> | ||||
| <h2 id="chown">Chown</h2> | <h2 id="chown">Chown</h2> | ||||
| <p><em>Since Apache Ant 1.6.</em></p> | |||||
| <p><em>Since Apache Ant 1.6</em>.</p> | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Changes the owner of a file or all files inside specified | <p>Changes the owner of a file or all files inside specified | ||||
| @@ -91,7 +91,7 @@ could use as initial value for these experiments.</p> | |||||
| <i>both</i>. If set to <i>file</i>, only the owner of | <i>both</i>. If set to <i>file</i>, only the owner of | ||||
| plain files are going to be changed. If set to <i>dir</i>, only | plain files are going to be changed. If set to <i>dir</i>, only | ||||
| the directories are considered.<br> | the directories are considered.<br> | ||||
| <strong>Note:</strong> The type attribute does not apply to | |||||
| <strong>Note</strong>: The type attribute does not apply to | |||||
| nested <i>dirset</i>s - <i>dirset</i>s always implicitly | nested <i>dirset</i>s - <i>dirset</i>s always implicitly | ||||
| assume type to be <i>dir</i>.</td> | assume type to be <i>dir</i>.</td> | ||||
| <td align="center" valign="top">No, default is <i>file</i></td> | <td align="center" valign="top">No, default is <i>file</i></td> | ||||
| @@ -264,7 +264,7 @@ TCP/IP listener at the specified host and port.</p> | |||||
| <p>Test two files for matching. Nonexistence of one file results in "false", | <p>Test two files for matching. Nonexistence of one file results in "false", | ||||
| although if neither exists they are considered equal in terms of content. | although if neither exists they are considered equal in terms of content. | ||||
| This test does a byte for byte comparison, so test time scales with | This test does a byte for byte comparison, so test time scales with | ||||
| byte size. NB: if the files are different sizes, one of them is missing | |||||
| byte size. <strong>Note</strong>: if the files are different sizes, one of them is missing | |||||
| or the filenames match the answer is so obvious the detailed test is omitted. | or the filenames match the answer is so obvious the detailed test is omitted. | ||||
| </p> | </p> | ||||
| @@ -288,7 +288,7 @@ or the filenames match the answer is so obvious the detailed test is omitted. | |||||
| <td valign="top">textfile</td> | <td valign="top">textfile</td> | ||||
| <td valign="top">Whether to ignore line endings when comparing | <td valign="top">Whether to ignore line endings when comparing | ||||
| files; defaults to <i>false</i> which triggers a binary | files; defaults to <i>false</i> which triggers a binary | ||||
| comparison. <i>Since Ant 1.7</i> | |||||
| comparison. <em>Since Ant 1.7</em> | |||||
| </td> | </td> | ||||
| <td align="center">No</td> | <td align="center">No</td> | ||||
| </tr> | </tr> | ||||
| @@ -395,7 +395,7 @@ that is "true","yes", or "on"</p> | |||||
| signature validation; it only looks for the presence of a signature. | signature validation; it only looks for the presence of a signature. | ||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| This condition was added in Apache Ant 1.7. | |||||
| <em>Since Apache Ant 1.7</em>. | |||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -424,7 +424,7 @@ that is "true","yes", or "on"</p> | |||||
| <a href="../Types/selectors.html">selector</a>. | <a href="../Types/selectors.html">selector</a>. | ||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| This condition was added in Apache Ant 1.6.3. | |||||
| <em>Since Apache Ant 1.6.3</em>. | |||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -461,7 +461,7 @@ that is "true","yes", or "on"</p> | |||||
| its implementation class can be loaded. Types include | its implementation class can be loaded. Types include | ||||
| tasks, datatypes, scriptdefs, macrodefs and presetdefs.</p> | tasks, datatypes, scriptdefs, macrodefs and presetdefs.</p> | ||||
| <p>This condition was added in Apache Ant 1.7.</p> | |||||
| <p><em>Since Apache Ant 1.7</em>.</p> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -504,7 +504,7 @@ See the <a href="../Tasks/script.html">Script</a> task for | |||||
| an explanation of scripts and dependencies. | an explanation of scripts and dependencies. | ||||
| </p> | </p> | ||||
| <p>This condition was added in Apache Ant 1.7.</p> | |||||
| <p><em>Since Apache Ant 1.7</em>.</p> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -538,7 +538,7 @@ an explanation of scripts and dependencies. | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">encoding</td> | <td valign="top">encoding</td> | ||||
| <td valign="top">The encoding of the script source. <em>since Ant 1.10.2.</em></td> | |||||
| <td valign="top">The encoding of the script source. <em>Since Ant 1.10.2</em>.</td> | |||||
| <td valign="top" align="center">No - defaults to default JVM encoding</td> | <td valign="top" align="center">No - defaults to default JVM encoding</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -594,7 +594,7 @@ sets the value to false. This condition always evaluates to "false" | |||||
| feature or property, as per the SAX/JAXP specifications, by | feature or property, as per the SAX/JAXP specifications, by | ||||
| attempting to set the appropriate property/feature/</p> | attempting to set the appropriate property/feature/</p> | ||||
| <p>This condition was added in Apache Ant 1.7.</p> | |||||
| <p><em>Since Apache Ant 1.7</em>.</p> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -668,9 +668,7 @@ using a protocol such as HTTP, while the lower level ICMP packets get dropped | |||||
| on the floor. Similarly, a host may detected as reachable with ICMP, but | on the floor. Similarly, a host may detected as reachable with ICMP, but | ||||
| not reachable on other ports (i.e. port 80), because of firewalls. | not reachable on other ports (i.e. port 80), because of firewalls. | ||||
| </p> | </p> | ||||
| <p> | |||||
| This condition was added in Apache Ant 1.7.</p> | |||||
| <p><em>Since Apache Ant 1.7</em>.</p> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -718,7 +716,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||||
| <h4 id="length">length</h4> | <h4 id="length">length</h4> | ||||
| <p>This condition is a facet of the <a href="length.html">Length</a> task. | <p>This condition is a facet of the <a href="length.html">Length</a> task. | ||||
| It is used to test the length of a string or one or more files. | It is used to test the length of a string or one or more files. | ||||
| <i>Since Ant 1.6.3</i> | |||||
| <em>Since Ant 1.6.3</em> | |||||
| </p> | </p> | ||||
| <blockquote><pre> | <blockquote><pre> | ||||
| @@ -734,7 +732,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||||
| <h4 id="isfailure">isfailure</h4> | <h4 id="isfailure">isfailure</h4> | ||||
| <p>Test the return code of an executable (see the | <p>Test the return code of an executable (see the | ||||
| <a href="exec.html">Exec</a> task) for failure. <i>Since Ant 1.7</i></p> | |||||
| <a href="exec.html">Exec</a> task) for failure. <em>Since Ant 1.7</em></p> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -754,7 +752,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||||
| <a href="resourcecount.html">ResourceCount</a> task. | <a href="resourcecount.html">ResourceCount</a> task. | ||||
| It is used to test the size of a | It is used to test the size of a | ||||
| <a href="../Types/resources.html#collection">resource collection</a>. | <a href="../Types/resources.html#collection">resource collection</a>. | ||||
| <i>Since Ant 1.7</i> | |||||
| <em>Since Ant 1.7</em> | |||||
| </p> | </p> | ||||
| <blockquote><pre> | <blockquote><pre> | ||||
| @@ -766,12 +764,12 @@ Probe for the maven repository being reachable using the hostname, ten second ti | |||||
| <p>Test resources for matching. Nonexistence of one or more resources results in | <p>Test resources for matching. Nonexistence of one or more resources results in | ||||
| "false", although if none exists they are considered equal in terms of content. | "false", although if none exists they are considered equal in terms of content. | ||||
| By default this test does a byte for byte comparison, so test time scales with | By default this test does a byte for byte comparison, so test time scales with | ||||
| byte size. NB: if the files are different sizes, one of them is missing | |||||
| byte size. <strong>Note</strong>: if the files are different sizes, one of them is missing | |||||
| or the filenames match the answer is so obvious the detailed test is omitted. | or the filenames match the answer is so obvious the detailed test is omitted. | ||||
| The resources to check are specified as nested | The resources to check are specified as nested | ||||
| <a href="../Types/resources.html#collection">resource collections</a>, | <a href="../Types/resources.html#collection">resource collections</a>, | ||||
| meaning that more than two resources can be checked; in this case all resources | meaning that more than two resources can be checked; in this case all resources | ||||
| must match. <i>Since Ant 1.7</i> | |||||
| must match. <em>Since Ant 1.7</em> | |||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -792,7 +790,7 @@ must match. <i>Since Ant 1.7</i> | |||||
| <h4 id="resourcecontains">resourcecontains</h4> | <h4 id="resourcecontains">resourcecontains</h4> | ||||
| <p>Tests whether a resource contains a given (sub)string.</p> | <p>Tests whether a resource contains a given (sub)string.</p> | ||||
| <p>The resources to check are specified via references or - in the | <p>The resources to check are specified via references or - in the | ||||
| case of file resources via the resource attribute. <i>Since Ant 1.7.1</i> | |||||
| case of file resources via the resource attribute. <em>Since Ant 1.7.1</em> | |||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -829,7 +827,7 @@ must match. <i>Since Ant 1.7</i> | |||||
| Tests for a class having a method or field. If the class is not found | Tests for a class having a method or field. If the class is not found | ||||
| or fails to load, the build fails. | or fails to load, the build fails. | ||||
| <i>Since Ant 1.7</i> | |||||
| <em>Since Ant 1.7</em> | |||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| @@ -886,7 +884,7 @@ must match. <i>Since Ant 1.7</i> | |||||
| <p> | <p> | ||||
| Test if the specified string matches the specified regular | Test if the specified string matches the specified regular | ||||
| expression pattern. | expression pattern. | ||||
| <i>Since Ant 1.7</i></p> | |||||
| <em>Since Ant 1.7</em></p> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -997,7 +995,7 @@ is redundant and will be ignored.</p> | |||||
| <p> | <p> | ||||
| Tests a partition to see if there is enough space. | Tests a partition to see if there is enough space. | ||||
| <i>Since Ant 1.7.0</i></p> | |||||
| <em>Since Ant 1.7.0</em></p> | |||||
| <p>Needed attribute can be specified using standard computing terms:</p> | <p>Needed attribute can be specified using standard computing terms:</p> | ||||
| <ul> | <ul> | ||||
| <li>K : Kilobytes (1024 bytes)</li> | <li>K : Kilobytes (1024 bytes)</li> | ||||
| @@ -41,7 +41,7 @@ using a nested mapper (or the flatten attribute) may not be what you | |||||
| expect.</p> | expect.</p> | ||||
| <p> | <p> | ||||
| <strong>Note:</strong> If you employ filters in your copy operation, | |||||
| <strong>Note</strong>: If you employ filters in your copy operation, | |||||
| you should limit the copy to text files. Binary files will be corrupted | you should limit the copy to text files. Binary files will be corrupted | ||||
| by the copy operation. | by the copy operation. | ||||
| This applies whether the filters are implicitly defined by the | This applies whether the filters are implicitly defined by the | ||||
| @@ -103,7 +103,7 @@ operation as <a href="../Types/filterset.html">filtersets</a>. | |||||
| <td valign="top">filtering</td> | <td valign="top">filtering</td> | ||||
| <td valign="top">Indicates whether token filtering using the <a href="../using.html#filters">global | <td valign="top">Indicates whether token filtering using the <a href="../using.html#filters">global | ||||
| build-file filters</a> should take place during the copy. | build-file filters</a> should take place during the copy. | ||||
| <em>Note</em>: Nested <code><filterset></code> elements will | |||||
| <strong>Note</strong>: Nested <code><filterset></code> elements will | |||||
| always be used, even if this attribute is not specified, or its value is | always be used, even if this attribute is not specified, or its value is | ||||
| <code>false</code> (<code>no</code>, or <code>off</code>).</td> | <code>false</code> (<code>no</code>, or <code>off</code>).</td> | ||||
| <td valign="top" align="center">No; defaults to false.</td> | <td valign="top" align="center">No; defaults to false.</td> | ||||
| @@ -317,7 +317,7 @@ destination directory, flattening the directory structure.</b></p> | |||||
| <p>The paragraph following the previous example applies to this | <p>The paragraph following the previous example applies to this | ||||
| example as well.</p> | example as well.</p> | ||||
| <p><strong>Unix Note:</strong> File permissions are not retained when files | |||||
| <p><strong>Unix Note</strong>: File permissions are not retained when files | |||||
| are copied; they end up with the default <code>UMASK</code> permissions | are copied; they end up with the default <code>UMASK</code> permissions | ||||
| instead. This | instead. This | ||||
| is caused by the lack of any means to query or set file permissions in the | is caused by the lack of any means to query or set file permissions in the | ||||
| @@ -325,14 +325,14 @@ current Java runtimes. If you need a permission-preserving copy function, | |||||
| use <code><exec executable="cp" ... ></code> instead. | use <code><exec executable="cp" ... ></code> instead. | ||||
| </p> | </p> | ||||
| <p><strong>Windows Note:</strong> If you copy a file to a directory | |||||
| <p><strong>Windows Note</strong>: If you copy a file to a directory | |||||
| where that file already exists, but with different casing, | where that file already exists, but with different casing, | ||||
| the copied file takes on the case of the original. The workaround is to | the copied file takes on the case of the original. The workaround is to | ||||
| <a href="delete.html">delete</a> | <a href="delete.html">delete</a> | ||||
| the file in the destination directory before you copy it. | the file in the destination directory before you copy it. | ||||
| </p> | </p> | ||||
| <p id="encoding"> | <p id="encoding"> | ||||
| <strong>Important Encoding Note:</strong> | |||||
| <strong>Important Encoding Note</strong>: | |||||
| The reason that binary files when filtered get corrupted is that | The reason that binary files when filtered get corrupted is that | ||||
| filtering involves reading in the file using a Reader class. This | filtering involves reading in the file using a Reader class. This | ||||
| has an encoding specifying how files are encoded. There are a number | has an encoding specifying how files are encoded. There are a number | ||||
| @@ -37,7 +37,7 @@ for certain other cvs clients - like CVSNT for example - and some | |||||
| operation may fail when using such an incompatible client. | operation may fail when using such an incompatible client. | ||||
| </p> | </p> | ||||
| <p><b>CVSNT Note</b>: CVSNT prefers users to store the passwords | |||||
| <p><strong>CVSNT Note</strong>: CVSNT prefers users to store the passwords | |||||
| inside the registry. If the <a href="cvspass.html">cvspass task</a> | inside the registry. If the <a href="cvspass.html">cvspass task</a> | ||||
| and the passfile attribute don't seem to work for you, the most likely | and the passfile attribute don't seem to work for you, the most likely | ||||
| reason is that CVSNT ignores your .cvspass file completely. See <a | reason is that CVSNT ignores your .cvspass file completely. See <a | ||||
| @@ -90,7 +90,7 @@ report 21657</a> for recommended workarounds.</p> | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">package</td> | <td valign="top">package</td> | ||||
| <td valign="top">the package/module to check out. <b>Note:</b> | |||||
| <td valign="top">the package/module to check out. <strong>Note</strong>: | |||||
| multiple attributes can be split using spaces. Use a nested | multiple attributes can be split using spaces. Use a nested | ||||
| <module> element if you want to specify a module with | <module> element if you want to specify a module with | ||||
| spaces in its name.</td> | spaces in its name.</td> | ||||
| @@ -28,7 +28,7 @@ | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Adds entries to a .cvspass file. Adding entries to this file has the same affect as a cvs login command.</p> | <p>Adds entries to a .cvspass file. Adding entries to this file has the same affect as a cvs login command.</p> | ||||
| <p><b>CVSNT Note</b>: CVSNT prefers users to store the passwords | |||||
| <p><strong>CVSNT Note</strong>: CVSNT prefers users to store the passwords | |||||
| inside the registry. If the task doesn't seem to work for you, the | inside the registry. If the task doesn't seem to work for you, the | ||||
| most likely reason is that CVSNT ignores your .cvspass file | most likely reason is that CVSNT ignores your .cvspass file | ||||
| completely. See <a | completely. See <a | ||||
| @@ -28,7 +28,7 @@ | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p> | <p> | ||||
| This task allows to retrieve a CVS client and server version. | This task allows to retrieve a CVS client and server version. | ||||
| <i>Since Apache Ant 1.6.1.</i> | |||||
| <em>Since Apache Ant 1.6.1</em>. | |||||
| </p> | </p> | ||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| <table> | <table> | ||||
| @@ -71,10 +71,10 @@ in <strong>Directory-based Tasks</strong>, and see the | |||||
| <td valign="top">dir</td> | <td valign="top">dir</td> | ||||
| <td valign="top">The directory to delete, including all its files and | <td valign="top">The directory to delete, including all its files and | ||||
| subdirectories.<br> | subdirectories.<br> | ||||
| <b>Note:</b> <code>dir</code> is <em>not</em> used | |||||
| <strong>Note</strong>: <code>dir</code> is <em>not</em> used | |||||
| to specify a directory name for <code>file</code>; <code>file</code> | to specify a directory name for <code>file</code>; <code>file</code> | ||||
| and <code>dir</code> are independent of each other.<br> | and <code>dir</code> are independent of each other.<br> | ||||
| <b>WARNING:</b> Do <b>not</b> set <code>dir</code> to | |||||
| <strong>Warning</strong>: Do <b>not</b> set <code>dir</code> to | |||||
| <code>"."</code>, <code>"${basedir}"</code>, | <code>"."</code>, <code>"${basedir}"</code>, | ||||
| or the full-pathname equivalent unless you truly <em>intend</em> to | or the full-pathname equivalent unless you truly <em>intend</em> to | ||||
| recursively remove the entire contents of the current base directory | recursively remove the entire contents of the current base directory | ||||
| @@ -116,7 +116,7 @@ in <strong>Directory-based Tasks</strong>, and see the | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">includes</td> | <td valign="top">includes</td> | ||||
| <td valign="top"><em>Deprecated.</em> Use resource collections. | |||||
| <td valign="top"><em>Deprecated</em>. Use resource collections. | |||||
| Comma- or space-separated list of patterns of | Comma- or space-separated list of patterns of | ||||
| files that must be deleted. All files are relative to the directory | files that must be deleted. All files are relative to the directory | ||||
| specified in <code>dir</code>.</td> | specified in <code>dir</code>.</td> | ||||
| @@ -124,14 +124,14 @@ in <strong>Directory-based Tasks</strong>, and see the | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">includesfile</td> | <td valign="top">includesfile</td> | ||||
| <td valign="top"><em>Deprecated.</em> Use resource collections. | |||||
| <td valign="top"><em>Deprecated</em>. Use resource collections. | |||||
| The name of a file. Each line of | The name of a file. Each line of | ||||
| this file is taken to be an include pattern.</td> | this file is taken to be an include pattern.</td> | ||||
| <td valign="top" align="center">No</td> | <td valign="top" align="center">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">excludes</td> | <td valign="top">excludes</td> | ||||
| <td valign="top"><em>Deprecated.</em> Use resource collections. | |||||
| <td valign="top"><em>Deprecated</em>. Use resource collections. | |||||
| Comma- or space-separated list of patterns of | Comma- or space-separated list of patterns of | ||||
| files that must be excluded from the deletion list. | files that must be excluded from the deletion list. | ||||
| All files are relative to the directory specified in <code>dir</code>. | All files are relative to the directory specified in <code>dir</code>. | ||||
| @@ -140,14 +140,14 @@ in <strong>Directory-based Tasks</strong>, and see the | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">excludesfile</td> | <td valign="top">excludesfile</td> | ||||
| <td valign="top"><em>Deprecated.</em> Use resource collections. | |||||
| <td valign="top"><em>Deprecated</em>. Use resource collections. | |||||
| The name of a file. Each line of | The name of a file. Each line of | ||||
| this file is taken to be an exclude pattern</td> | this file is taken to be an exclude pattern</td> | ||||
| <td valign="top" align="center">No</td> | <td valign="top" align="center">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">defaultexcludes</td> | <td valign="top">defaultexcludes</td> | ||||
| <td valign="top"><em>Deprecated.</em> Use resource collections. | |||||
| <td valign="top"><em>Deprecated</em>. Use resource collections. | |||||
| Whether to use <a href="../dirtasks.html#defaultexcludes"> | Whether to use <a href="../dirtasks.html#defaultexcludes"> | ||||
| default excludes.</a></td> | default excludes.</a></td> | ||||
| <td align="center" valign="top">No, default "true"</td> | <td align="center" valign="top">No, default "true"</td> | ||||
| @@ -79,7 +79,7 @@ well as other stylesheets imported by the main stylesheet. | |||||
| <p>The <code><sources></code> element is a | <p>The <code><sources></code> element is a | ||||
| <a href="../Types/resources.html#union">Union</a> into which | <a href="../Types/resources.html#union">Union</a> into which | ||||
| arbitrary resource collections can be nested. <b>Since Apache Ant 1.7</b> | |||||
| arbitrary resource collections can be nested. <em>Since Apache Ant 1.7</em> | |||||
| </p> | </p> | ||||
| <h4>srcfileset</h4> | <h4>srcfileset</h4> | ||||
| @@ -106,7 +106,7 @@ filelists. Multiple <code><srcfilelist></code> filelists may be specified | |||||
| <p>The <code><targets></code> element is a | <p>The <code><targets></code> element is a | ||||
| <a href="../using.html#path">Path</a> and thus can | <a href="../using.html#path">Path</a> and thus can | ||||
| include any filesystem-based resource. <b>Since Ant 1.7</b> | |||||
| include any filesystem-based resource. <em>Since Ant 1.7</em> | |||||
| </p> | </p> | ||||
| <h4>targetfileset</h4> | <h4>targetfileset</h4> | ||||
| @@ -29,7 +29,7 @@ | |||||
| <p> | <p> | ||||
| Runs Apache Ant's <code>-diagnostics</code> code inside Ant itself. This is good for | Runs Apache Ant's <code>-diagnostics</code> code inside Ant itself. This is good for | ||||
| debugging Ant's configuration under an IDE. | debugging Ant's configuration under an IDE. | ||||
| <b>Since Ant 1.7.0</b> | |||||
| <em>Since Ant 1.7.0</em> | |||||
| </p> | </p> | ||||
| <h3>Examples</h3> | <h3>Examples</h3> | ||||
| @@ -37,7 +37,7 @@ filename, the filename will be dropped. If the specified file is just | |||||
| a filename, the directory will be the current directory. | a filename, the directory will be the current directory. | ||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| <em>Note:</em> This is not the same as the UNIX dirname command, which is | |||||
| <strong>Note</strong>: This is not the same as the UNIX dirname command, which is | |||||
| defined as "strip non-directory suffix from filename". <dirname> | defined as "strip non-directory suffix from filename". <dirname> | ||||
| determines the full directory path of the specified file. | determines the full directory path of the specified file. | ||||
| </p> | </p> | ||||
| @@ -209,7 +209,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||||
| that the permissions haven't been stored at all rather than real | that the permissions haven't been stored at all rather than real | ||||
| permissions and will instead apply its own default values.<br/> | permissions and will instead apply its own default values.<br/> | ||||
| Set this attribute to true if you really want to preserve the | Set this attribute to true if you really want to preserve the | ||||
| original permission field.<em>since Ant 1.8.0</em> | |||||
| original permission field. <em>since Ant 1.8.0</em> | |||||
| </td> | </td> | ||||
| <td valign="top" align="center">No, default is false</td> | <td valign="top" align="center">No, default is false</td> | ||||
| </tr> | </tr> | ||||
| @@ -57,7 +57,7 @@ ignored</p> | |||||
| <td valign="top">output</td> | <td valign="top">output</td> | ||||
| <td valign="top">the <a href="../Types/resources.html">Resource</a> | <td valign="top">the <a href="../Types/resources.html">Resource</a> | ||||
| to write the message to (see <a href="../develop.html#set-magic">note</a>). | to write the message to (see <a href="../develop.html#set-magic">note</a>). | ||||
| <b>Since Apache Ant 1.8</b></td> | |||||
| <em>Since Apache Ant 1.8</em></td> | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">append</td> | <td valign="top">append</td> | ||||
| @@ -26,7 +26,7 @@ | |||||
| <h2>EchoXML</h2> | <h2>EchoXML</h2> | ||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Echo nested XML to the console or a file. <b>Since Apache Ant 1.7</b></p> | |||||
| <p>Echo nested XML to the console or a file. <em>Since Apache Ant 1.7</em></p> | |||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -32,7 +32,7 @@ systems.</p> | |||||
| <p>Note that you cannot interact with the forked program, the only way | <p>Note that you cannot interact with the forked program, the only way | ||||
| to send input to it is via the input and inputstring attributes. Also note that | to send input to it is via the input and inputstring attributes. Also note that | ||||
| since Ant 1.6, any attempt to read input in the forked program will receive an | |||||
| <em>since Ant 1.6</em>, any attempt to read input in the forked program will receive an | |||||
| EOF (-1). This is a change from Ant 1.5, where such an attempt would block.</p> | EOF (-1). This is a change from Ant 1.5, where such an attempt would block.</p> | ||||
| <p>If you want to execute an executable using a path relative to the | <p>If you want to execute an executable using a path relative to the | ||||
| @@ -169,7 +169,7 @@ start with something like:</p> | |||||
| <td valign="top">dir</td> | <td valign="top">dir</td> | ||||
| <td valign="top">the directory in which the command should be executed.</td> | <td valign="top">the directory in which the command should be executed.</td> | ||||
| <td align="center" valign="top">No.<br/> | <td align="center" valign="top">No.<br/> | ||||
| <strong>Note:</strong> the default used when dir has not been | |||||
| <strong>Note</strong>: the default used when dir has not been | |||||
| specified depends on the <code>vmlauncher</code> attribute. If | specified depends on the <code>vmlauncher</code> attribute. If | ||||
| <code>vmlauncher</code> is <code>true</code> the task will use | <code>vmlauncher</code> is <code>true</code> the task will use | ||||
| the current working directory, otherwise it uses the project's basedir. | the current working directory, otherwise it uses the project's basedir. | ||||
| @@ -343,7 +343,7 @@ system command via nested <code><env></code> elements.</p> | |||||
| <td valign="top"> | <td valign="top"> | ||||
| The name of the environment variable. | The name of the environment variable. | ||||
| <br/> | <br/> | ||||
| <em>Note: since Ant 1.7</em>, | |||||
| <strong>Note</strong>: <em>since Ant 1.7</em>, | |||||
| for Windows, the name is case-insensitive. | for Windows, the name is case-insensitive. | ||||
| </td> | </td> | ||||
| <td align="center" valign="top">Yes</td> | <td align="center" valign="top">Yes</td> | ||||
| @@ -366,7 +366,7 @@ system command via nested <code><env></code> elements.</p> | |||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <h4 id="redirector">redirector</h4> | <h4 id="redirector">redirector</h4> | ||||
| <i>Since Ant 1.6.2</i> | |||||
| <em>Since Ant 1.6.2</em> | |||||
| <p>A nested <a href="../Types/redirector.html">I/O Redirector</a> | <p>A nested <a href="../Types/redirector.html">I/O Redirector</a> | ||||
| can be specified. In general, the attributes of the redirector behave | can be specified. In general, the attributes of the redirector behave | ||||
| as the corresponding attributes available at the task level. The most | as the corresponding attributes available at the task level. The most | ||||
| @@ -446,7 +446,7 @@ Output is sent to the file "redirector.out" and stored | |||||
| in a property of the same name. Similarly, error output is sent to | in a property of the same name. Similarly, error output is sent to | ||||
| a file and a property, both named "redirector.err". | a file and a property, both named "redirector.err". | ||||
| <p><b>Note:</b> do not try to specify arguments using | |||||
| <p><strong>Note</strong>: do not try to specify arguments using | |||||
| a simple arg-element and separate them by spaces. This results in | a simple arg-element and separate them by spaces. This results in | ||||
| only a single argument containing the entire string.</p> | only a single argument containing the entire string.</p> | ||||
| <p> | <p> | ||||
| @@ -69,7 +69,7 @@ or character data nested into the element.</p> | |||||
| conditional failure can be achieved using a single nested | conditional failure can be achieved using a single nested | ||||
| <code><condition></code> element, which should contain exactly one | <code><condition></code> element, which should contain exactly one | ||||
| core or custom condition. For information about conditions, see | core or custom condition. For information about conditions, see | ||||
| <a href="conditions.html">here</a>.<br><i>Since Ant 1.6.2</i> | |||||
| <a href="conditions.html">here</a>.<br><em>Since Ant 1.6.2</em> | |||||
| </p> | </p> | ||||
| <h3>Examples</h3> | <h3>Examples</h3> | ||||
| @@ -62,7 +62,7 @@ | |||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| Since <i>Apache Ant 1.7</i>, this task can be used in a | |||||
| <em>Since Apache Ant 1.7</em>, this task can be used in a | |||||
| <a href="../Types/filterchain.html">filterchain</a>. | <a href="../Types/filterchain.html">filterchain</a>. | ||||
| </p> | </p> | ||||
| @@ -85,7 +85,7 @@ | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">file</td> | <td valign="top">file</td> | ||||
| <td valign="top">Name of a single file to fix. <i>Since Ant 1.7</i></td> | |||||
| <td valign="top">Name of a single file to fix. <em>Since Ant 1.7</em></td> | |||||
| <td> </td> | <td> </td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -140,14 +140,14 @@ | |||||
| <tr> | <tr> | ||||
| <td valign="top">outputencoding</td> | <td valign="top">outputencoding</td> | ||||
| <td valign="top">The encoding to use when writing the files. | <td valign="top">The encoding to use when writing the files. | ||||
| <i>Since Ant 1.7</i></td> | |||||
| <em>Since Ant 1.7</em></td> | |||||
| <td align="center">No; defaults to the value of the encoding attribute.</td> | <td align="center">No; defaults to the value of the encoding attribute.</td> | ||||
| <td> </td> | <td> </td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">preservelastmodified</td> | <td valign="top">preservelastmodified</td> | ||||
| <td valign="top">Whether to preserve the last modified | <td valign="top">Whether to preserve the last modified | ||||
| date of source files. <i>Since Ant 1.6.3</i></td> | |||||
| date of source files. <em>Since Ant 1.6.3</em></td> | |||||
| <td align="center">No; default is <i>false</i></td> | <td align="center">No; default is <i>false</i></td> | ||||
| <td> </td> | <td> </td> | ||||
| </tr> | </tr> | ||||
| @@ -280,7 +280,7 @@ | |||||
| <tr> | <tr> | ||||
| <td valign="top">fixlast</td> | <td valign="top">fixlast</td> | ||||
| <td valign="top">Whether to add a missing EOL to the last line | <td valign="top">Whether to add a missing EOL to the last line | ||||
| of a processed file.<br/>Ignored if EOL is asis.<br/><i>Since Ant 1.6.1</i></td> | |||||
| of a processed file.<br/>Ignored if EOL is asis.<br/><em>Since Ant 1.6.1</em></td> | |||||
| <td align="center" colspan="2">No; default is <i>true</i></td> | <td align="center" colspan="2">No; default is <i>true</i></td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| @@ -29,7 +29,7 @@ | |||||
| <p>The ftp task implements a basic FTP client that can send, receive, | <p>The ftp task implements a basic FTP client that can send, receive, | ||||
| list, delete files, and create directories. See below for descriptions and examples of how | list, delete files, and create directories. See below for descriptions and examples of how | ||||
| to perform each task.</p> | to perform each task.</p> | ||||
| <p><b>Note:</b> This task depends on external libraries not included in the Apache Ant distribution. | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant distribution. | |||||
| See <a href="../install.html#commons-net">Library Dependencies</a> for more information. | See <a href="../install.html#commons-net">Library Dependencies</a> for more information. | ||||
| <i>Get the latest version of this library, for the best support in Ant</i> | <i>Get the latest version of this library, for the best support in Ant</i> | ||||
| @@ -50,7 +50,7 @@ This task does not currently use the proxy information set by the | |||||
| <a href="setproxy.html"><code><setproxy></code></a> task, and cannot go through | <a href="setproxy.html"><code><setproxy></code></a> task, and cannot go through | ||||
| a firewall via socks. | a firewall via socks. | ||||
| <p> | <p> | ||||
| <b>Warning:</b> there have been problems reported concerning the ftp get with the <code>newer</code> attribute. | |||||
| <strong>Warning:</strong> there have been problems reported concerning the ftp get with the <code>newer</code> attribute. | |||||
| Problems might be due to format of <code>ls -l</code> differing from what is expected by commons-net, | Problems might be due to format of <code>ls -l</code> differing from what is expected by commons-net, | ||||
| for instance due to specificities of language used by the ftp server in the directory listing. | for instance due to specificities of language used by the ftp server in the directory listing. | ||||
| If you encounter such a problem, please send an email including a sample directory listing | If you encounter such a problem, please send an email including a sample directory listing | ||||
| @@ -219,13 +219,13 @@ try to set up a new connection.</p> | |||||
| <td valign="top">preservelastmodified</td> | <td valign="top">preservelastmodified</td> | ||||
| <td valign="top">Give the copied files the same last modified | <td valign="top">Give the copied files the same last modified | ||||
| time as the original source files (applies to getting files only). | time as the original source files (applies to getting files only). | ||||
| (<em>Note</em>: Ignored on Java 1.1)</td> | |||||
| (<strong>Note</strong>: Ignored on Java 1.1)</td> | |||||
| <td valign="top" align="center">No; defaults to false.</td> | <td valign="top" align="center">No; defaults to false.</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">retriesAllowed</td> | <td valign="top">retriesAllowed</td> | ||||
| <td valign="top">Set the number of retries allowed on an file-transfer operation. | <td valign="top">Set the number of retries allowed on an file-transfer operation. | ||||
| If a number > 0 specified, each file transfer can fail up to that | |||||
| If a number > 0 specified, each file transfer can fail up to that | |||||
| many times before the operation is failed. If -1 or "forever" specified, the | many times before the operation is failed. If -1 or "forever" specified, the | ||||
| operation will keep trying until it succeeds.</td> | operation will keep trying until it succeeds.</td> | ||||
| <td valign="top" align="center">No; defaults to 0</td> | <td valign="top" align="center">No; defaults to 0</td> | ||||
| @@ -33,13 +33,13 @@ the runtime is valid here, including http:, ftp: and jar:; | |||||
| The <i>usetimestamp</i> option enables you to control downloads so that the remote file is | The <i>usetimestamp</i> option enables you to control downloads so that the remote file is | ||||
| only fetched if newer than the local copy. If there is no local copy, the download always takes | only fetched if newer than the local copy. If there is no local copy, the download always takes | ||||
| place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp. | place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp. | ||||
| NB: This timestamp facility only works on downloads using the HTTP protocol. | |||||
| <strong>Note</strong>: This timestamp facility only works on downloads using the HTTP protocol. | |||||
| <p> | <p> | ||||
| A username and password can be specified, in which case basic 'slightly encoded | A username and password can be specified, in which case basic 'slightly encoded | ||||
| plain text' authentication is used. This is only secure over an HTTPS link. | plain text' authentication is used. This is only secure over an HTTPS link. | ||||
| </p> | </p> | ||||
| <p><b>Proxies</b>. Since Apache Ant 1.7.0, Ant running on Java 5 or later can | |||||
| <p><b>Proxies</b>. <em>Since Apache Ant 1.7.0</em>, Ant running on Java 5 or later can | |||||
| <a href="../proxy.html">use the proxy settings of the operating | <a href="../proxy.html">use the proxy settings of the operating | ||||
| system</a> if enabled with the | system</a> if enabled with the | ||||
| <code>-autoproxy</code> option. There is also the | <code>-autoproxy</code> option. There is also the | ||||
| @@ -124,7 +124,7 @@ plain text' authentication is used. This is only secure over an HTTPS link. | |||||
| <td valign="top">httpusecaches</td> | <td valign="top">httpusecaches</td> | ||||
| <td valign="top">HTTP only - if true, allow caching at the | <td valign="top">HTTP only - if true, allow caching at the | ||||
| HttpUrlConnection level. if false, turn caching off.<br/> | HttpUrlConnection level. if false, turn caching off.<br/> | ||||
| <b>Note</b> this is only a hint to the underlying UrlConnection | |||||
| <strong>Note</strong> this is only a hint to the underlying UrlConnection | |||||
| class, implementations and proxies are free to ignore the | class, implementations and proxies are free to ignore the | ||||
| setting.</td> | setting.</td> | ||||
| <td align="center" valign="top">No; default "true"</td> | <td align="center" valign="top">No; default "true"</td> | ||||
| @@ -35,7 +35,7 @@ | |||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| <b>Note</b> as seen above, this task heavily relies on the ProjectHelper | |||||
| <strong>Note</strong> as seen above, this task heavily relies on the ProjectHelper | |||||
| implementation and doesn't really perform any work of its own. If | implementation and doesn't really perform any work of its own. If | ||||
| you have configured Apache Ant to use a ProjectHelper other than Ant's | you have configured Apache Ant to use a ProjectHelper other than Ant's | ||||
| default, this task may or may not work. | default, this task may or may not work. | ||||
| @@ -176,7 +176,7 @@ project).</p> | |||||
| </td> | </td> | ||||
| <td valign="top"> | <td valign="top"> | ||||
| The file to import. If this is a relative file name, the file name will be resolved | The file to import. If this is a relative file name, the file name will be resolved | ||||
| relative to the <i>importing</i> file. <b>Note</b>, this is unlike most other | |||||
| relative to the <i>importing</i> file. <strong>Note</strong>: this is unlike most other | |||||
| Ant file attributes, where relative files are resolved relative to ${basedir}. | Ant file attributes, where relative files are resolved relative to ${basedir}. | ||||
| </td> | </td> | ||||
| <td valign="top" align="center">Yes or a nested resource collection</td> | <td valign="top" align="center">Yes or a nested resource collection</td> | ||||
| @@ -30,7 +30,7 @@ | |||||
| <p><em>since Apache Ant 1.8.0</em></p> | <p><em>since Apache Ant 1.8.0</em></p> | ||||
| <p> | <p> | ||||
| <b>Note</b> this task heavily relies on the ProjectHelper | |||||
| <strong>Note</strong> this task heavily relies on the ProjectHelper | |||||
| implementation and doesn't really perform any work of its own. If | implementation and doesn't really perform any work of its own. If | ||||
| you have configured Ant to use a ProjectHelper other than Ant's | you have configured Ant to use a ProjectHelper other than Ant's | ||||
| default, this task may or may not work. | default, this task may or may not work. | ||||
| @@ -171,7 +171,7 @@ project).</p> | |||||
| </td> | </td> | ||||
| <td valign="top"> | <td valign="top"> | ||||
| The file to include. If this is a relative file name, the file name will be resolved | The file to include. If this is a relative file name, the file name will be resolved | ||||
| relative to the <i>including</i> file. <b>Note</b>, this is unlike most other | |||||
| relative to the <i>including</i> file. <strong>Note</strong>, this is unlike most other | |||||
| ant file attributes, where relative files are resolved relative to ${basedir}. | ant file attributes, where relative files are resolved relative to ${basedir}. | ||||
| </td> | </td> | ||||
| <td valign="top" align="center">Yes or a nested resource collection</td> | <td valign="top" align="center">Yes or a nested resource collection</td> | ||||
| @@ -99,7 +99,7 @@ file and load in before the input task.</p> | |||||
| </table> | </table> | ||||
| <h3>Parameters Specified as Nested Elements</h3> | <h3>Parameters Specified as Nested Elements</h3> | ||||
| <h4>Handler</h4> | <h4>Handler</h4> | ||||
| <p>Since <b>Ant 1.7</b>, a nested <handler> element can be used to | |||||
| <p><em>Since Ant 1.7</em>, a nested <handler> element can be used to | |||||
| specify an InputHandler, so that different InputHandlers may be used | specify an InputHandler, so that different InputHandlers may be used | ||||
| among different Input tasks.</p> | among different Input tasks.</p> | ||||
| @@ -111,7 +111,7 @@ among different Input tasks.</p> | |||||
| </tr> | </tr> | ||||
| <tr id="handler.type"> | <tr id="handler.type"> | ||||
| <td valign="top">type</td> | <td valign="top">type</td> | ||||
| <td valign="top">one of "default","propertyfile", "greedy", or "secure" (since Ant 1.8). | |||||
| <td valign="top">one of "default","propertyfile", "greedy", or "secure" (<em>since Ant 1.8</em>). | |||||
| </td> | </td> | ||||
| <td align="center" valign="top" rowspan="3">One of these</td> | <td align="center" valign="top" rowspan="3">One of these</td> | ||||
| </tr> | </tr> | ||||
| @@ -90,9 +90,9 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||||
| <p>To cryptographically sign your JAR file, use the <a href="signjar.html">SignJar task</a> on the JAR that you create from this task.</p> | <p>To cryptographically sign your JAR file, use the <a href="signjar.html">SignJar task</a> on the JAR that you create from this task.</p> | ||||
| <p>For creating a simple version of a <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP-238 multi release jar</a>, | |||||
| <p>For creating a simple version of a <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP 238 multi-release jar</a>, | |||||
| you don't need any special tools. Just set the required manifest entry and place the files where required, as you could see | you don't need any special tools. Just set the required manifest entry and place the files where required, as you could see | ||||
| in the <a href="#jep238-example">JEP238-example</a>. If you want to tune this kind of jar, e.g. decreasing the size by deleting | |||||
| in the <a href="#jep238-example">JEP 238 example</a>. If you want to tune this kind of jar, e.g. decreasing the size by deleting | |||||
| 'same' classes from the versions-branches, you have to do more ...</p> | 'same' classes from the versions-branches, you have to do more ...</p> | ||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| @@ -273,7 +273,7 @@ in the <a href="#jep238-example">JEP238-example</a>. If you want to tune this ki | |||||
| that the permissions haven't been stored at all rather than real | that the permissions haven't been stored at all rather than real | ||||
| permissions and will instead apply its own default values.<br/> | permissions and will instead apply its own default values.<br/> | ||||
| Set this attribute to true if you really want to preserve the | Set this attribute to true if you really want to preserve the | ||||
| original permission field.<em>since Ant 1.8.0</em> | |||||
| original permission field. <em>since Ant 1.8.0</em> | |||||
| </td> | </td> | ||||
| <td valign="top" align="center">No, default is false</td> | <td valign="top" align="center">No, default is false</td> | ||||
| </tr> | </tr> | ||||
| @@ -585,10 +585,10 @@ Sealed: false</code></pre></blockquote> | |||||
| </pre></blockquote> | </pre></blockquote> | ||||
| <h4 id="jep238-example">JEP238 example: a Multi-Release JAR Files</h4> | |||||
| <h4 id="jep238-example">JEP 238 example: a Multi-Release JAR Files</h4> | |||||
| <p> | <p> | ||||
| Here we want to create a <i>Multi-Release JAR File</i> according the specification | Here we want to create a <i>Multi-Release JAR File</i> according the specification | ||||
| <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP-238</a>. | |||||
| <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP 238</a>. | |||||
| It defines on top of a JAR the possibility to place additional or overwriting classes | It defines on top of a JAR the possibility to place additional or overwriting classes | ||||
| in a jar, which are available according to the Java version you run.<br> | in a jar, which are available according to the Java version you run.<br> | ||||
| Basically it sais, that you have to set the manifest entry <tt>Multi-Release: true</tt> | Basically it sais, that you have to set the manifest entry <tt>Multi-Release: true</tt> | ||||
| @@ -122,12 +122,12 @@ attributes.</p> | |||||
| <td valign="top">module</td> | <td valign="top">module</td> | ||||
| <td valign="top">The initial or main module to resolve. To specify | <td valign="top">The initial or main module to resolve. To specify | ||||
| the module main class use the <a href="#classname">classname</a> attribute. | the module main class use the <a href="#classname">classname</a> attribute. | ||||
| Fork must be set to true if this option is selected.<em>since Ant 1.9.7</em></td> | |||||
| Fork must be set to true if this option is selected. <em>since Ant 1.9.7</em></td> | |||||
| <td align="center" valign="top">Either <tt>jar</tt>, <tt>classname</tt> or <tt>module</tt></td> | <td align="center" valign="top">Either <tt>jar</tt>, <tt>classname</tt> or <tt>module</tt></td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">modulepath</td> | <td valign="top">modulepath</td> | ||||
| <td valign="top">Specify where to find application modules. A list of directories of modules, module files or exploded modules.<em>since Ant 1.9.7</em></td> | |||||
| <td valign="top">Specify where to find application modules. A list of directories of modules, module files or exploded modules. <em>since Ant 1.9.7</em></td> | |||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -283,7 +283,7 @@ see <a href="../Types/permissions.html">permissions</a></p> | |||||
| <p>When the permission RuntimePermission exitVM has not been granted (or has | <p>When the permission RuntimePermission exitVM has not been granted (or has | ||||
| been revoked) the System.exit() call will be intercepted | been revoked) the System.exit() call will be intercepted | ||||
| and treated like indicated in <i>failonerror</i>.</p> | and treated like indicated in <i>failonerror</i>.</p> | ||||
| <p>Note:<br> | |||||
| <p><strong>Note</strong>:<br> | |||||
| If you do not specify permissions, | If you do not specify permissions, | ||||
| a set of default permissions will be added to your Java invocation to make | a set of default permissions will be added to your Java invocation to make | ||||
| sure that the Ant run will continue or terminated as indicated by | sure that the Ant run will continue or terminated as indicated by | ||||
| @@ -303,7 +303,7 @@ subelement.</p> | |||||
| <p>Assertion statements are currently ignored in non-forked mode.</p> | <p>Assertion statements are currently ignored in non-forked mode.</p> | ||||
| <p><em>since Ant 1.6.</em></p> | |||||
| <p><em>since Ant 1.6</em>.</p> | |||||
| <h4 id="redirector">redirector</h4> | <h4 id="redirector">redirector</h4> | ||||
| <em>Since Ant 1.6.2</em> | <em>Since Ant 1.6.2</em> | ||||
| @@ -32,7 +32,7 @@ source files to compile. Only Java files that have no corresponding | |||||
| <code>.class</code> file | <code>.class</code> file | ||||
| or where the class file is older than the | or where the class file is older than the | ||||
| <code>.java</code> file will be compiled.</p> | <code>.java</code> file will be compiled.</p> | ||||
| <p>Note: Apache Ant uses only the names of the source and class files to find | |||||
| <p><strong>Note</strong>: Apache Ant uses only the names of the source and class files to find | |||||
| the classes that need a rebuild. It will not scan the source and therefore | the classes that need a rebuild. It will not scan the source and therefore | ||||
| will have no knowledge about nested classes, classes that are named different | will have no knowledge about nested classes, classes that are named different | ||||
| from the source file, and so on. See the | from the source file, and so on. See the | ||||
| @@ -120,7 +120,7 @@ switch <code>-depend</code> instead of <code>-Xdepend</code>.</p> | |||||
| files/directories from the classpath it passes to the compiler.</p> | files/directories from the classpath it passes to the compiler.</p> | ||||
| <p>The working directory for a forked executable (if any) is the | <p>The working directory for a forked executable (if any) is the | ||||
| project's base directory.</p> | project's base directory.</p> | ||||
| <p><strong>Windows Note:</strong>When the modern compiler is used | |||||
| <p><strong>Windows Note</strong>: When the modern compiler is used | |||||
| in unforked mode on Windows, it locks up the files present in the | in unforked mode on Windows, it locks up the files present in the | ||||
| classpath of the <code><javac></code> task, and does not release them. | classpath of the <code><javac></code> task, and does not release them. | ||||
| The side effect of this is that you will not be able to delete or move | The side effect of this is that you will not be able to delete or move | ||||
| @@ -224,7 +224,7 @@ invoking the compiler.</p> | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">encoding</td> | <td valign="top">encoding</td> | ||||
| <td valign="top">Encoding of source files. (Note: gcj doesn't support | |||||
| <td valign="top">Encoding of source files. (<strong>Note</strong>: gcj doesn't support | |||||
| this option yet.)</td> | this option yet.)</td> | ||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| @@ -319,7 +319,7 @@ invoking the compiler.</p> | |||||
| <td valign="top">Whether to include the default run-time | <td valign="top">Whether to include the default run-time | ||||
| libraries from the executing VM in the classpath; | libraries from the executing VM in the classpath; | ||||
| defaults to <code>no</code>.<br/> | defaults to <code>no</code>.<br/> | ||||
| <b>Note:</b> In some setups the run-time libraries may be part | |||||
| <strong>Note</strong>: In some setups the run-time libraries may be part | |||||
| of the "Ant run-time libraries" so you may need to explicitly | of the "Ant run-time libraries" so you may need to explicitly | ||||
| set includeAntRuntime to false to ensure that the Java | set includeAntRuntime to false to ensure that the Java | ||||
| run-time libraries are not included.</td> | run-time libraries are not included.</td> | ||||
| @@ -337,7 +337,7 @@ invoking the compiler.</p> | |||||
| executable to use in case of <code>fork="yes"</code>. | executable to use in case of <code>fork="yes"</code>. | ||||
| Defaults to the compiler of the Java version that is currently | Defaults to the compiler of the Java version that is currently | ||||
| running Ant. Ignored if <code>fork="no"</code>.<br> | running Ant. Ignored if <code>fork="no"</code>.<br> | ||||
| Since Ant 1.6 this attribute can also be used to specify the | |||||
| <em>Since Ant 1.6</em> this attribute can also be used to specify the | |||||
| path to the executable when using jikes, jvc, gcj or sj.</td> | path to the executable when using jikes, jvc, gcj or sj.</td> | ||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| @@ -461,8 +461,8 @@ invoking the compiler.</p> | |||||
| Some package level annotations in <code>package-info.java</code> | Some package level annotations in <code>package-info.java</code> | ||||
| files don't create any <code>package-info.class</code> files so | files don't create any <code>package-info.class</code> files so | ||||
| Ant would recompile the same file every time.<br/> | Ant would recompile the same file every time.<br/> | ||||
| Starting with Ant 1.8 Ant will create an | |||||
| empty <code>package-info.class</code> for | |||||
| <em>Since Ant 1.8</em>, an | |||||
| empty <code>package-info.class</code> is created for | |||||
| each <code>package-info.java</code> if there isn't one created | each <code>package-info.java</code> if there isn't one created | ||||
| by the compiler.<br/> | by the compiler.<br/> | ||||
| In some setups this additional class causes problems and it can | In some setups this additional class causes problems and it can | ||||
| @@ -594,7 +594,7 @@ used.</p> | |||||
| <td valign="top">prefix</td> | <td valign="top">prefix</td> | ||||
| <td align="center" rowspan="2">See | <td align="center" rowspan="2">See | ||||
| <a href="../using.html#arg">Command-line Arguments</a>. | <a href="../using.html#arg">Command-line Arguments</a>. | ||||
| <em>Since Ant 1.8.</em></td> | |||||
| <em>Since Ant 1.8</em>.</td> | |||||
| <td valign="top" align="center">No</td> | <td valign="top" align="center">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -612,7 +612,7 @@ used.</p> | |||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <h4>compilerclasspath <em>since Ant 1.8.0</em></h4> | |||||
| <h4>compilerclasspath (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>A <a href="../using.html#path">PATH like structure</a> holding the | <p>A <a href="../using.html#path">PATH like structure</a> holding the | ||||
| classpath to use when loading the compiler implementation if a | classpath to use when loading the compiler implementation if a | ||||
| @@ -620,7 +620,7 @@ used.</p> | |||||
| using one of the built-in compilers.</p> | using one of the built-in compilers.</p> | ||||
| <h4>Any nested element of a type that implements CompilerAdapter | <h4>Any nested element of a type that implements CompilerAdapter | ||||
| <em>since Ant 1.8.0</em></h4> | |||||
| (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>If a defined type implements the <code>CompilerAdapter</code> | <p>If a defined type implements the <code>CompilerAdapter</code> | ||||
| interface a nested element of that type can be used as an | interface a nested element of that type can be used as an | ||||
| @@ -713,7 +713,7 @@ Java VM of a different version:</p> | |||||
| executable="/opt/java/jdk1.1/bin/javac" | executable="/opt/java/jdk1.1/bin/javac" | ||||
| compiler="javac1.1"/></pre> | compiler="javac1.1"/></pre> | ||||
| <p id="srcdirnote"><b>Note:</b> | |||||
| <p id="srcdirnote"><strong>Note</strong>: | |||||
| If you wish to compile only source files located in certain packages below a | If you wish to compile only source files located in certain packages below a | ||||
| common root, use the <code>include</code>/<code>exclude</code> attributes | common root, use the <code>include</code>/<code>exclude</code> attributes | ||||
| or <code><include></code>/<code><exclude></code> nested elements | or <code><include></code>/<code><exclude></code> nested elements | ||||
| @@ -748,7 +748,7 @@ could show in the log, that these settings are fix.</p> | |||||
| fork="true" | fork="true" | ||||
| taskname="javac1.4"/></pre> | taskname="javac1.4"/></pre> | ||||
| <p><b>Note:</b> If you are using Ant on Windows and a new DOS window pops up | |||||
| <p><strong>Note</strong>: If you are using Ant on Windows and a new DOS window pops up | |||||
| for every use of an external compiler, this may be a problem of the JDK you are | for every use of an external compiler, this may be a problem of the JDK you are | ||||
| using. This problem may occur with all JDKs < 1.2.</p> | using. This problem may occur with all JDKs < 1.2.</p> | ||||
| @@ -887,8 +887,8 @@ while all others are <code>false</code>.</p> | |||||
| The Sun javac compiler has a <em>bootclasspath</em> command | The Sun javac compiler has a <em>bootclasspath</em> command | ||||
| line option - this corresponds to the "bootclasspath" attribute/element | line option - this corresponds to the "bootclasspath" attribute/element | ||||
| of the <javac> task. The Sun compiler also allows more | of the <javac> task. The Sun compiler also allows more | ||||
| control over the boot classpath using the -X and -J-X attributes. | |||||
| One can set these by using the <compilerarg>. Since Ant 1.6.0, | |||||
| control over the boot classpath using the <code>-X</code> and <code>-J-X</code> attributes. | |||||
| One can set these by using the <compilerarg>. <em>Since Ant 1.6.0</em>, | |||||
| there is a shortcut to convert path references to strings that | there is a shortcut to convert path references to strings that | ||||
| can by used in an OS independent fashion (see | can by used in an OS independent fashion (see | ||||
| <a href="../using.html#pathshortcut">pathshortcut</a>). For example: | <a href="../using.html#pathshortcut">pathshortcut</a>). For example: | ||||
| @@ -934,7 +934,7 @@ while all others are <code>false</code>.</p> | |||||
| <code>package-info.java</code> files were introduced in Java 5 to | <code>package-info.java</code> files were introduced in Java 5 to | ||||
| allow package level annotations. On compilation, if the java file | allow package level annotations. On compilation, if the java file | ||||
| does not contain runtime annotations, there will be no .class file | does not contain runtime annotations, there will be no .class file | ||||
| for the java file. Up to <b>Ant 1.7.1</b>, when the <javac> | |||||
| for the java file. Prior to Ant 1.7.1, when the <javac> | |||||
| task is run again, the | task is run again, the | ||||
| task will try to compile the package-info java files again. | task will try to compile the package-info java files again. | ||||
| </p> | </p> | ||||
| @@ -942,8 +942,8 @@ while all others are <code>false</code>.</p> | |||||
| involved the timestamp of the directory that would normally | involved the timestamp of the directory that would normally | ||||
| contain the .class file. This logic turned out to lead to Ant not | contain the .class file. This logic turned out to lead to Ant not | ||||
| recompiling <code>package-info.java</code> in certain setup.</p> | recompiling <code>package-info.java</code> in certain setup.</p> | ||||
| <p>Starting with Ant 1.8.0 Ant will create | |||||
| "empty" <code>package-info.class</code> files if it compiles | |||||
| <p><em>Since Ant 1.8.0</em>, an | |||||
| "empty" <code>package-info.class</code> file is created if Ant compiles | |||||
| a <code>package-info.java</code> and | a <code>package-info.java</code> and | ||||
| no <code>package-info.class</code> file has been created by the | no <code>package-info.class</code> file has been created by the | ||||
| compiler itself.</p> | compiler itself.</p> | ||||
| @@ -35,18 +35,18 @@ and management costs over time. This task, however, has no notion of | |||||
| "changed" files, unlike the <a href="javac.html">javac</a> task. This means | "changed" files, unlike the <a href="javac.html">javac</a> task. This means | ||||
| all packages will be processed each time this task is run. In general, however, | all packages will be processed each time this task is run. In general, however, | ||||
| this task is used much less frequently.</p> | this task is used much less frequently.</p> | ||||
| <p>NOTE: since javadoc calls System.exit(), javadoc cannot be run inside the | |||||
| <p><strong>Note</strong>: since javadoc calls System.exit(), javadoc cannot be run inside the | |||||
| same VM as Apache Ant without breaking functionality. For this reason, this task | same VM as Apache Ant without breaking functionality. For this reason, this task | ||||
| always forks the VM. This overhead is not significant since javadoc is normally a heavy | always forks the VM. This overhead is not significant since javadoc is normally a heavy | ||||
| application and will be called infrequently.</p> | application and will be called infrequently.</p> | ||||
| <p>NOTE: the packagelist attribute allows you to specify the list of packages to | |||||
| <p><strong>Note</strong>: the packagelist attribute allows you to specify the list of packages to | |||||
| document outside of the Ant file. It's a much better practice to include everything | document outside of the Ant file. It's a much better practice to include everything | ||||
| inside the <code>build.xml</code> file. This option was added in order to make it easier to | inside the <code>build.xml</code> file. This option was added in order to make it easier to | ||||
| migrate from regular makefiles, where you would use this option of javadoc. | migrate from regular makefiles, where you would use this option of javadoc. | ||||
| The packages listed in packagelist are not checked, so the task performs even | The packages listed in packagelist are not checked, so the task performs even | ||||
| if some packages are missing or broken. Use this option if you wish to convert from | if some packages are missing or broken. Use this option if you wish to convert from | ||||
| an existing makefile. Once things are running you should then switch to the regular | an existing makefile. Once things are running you should then switch to the regular | ||||
| notation. </p> | |||||
| notation.</p> | |||||
| <p><i><b>DEPRECATION:</b> the javadoc2 task simply points to the javadoc task and it's | <p><i><b>DEPRECATION:</b> the javadoc2 task simply points to the javadoc task and it's | ||||
| there for back compatibility reasons. Since this task will be removed in future | there for back compatibility reasons. Since this task will be removed in future | ||||
| @@ -59,14 +59,14 @@ any VM of at least version 1.2 is acceptable. JDKs <1.4 are no longer support | |||||
| If you specify the <code>executable</code> attribute it is up to you | If you specify the <code>executable</code> attribute it is up to you | ||||
| to ensure that this command supports the attributes you wish to use.</p> | to ensure that this command supports the attributes you wish to use.</p> | ||||
| <p><b>Note:</b><br>When generating the JavaDocs for classes which contains annotations | |||||
| <p><strong>Note</strong>:<br>When generating the JavaDocs for classes which contains annotations | |||||
| you maybe get a <tt>java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl</tt>. | you maybe get a <tt>java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl</tt>. | ||||
| This is due <a href="https://bugs.openjdk.java.net/browse/JDK-6442982" target="_blank">bug-6442982</a>. The cause is that JavaDoc cannot find the implementations of used annotations. | This is due <a href="https://bugs.openjdk.java.net/browse/JDK-6442982" target="_blank">bug-6442982</a>. The cause is that JavaDoc cannot find the implementations of used annotations. | ||||
| The workaround is providing the jars with these implementations (like JAXBs <tt>@XmlType</tt>, ...) | The workaround is providing the jars with these implementations (like JAXBs <tt>@XmlType</tt>, ...) | ||||
| to <javadoc> using <tt>classpath</tt>, <tt>classpathref</tt> attributes or nested | to <javadoc> using <tt>classpath</tt>, <tt>classpathref</tt> attributes or nested | ||||
| <classpath> element.</p> | <classpath> element.</p> | ||||
| <p><b>Note:</b> many problems with running javadoc stem from command | |||||
| <p><strong>Note</strong>: many problems with running javadoc stem from command | |||||
| lines that have become too long - even though the error message | lines that have become too long - even though the error message | ||||
| doesn't give the slightest hint this may be the problem. If you | doesn't give the slightest hint this may be the problem. If you | ||||
| encounter problems with the task, try to set | encounter problems with the task, try to set | ||||
| @@ -208,9 +208,9 @@ to <javadoc> using <tt>classpath</tt>, <tt>classpathref</tt> attributes or | |||||
| <td valign="top">Old</td> | <td valign="top">Old</td> | ||||
| <td valign="top">Generate output using JDK 1.1 emulating | <td valign="top">Generate output using JDK 1.1 emulating | ||||
| doclet.<br> | doclet.<br> | ||||
| <b>Note:</b> as of Ant 1.8.0 this attribute doesn't have any | |||||
| effect since the javadoc of Java 1.4 (required by Ant 1.8.0) | |||||
| doesn't support the -1.1 switch anymore.</td> | |||||
| <strong>Note</strong>: <em>Since Ant 1.8.0</em> this attribute has no | |||||
| effect since javadoc of Java 1.4 and later | |||||
| does not support the -1.1 switch anymore.</td> | |||||
| <td align="center" valign="top">1.2</td> | <td align="center" valign="top">1.2</td> | ||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| @@ -791,12 +791,12 @@ not set the description attribute for those tags.</p> | |||||
| <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#javadoctags">Javadoc reference guide</a>: | <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#javadoctags">Javadoc reference guide</a>: | ||||
| <pre>ejb.bean:t:XDoclet EJB Tag | <pre>ejb.bean:t:XDoclet EJB Tag | ||||
| todo:a:To Do</pre> | todo:a:To Do</pre> | ||||
| <b>Note:</b> The Javadoc reference quide has double quotes around | |||||
| <strong>Note</strong>: The Javadoc reference quide has double quotes around | |||||
| the description part of the definition. This will not work when used in | the description part of the definition. This will not work when used in | ||||
| a file, as the definition is quoted again when given to | a file, as the definition is quoted again when given to | ||||
| the javadoc program. | the javadoc program. | ||||
| <br/> | <br/> | ||||
| <b>Note:</b> If this attribute is specified, all the other attributes in this | |||||
| <strong>Note</strong>: If this attribute is specified, all the other attributes in this | |||||
| element will be ignored. | element will be ignored. | ||||
| </td> | </td> | ||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| @@ -38,7 +38,7 @@ systems are used.</p> | |||||
| attribute instead which allows you to compile the classes and | attribute instead which allows you to compile the classes and | ||||
| generate the native header files with a single step.</p> | generate the native header files with a single step.</p> | ||||
| <p><b>Note</b> the <code>javah</code> has been deprecated as of Java 9 | |||||
| <p><strong>Note</strong>: <code>javah</code> has been deprecated as of Java 9 | |||||
| and removed as of Java 10. Trying to use it with Java 10 will | and removed as of Java 10. Trying to use it with Java 10 will | ||||
| fail.</p> | fail.</p> | ||||
| @@ -48,17 +48,17 @@ attribute or a nested element. Here are the choices of the | |||||
| attribute:</p> | attribute:</p> | ||||
| <ul> | <ul> | ||||
| <li>default - the default compiler for the platform.</li> | <li>default - the default compiler for the platform.</li> | ||||
| <li>sun (the standard compiler of the JDK)</li> | |||||
| <li>kaffeh (the native standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> | |||||
| <li>gcjh (the native standard compiler | |||||
| <li>sun - the standard compiler of the JDK.</li> | |||||
| <li>kaffeh - the native standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>.</li> | |||||
| <li>gcjh - the native standard compiler | |||||
| of <a href="http://gcc.gnu.org/java/" | of <a href="http://gcc.gnu.org/java/" | ||||
| target="_top">gcj and gij</a>) <em>since Apache Ant 1.8.2</em></li> | |||||
| target="_top">gcj and gij</a>. <em>Since Apache Ant 1.8.2</em></li> | |||||
| <li>forking - runs the javah executable via its command line | <li>forking - runs the javah executable via its command line | ||||
| interface in a separate process. Default when not running on | interface in a separate process. Default when not running on | ||||
| Kaffee or gcj/gij <em>since Ant 1.9.8</em></li> | |||||
| Kaffee or gcj/gij. <em>Since Ant 1.9.8</em></li> | |||||
| </ul> | </ul> | ||||
| <p><b>Note:</b> if you are using this task to work on multiple files | |||||
| <p><strong>Note</strong>: if you are using this task to work on multiple files | |||||
| the command line may become too long on some operating systems. | the command line may become too long on some operating systems. | ||||
| Unfortunately the javah command doesn't support command argument | Unfortunately the javah command doesn't support command argument | ||||
| files the way javac (for example) does, so all that can be done is | files the way javac (for example) does, so all that can be done is | ||||
| @@ -169,7 +169,7 @@ only if a given compiler implementation will be used.</p> | |||||
| <td valign="top">prefix</td> | <td valign="top">prefix</td> | ||||
| <td align="center" rowspan="2">See | <td align="center" rowspan="2">See | ||||
| <a href="../using.html#arg">Command-line Arguments</a>. | <a href="../using.html#arg">Command-line Arguments</a>. | ||||
| <em>Since Ant 1.8.</em></td> | |||||
| <em>Since Ant 1.8</em>.</td> | |||||
| <td valign="top" align="center">No</td> | <td valign="top" align="center">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -186,7 +186,7 @@ only if a given compiler implementation will be used.</p> | |||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <h4>implementationclasspath <em>since Ant 1.8.0</em></h4> | |||||
| <h4>implementationclasspath (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>A <a href="../using.html#path">PATH like structure</a> holding the | <p>A <a href="../using.html#path">PATH like structure</a> holding the | ||||
| classpath to use when loading the compiler implementation if a | classpath to use when loading the compiler implementation if a | ||||
| @@ -194,7 +194,7 @@ only if a given compiler implementation will be used.</p> | |||||
| using one of the built-in compilers.</p> | using one of the built-in compilers.</p> | ||||
| <h4>Any nested element of a type that implements JavahAdapter | <h4>Any nested element of a type that implements JavahAdapter | ||||
| <em>since Ant 1.8.0</em></h4> | |||||
| (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>If a defined type implements the <code>JavahAdapter</code> | <p>If a defined type implements the <code>JavahAdapter</code> | ||||
| interface a nested element of that type can be used as an | interface a nested element of that type can be used as an | ||||
| @@ -88,7 +88,7 @@ href="#nested">nested elements</a>.</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">includeruntime</td> | <td valign="top">includeruntime</td> | ||||
| <td valign="top">Implicitly add the classes required to run jdepend | <td valign="top">Implicitly add the classes required to run jdepend | ||||
| in forked mode. (Ignored if fork is disabled). Since Apache Ant 1.6.</td> | |||||
| in forked mode. (Ignored if fork is disabled). <em>Since Apache Ant 1.6</em>.</td> | |||||
| <td align="center" valign="top">No, default is "no".</td> | <td align="center" valign="top">No, default is "no".</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -30,7 +30,7 @@ version of the framework can be found at | |||||
| This task has been tested with JUnit 3.0 up to JUnit 3.8.2; it won't | This task has been tested with JUnit 3.0 up to JUnit 3.8.2; it won't | ||||
| work with versions prior to JUnit 3.0. It also works with JUnit 4.0, including | work with versions prior to JUnit 3.0. It also works with JUnit 4.0, including | ||||
| "pure" JUnit 4 tests using only annotations and no <code>JUnit4TestAdapter</code>.</p> | "pure" JUnit 4 tests using only annotations and no <code>JUnit4TestAdapter</code>.</p> | ||||
| <p><strong>Note:</strong> This task depends on external libraries not included | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included | |||||
| in the Apache Ant distribution. See <a href="../install.html#librarydependencies"> | in the Apache Ant distribution. See <a href="../install.html#librarydependencies"> | ||||
| Library Dependencies</a> for more information. | Library Dependencies</a> for more information. | ||||
| </p> | </p> | ||||
| @@ -58,7 +58,7 @@ a <code><classpath></code> element in a <code><taskdef></code> in th | |||||
| <li> | <li> | ||||
| Leave <code>ant-junit.jar</code> in its default location in <code>ANT_HOME/lib</code> | Leave <code>ant-junit.jar</code> in its default location in <code>ANT_HOME/lib</code> | ||||
| but include <code>junit.jar</code> in the <code><classpath></code> passed | but include <code>junit.jar</code> in the <code><classpath></code> passed | ||||
| to <code><junit></code>. <em>(since Ant 1.7)</em> | |||||
| to <code><junit></code>. <em>Since Ant 1.7</em> | |||||
| </li> | </li> | ||||
| </ol> | </ol> | ||||
| <p> | <p> | ||||
| @@ -108,7 +108,7 @@ elements</a>).</p> | |||||
| <code>failureproperty</code> can share a VM, so even if you set | <code>failureproperty</code> can share a VM, so even if you set | ||||
| <code>forkmode</code> to "once", Ant may have to create | <code>forkmode</code> to "once", Ant may have to create | ||||
| more than a single Java VM. This attribute is ignored for tests | more than a single Java VM. This attribute is ignored for tests | ||||
| that don't get forked into a new Java VM. <em>since Ant 1.6.2</em></td> | |||||
| that don't get forked into a new Java VM. <em>Since Ant 1.6.2</em></td> | |||||
| <td align="center" valign="top">No; default is <code>perTest</code>.</td> | <td align="center" valign="top">No; default is <code>perTest</code>.</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -196,7 +196,7 @@ elements</a>).</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">outputtoformatters</td> | <td valign="top">outputtoformatters</td> | ||||
| <td valign="top"> | <td valign="top"> | ||||
| <em>Since Ant 1.7.0.</em><br/> | |||||
| <em>Since Ant 1.7.0</em>.<br/> | |||||
| Send any output generated by tests to the test formatters. | Send any output generated by tests to the test formatters. | ||||
| This is "true" by default. | This is "true" by default. | ||||
| </td> | </td> | ||||
| @@ -369,7 +369,7 @@ subelement.</p> | |||||
| <p>Assertion statements are currently ignored in non-forked mode.</p> | <p>Assertion statements are currently ignored in non-forked mode.</p> | ||||
| <p><em>since Ant 1.6.</em></p> | |||||
| <p><em>Since Ant 1.6</em>.</p> | |||||
| <h4>modulepath</h4> | <h4>modulepath</h4> | ||||
| @@ -407,7 +407,7 @@ can be specified.</p> | |||||
| that your tests have written as some characters are illegal in XML | that your tests have written as some characters are illegal in XML | ||||
| documents and will be dropped.</p> | documents and will be dropped.</p> | ||||
| <p>The fourth formatter named <code>failure</code> (since Ant 1.8.0) | |||||
| <p>The fourth formatter named <code>failure</code> (<em>since Ant 1.8.0</em>) | |||||
| collects all failing <code>testXXX()</code> | collects all failing <code>testXXX()</code> | ||||
| methods and creates a new <code>TestCase</code> which delegates only these | methods and creates a new <code>TestCase</code> which delegates only these | ||||
| failing methods. The name and the location can be specified via Java System property or Ant property | failing methods. The name and the location can be specified via Java System property or Ant property | ||||
| @@ -664,7 +664,7 @@ supported.</p> | |||||
| test's <code>tearDown</code> method will never be called. The same | test's <code>tearDown</code> method will never be called. The same | ||||
| is true if the forked VM crashes for some other reason.</p> | is true if the forked VM crashes for some other reason.</p> | ||||
| <p>Starting with Ant 1.8.0, a special formatter is distributed with | |||||
| <p><em>Since Ant 1.8.0</em>, a special formatter is distributed with | |||||
| Ant that tries to load the testcase that was in the forked VM and | Ant that tries to load the testcase that was in the forked VM and | ||||
| invoke that class' <code>tearDown</code> method. This formatter has | invoke that class' <code>tearDown</code> method. This formatter has | ||||
| the following limitations:</p> | the following limitations:</p> | ||||
| @@ -28,7 +28,7 @@ Merge the individual XML files generated by the JUnit task and eventually apply | |||||
| a stylesheet on the resulting merged document to provide a browsable report of | a stylesheet on the resulting merged document to provide a browsable report of | ||||
| the testcases results. | the testcases results. | ||||
| <p><strong>Note:</strong> This task depends on external libraries not | |||||
| <p><strong>Note</strong>: This task depends on external libraries not | |||||
| included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information.</p> | for more information.</p> | ||||
| @@ -36,9 +36,9 @@ for more information.</p> | |||||
| <p>The task needs Apache <a | <p>The task needs Apache <a | ||||
| href="http://xml.apache.org/xalan-j/">Xalan 2.4.1+ or Xalan XSLTC</a> | href="http://xml.apache.org/xalan-j/">Xalan 2.4.1+ or Xalan XSLTC</a> | ||||
| (JDK 1.4 contains a version of Xalan-J 2.x while JDK 1.5 ships with a | |||||
| version of XSLTC). Starting from JDK 1.4.2-01 it ships with a bundled | |||||
| Xalan-J 2.4.1+, meaning that JDK version prior to 1.4.2-01 won't work | |||||
| (JDK 1.4 contains a version of Xalan 2.x, while JDK 1.5 ships with a | |||||
| version of XSLTC). Since version 1.4.2-01, JDK ships with a bundled | |||||
| Xalan 2.4.1+, meaning that JDK version prior to 1.4.2-01 won't work | |||||
| out of the box. The table below summarize the compatibility status. | out of the box. The table below summarize the compatibility status. | ||||
| </p> | </p> | ||||
| <table> | <table> | ||||
| @@ -46,13 +46,13 @@ out of the box. The table below summarize the compatibility status. | |||||
| <tr><td>2.4.1+</td><td>JDK 1.4.2-01+</td><td>OK</td></tr> | <tr><td>2.4.1+</td><td>JDK 1.4.2-01+</td><td>OK</td></tr> | ||||
| <tr><td>XSLTC</td><td>JDK 1.5.x</td><td>OK</td></tr> | <tr><td>XSLTC</td><td>JDK 1.5.x</td><td>OK</td></tr> | ||||
| <tr><td>2.x</td><td>JDK 1.4.x</td><td>DEPRECATED<br><i>Use ${ant.home}/etc/junit-frames-xalan1.xsl | <tr><td>2.x</td><td>JDK 1.4.x</td><td>DEPRECATED<br><i>Use ${ant.home}/etc/junit-frames-xalan1.xsl | ||||
| <br> Upgrade Xalan using the JDK endorsement mechanism</i></td></tr> | |||||
| <br>Upgrade Xalan using the JDK endorsement mechanism</i></td></tr> | |||||
| </table> | </table> | ||||
| <p>With Ant 1.6.2 we had to decide between supporting Xalan-J 1/Xalan J 2.4.1- | |||||
| <p>In Ant 1.6.2, we had to decide between supporting Xalan 1/Xalan 2.4.1- | |||||
| and Xalan 2.4.1+/XSLTC, since there was no way to support both couples at the same | and Xalan 2.4.1+/XSLTC, since there was no way to support both couples at the same | ||||
| time.</p> | time.</p> | ||||
| <p>With Ant 1.7 we had to drop support Xalan-J 1, since Xalan-J 1 has not | |||||
| <p><em>Since Ant 1.7</em>, we dropped support for Xalan 1, since Xalan 1 was not | |||||
| available anymore for quite some time.</p> | available anymore for quite some time.</p> | ||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| @@ -170,12 +170,12 @@ These tags can pass XSL parameters to the stylesheet. | |||||
| </table> | </table> | ||||
| <h4>classpath</h4> | <h4>classpath</h4> | ||||
| <p><em>Since Ant 1.9.5.</em> | |||||
| <p><em>Since Ant 1.9.5</em>. | |||||
| Like for the <a href="../CoreTasks/style.html#classpath">XSLT task</a>, | Like for the <a href="../CoreTasks/style.html#classpath">XSLT task</a>, | ||||
| a nested <classpath> will be used to load the processor.</p> | a nested <classpath> will be used to load the processor.</p> | ||||
| <h4>factory</h4> | <h4>factory</h4> | ||||
| <p><em>Since Ant 1.9.5.</em> | |||||
| <p><em>Since Ant 1.9.5</em>. | |||||
| Like for the <a href="../CoreTasks/style.html#factory">XSLT task</a>, | Like for the <a href="../CoreTasks/style.html#factory">XSLT task</a>, | ||||
| a nested <factory> can be used to specify factory settings.</p> | a nested <factory> can be used to specify factory settings.</p> | ||||
| @@ -68,7 +68,7 @@ the property is not set.</p> | |||||
| invoked with the <code>-verbose</code> or <code>-debug</code> | invoked with the <code>-verbose</code> or <code>-debug</code> | ||||
| switches) or modify the exit status to reflect an error. Setting this to | switches) or modify the exit status to reflect an error. Setting this to | ||||
| "true" implies setting failonerror to "false". | "true" implies setting failonerror to "false". | ||||
| <em>Since Ant 1.7.0.</em> | |||||
| <em>Since Ant 1.7.0</em>. | |||||
| </td> | </td> | ||||
| <td align="center" valign="top">No, default "false"</td> | <td align="center" valign="top">No, default "false"</td> | ||||
| </tr> | </tr> | ||||
| @@ -33,7 +33,7 @@ Also if the file is missing, the build is halted with an error, rather | |||||
| than a warning being printed. | than a warning being printed. | ||||
| </p> | </p> | ||||
| <p><strong>Note:</strong> the default value of this | |||||
| <p><strong>Note</strong>: the default value of this | |||||
| task's <code>prefixValues</code> attribute is different from the | task's <code>prefixValues</code> attribute is different from the | ||||
| default value of the same attribute in | default value of the same attribute in | ||||
| the <a href="property.html"><code><property></code></a> | the <a href="property.html"><code><property></code></a> | ||||
| @@ -34,7 +34,7 @@ property at a given scope "shadows" properties of the same name at higher scopes | |||||
| including the global scope. Note that using the Local task at the global | including the global scope. Note that using the Local task at the global | ||||
| level effectively makes the property local to the "anonymous target" in which | level effectively makes the property local to the "anonymous target" in which | ||||
| top-level operations are carried out; it will not be defined for other targets | top-level operations are carried out; it will not be defined for other targets | ||||
| in the buildfile. <b>Since Ant 1.8</b></p> | |||||
| in the buildfile. <em>Since Ant 1.8</em></p> | |||||
| <p>A property is made local if the <code><local></code> task | <p>A property is made local if the <code><local></code> task | ||||
| precedes its definition. See the examples section.</p> | precedes its definition. See the examples section.</p> | ||||
| @@ -195,7 +195,7 @@ | |||||
| If this element is not present, then any nested text in the macro invocation | If this element is not present, then any nested text in the macro invocation | ||||
| will be an error. If the text element is present, then the name | will be an error. If the text element is present, then the name | ||||
| becomes an attribute that gets set to the nested text of the macro invocation. | becomes an attribute that gets set to the nested text of the macro invocation. | ||||
| <em>Since ant 1.6.1.</em> | |||||
| <em>Since ant 1.6.1</em>. | |||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| The case of the text name is ignored. | The case of the text name is ignored. | ||||
| @@ -48,7 +48,7 @@ | |||||
| <code><attachments></code> container. | <code><attachments></code> container. | ||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| <strong>Note:</strong> This task may depend on external libraries | |||||
| <strong>Note</strong>: This task may depend on external libraries | |||||
| that are not included in the Ant distribution. | that are not included in the Ant distribution. | ||||
| See <a href="../install.html#librarydependencies">Library Dependencies</a> | See <a href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information. | for more information. | ||||
| @@ -284,7 +284,7 @@ in the message, whether it is specified as an external file or as text within | |||||
| the <code><message></code> element.</p> | the <code><message></code> element.</p> | ||||
| <h4>header</h4> | <h4>header</h4> | ||||
| <p><strong>Since Ant 1.7</strong>, arbitrary mail headers can be added by | |||||
| <p><em>Since Ant 1.7</em>, arbitrary mail headers can be added by | |||||
| specifying these attributes on one or more nested header elements:</p> | specifying these attributes on one or more nested header elements:</p> | ||||
| <table> | <table> | ||||
| @@ -305,8 +305,7 @@ the <code><message></code> element.</p> | |||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <p>It is permissible to duplicate the name attribute amongst multiple headers. | |||||
| </p> | |||||
| <p>It is permissible to duplicate the name attribute amongst multiple headers.</p> | |||||
| <h3>Examples</h3> | <h3>Examples</h3> | ||||
| @@ -42,7 +42,7 @@ href="../using.html#path">path</a>. Prior to Apache Ant 1.7 only | |||||
| To use a resource collection, the <code>todir</code> attribute must be | To use a resource collection, the <code>todir</code> attribute must be | ||||
| set.</p> | set.</p> | ||||
| <p><b>Since Ant 1.6.3</b>, the <i>file</i> attribute may be used to move | |||||
| <p><em>Since Ant 1.6.3</em>, the <i>file</i> attribute may be used to move | |||||
| (rename) an entire directory. If <i>tofile</i> denotes an existing file, or | (rename) an entire directory. If <i>tofile</i> denotes an existing file, or | ||||
| there is a directory by the same name in <i>todir</i>, the action will fail. | there is a directory by the same name in <i>todir</i>, the action will fail. | ||||
| </p> | </p> | ||||
| @@ -63,7 +63,7 @@ there is a directory by the same name in <i>todir</i>, the action will fail. | |||||
| <td valign="top">preservelastmodified</td> | <td valign="top">preservelastmodified</td> | ||||
| <td valign="top">Give the moved files the same last modified | <td valign="top">Give the moved files the same last modified | ||||
| time as the original source files. | time as the original source files. | ||||
| (<em>Note</em>: Ignored on Java 1.1)</td> | |||||
| (<strong>Note</strong>: Ignored on Java 1.1)</td> | |||||
| <td valign="top" align="center">No; defaults to false.</td> | <td valign="top" align="center">No; defaults to false.</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -65,11 +65,11 @@ | |||||
| element. Here are the choices of the attribute: | element. Here are the choices of the attribute: | ||||
| </p> | </p> | ||||
| <ul> | <ul> | ||||
| <li>default - the default converter for the platform - kaffee | |||||
| <li>default - the default converter for the platform: kaffee | |||||
| when run on Kaffee, builtin otherwise.</li> | when run on Kaffee, builtin otherwise.</li> | ||||
| <li>sun (used to be the standard converter of the JDK < 9)</li> | |||||
| <li>kaffe (the standard converter | |||||
| of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> | |||||
| <li>sun - used to be the standard converter of the JDK < 9</li> | |||||
| <li>kaffe - the standard converter | |||||
| of <a href="http://www.kaffe.org" target="_top">Kaffe</a></li> | |||||
| <li>builtin - Ant's internal implementation. <em>Since Ant | <li>builtin - Ant's internal implementation. <em>Since Ant | ||||
| 1.9.8</em></li> | 1.9.8</em></li> | ||||
| </ul> | </ul> | ||||
| @@ -191,7 +191,7 @@ only if a given converter implementation will be used.</p> | |||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <h4>implementationclasspath <em>since Apache Ant 1.8.0</em></h4> | |||||
| <h4>implementationclasspath (<em>since Apache Ant 1.8.0</em>)</h4> | |||||
| <p>A <a href="../using.html#path">PATH like structure</a> holding the | <p>A <a href="../using.html#path">PATH like structure</a> holding the | ||||
| classpath to use when loading the converter implementation if a | classpath to use when loading the converter implementation if a | ||||
| @@ -199,7 +199,7 @@ only if a given converter implementation will be used.</p> | |||||
| using one of the built-in converters.</p> | using one of the built-in converters.</p> | ||||
| <h4>Any nested element of a type that implements Native2AsciiAdapter | <h4>Any nested element of a type that implements Native2AsciiAdapter | ||||
| <em>since Ant 1.8.0</em></h4> | |||||
| (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>If a defined type implements the <code>Native2AsciiAdapter</code> | <p>If a defined type implements the <code>Native2AsciiAdapter</code> | ||||
| interface a nested element of that type can be used as an | interface a nested element of that type can be used as an | ||||
| @@ -58,7 +58,7 @@ supports most attributes of <code><fileset></code> | |||||
| or from the command line as<br> | or from the command line as<br> | ||||
| <code>ant -Dant.netrexxc.verbose=noverbose ...</code> | <code>ant -Dant.netrexxc.verbose=noverbose ...</code> | ||||
| </p> | </p> | ||||
| <p><strong>Note:</strong> This task depends on external libraries not | |||||
| <p><strong>Note</strong>: This task depends on external libraries not | |||||
| included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | included in the Apache Ant distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information.</p> | for more information.</p> | ||||
| @@ -32,7 +32,7 @@ | |||||
| PropertyHelper active on the current Project. This is somewhat advanced Apache Ant usage and | PropertyHelper active on the current Project. This is somewhat advanced Apache Ant usage and | ||||
| assumes a working familiarity with the modern Ant APIs. See the description of Ant's | assumes a working familiarity with the modern Ant APIs. See the description of Ant's | ||||
| <a href="../properties.html#propertyHelper">Property Helper</a> for more information. | <a href="../properties.html#propertyHelper">Property Helper</a> for more information. | ||||
| <b>Since Ant 1.8.0</b></p> | |||||
| <em>Since Ant 1.8.0</em></p> | |||||
| <h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
| @@ -24,7 +24,7 @@ | |||||
| <h1>Apache Ant Pvcs Task User Manual</h1> | <h1>Apache Ant Pvcs Task User Manual</h1> | ||||
| <p><b>Note:</b> | |||||
| <p><strong>Note</strong>: | |||||
| Before using this task, the user running Ant must have access to the | Before using this task, the user running Ant must have access to the | ||||
| commands of PVCS (get and pcli) and must have access to the | commands of PVCS (get and pcli) and must have access to the | ||||
| repository. Note that the way to specify the repository is platform | repository. Note that the way to specify the repository is platform | ||||
| @@ -123,13 +123,13 @@ have been regenerated by this task.</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">preserveLastModified</td> | <td valign="top">preserveLastModified</td> | ||||
| <td valign="top">Keep the file timestamp(s) even if the file(s) | <td valign="top">Keep the file timestamp(s) even if the file(s) | ||||
| is(are) modified. <em>since Apache Ant 1.8.0.</em></td> | |||||
| is(are) modified. <em>since Apache Ant 1.8.0</em>.</td> | |||||
| <td valign="top" align="center">No, defaults to false</td> | <td valign="top" align="center">No, defaults to false</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">failOnNoReplacements</td> | <td valign="top">failOnNoReplacements</td> | ||||
| <td valign="top">Whether to fail the build if the task didn't do | <td valign="top">Whether to fail the build if the task didn't do | ||||
| anything. <em>since Ant 1.8.0.</em></td> | |||||
| anything. <em>since Ant 1.8.0</em>.</td> | |||||
| <td valign="top" align="center">No, defaults to false</td> | <td valign="top" align="center">No, defaults to false</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| @@ -159,7 +159,7 @@ them.</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">expandProperties</td> | <td valign="top">expandProperties</td> | ||||
| <td valign="top">Whether to expand properties in the nested text. | <td valign="top">Whether to expand properties in the nested text. | ||||
| <em>since Ant 1.8.0.</em></td> | |||||
| <em>since Ant 1.8.0</em>.</td> | |||||
| <td align="center">No, defaults to true.</td> | <td align="center">No, defaults to true.</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| @@ -208,7 +208,7 @@ token]]></replacevalue> | |||||
| <td valign="top">Name of the property whose value is to serve as the replacement value.</td> | <td valign="top">Name of the property whose value is to serve as the replacement value.</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <p>Since Ant 1.8.0 token and value can be specified as nested elements | |||||
| <p><em>Since Ant 1.8.0</em> token and value can be specified as nested elements | |||||
| just like in the task itself.</p> | just like in the task itself.</p> | ||||
| <p>If neither <i>value</i> nor <i>property</i> is used, the value provided using the <code><replace></code> attribute <i>value</i> and/or the <code><replacevalue></code> element is used. If no value was specified using either of these options, the token is replaced with an empty string. | <p>If neither <i>value</i> nor <i>property</i> is used, the value provided using the <code><replace></code> attribute <i>value</i> and/or the <code><replacevalue></code> element is used. If no value was specified using either of these options, the token is replaced with an empty string. | ||||
| </p> | </p> | ||||
| @@ -233,9 +233,7 @@ token]]></replacevalue> | |||||
| </replace> | </replace> | ||||
| </pre></blockquote> | </pre></blockquote> | ||||
| <p>In file <code>configure.sh</code>, replace all instances of "@token1@" with "defaultvalue", all instances of "@token2@" with "value2", and all instances of "@token3@" with the value of the property "property.key", as it appears in property file <code>src/name.properties</code>.</p> | <p>In file <code>configure.sh</code>, replace all instances of "@token1@" with "defaultvalue", all instances of "@token2@" with "value2", and all instances of "@token3@" with the value of the property "property.key", as it appears in property file <code>src/name.properties</code>.</p> | ||||
| <p><b>Note:</b> It is possible to use either the <i>token</i>/<code><replacetoken></code> and <i>value</i>/<code><replacevalue></code> attributes/elements, the nested replacefilter elements, or both in the same operation. | |||||
| </p> | |||||
| <p><strong>Note</strong>: It is possible to use either the <i>token</i>/<code><replacetoken></code> and <i>value</i>/<code><replacevalue></code> attributes/elements, the nested replacefilter elements, or both in the same operation.</p> | |||||
| </body> | </body> | ||||
| </html> | </html> | ||||
| @@ -90,7 +90,7 @@ See details in the documentation of the <a href="../Types/regexp.html#implementa | |||||
| <tr> | <tr> | ||||
| <td valign="top">preserveLastModified</td> | <td valign="top">preserveLastModified</td> | ||||
| <td valign="top">Keep the file timestamp(s) even if the file(s) | <td valign="top">Keep the file timestamp(s) even if the file(s) | ||||
| is(are) modified. <em>since Ant 1.8.0.</em></td> | |||||
| is(are) modified. <em>since Ant 1.8.0</em>.</td> | |||||
| <td valign="top" align="center">No, defaults to false</td> | <td valign="top" align="center">No, defaults to false</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| @@ -29,7 +29,7 @@ | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Display or set a property containing the size of a nested | <p>Display or set a property containing the size of a nested | ||||
| <a href="../Types/resources.html#collection">Resource Collection</a>. | <a href="../Types/resources.html#collection">Resource Collection</a>. | ||||
| Can also be used as a condition. <b>Since Apache Ant 1.7</b></p> | |||||
| Can also be used as a condition. <em>Since Apache Ant 1.7</em></p> | |||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| @@ -30,7 +30,7 @@ Task to automate a remote rexec session. Just like the Telnet task, | |||||
| it uses nested <tt><read></tt> to indicate strings to wait for, and | it uses nested <tt><read></tt> to indicate strings to wait for, and | ||||
| <tt><write></tt> tags to specify text to send to the remote process. | <tt><write></tt> tags to specify text to send to the remote process. | ||||
| <p><b>Note:</b> This task depends on external libraries not included in the Apache Ant distribution. | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant distribution. | |||||
| See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> | See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> | ||||
| <p>You can specify the commands you want to execute as nested elements | <p>You can specify the commands you want to execute as nested elements | ||||
| @@ -52,17 +52,15 @@ with the "build.rmic" property, the <code>compiler</code> | |||||
| attribute, or a nested element. Here are the choices:</p> | attribute, or a nested element. Here are the choices:</p> | ||||
| <ul> | <ul> | ||||
| <li>default -the default compiler (kaffe, sun or forking) for the platform. | <li>default -the default compiler (kaffe, sun or forking) for the platform. | ||||
| <li>sun (the standard compiler of the JDK < JDK 9)</li> | |||||
| <li>kaffe (the standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> | |||||
| <li>sun - the standard compiler of the JDK < 9</li> | |||||
| <li>kaffe - the standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a></li> | |||||
| <li>weblogic</li> | <li>weblogic</li> | ||||
| <li>forking - the sun compiler forked into a separate process (since | |||||
| Apache Ant 1.7). Starting with Ant 1.9.8 this is the default when | |||||
| running on JDK 9+.</li> | |||||
| <li>xnew - the sun compiler forked into a separate process, | |||||
| with the -Xnew option (since Ant 1.7). | |||||
| This is the most reliable way to use -Xnew. | |||||
| <br>JDK 9 has removed support for -Xnew and starting with Ant | |||||
| 1.9.8 this option will be rejected by Ant when running on JDK 9.</li> | |||||
| <li>forking - (<em>since Apache Ant 1.7</em>) the sun compiler forked into a separate process. | |||||
| <em>Since Ant 1.9.8</em>, this is the default when running on JDK 9+.</li> | |||||
| <li>xnew - (<em>since Ant 1.7</em>) the sun compiler forked into a separate process, | |||||
| with the -Xnew option. This is the most reliable way to use -Xnew.<br> | |||||
| JDK 9 has removed support for -Xnew and <em>since Ant 1.9.8</em> | |||||
| this option will be rejected when running on JDK 9.</li> | |||||
| <li> "" (empty string). This has the same behaviour as not setting the compiler attribute. | <li> "" (empty string). This has the same behaviour as not setting the compiler attribute. | ||||
| First the value of <tt>build.rmic</tt> is used if defined, and if not, the default | First the value of <tt>build.rmic</tt> is used if defined, and if not, the default | ||||
| for the platform is chosen. If build.rmic is set to this, you get the default.</li> | for the platform is chosen. If build.rmic is set to this, you get the default.</li> | ||||
| @@ -110,7 +108,7 @@ please consult miniRMI's documentation to learn how to use it.</p> | |||||
| <td valign="top">stubversion</td> | <td valign="top">stubversion</td> | ||||
| <td valign="top">Specify the JDK version for the generated stub code. | <td valign="top">Specify the JDK version for the generated stub code. | ||||
| Specify "1.1" to pass the "-v1.1" option to rmic, | Specify "1.1" to pass the "-v1.1" option to rmic, | ||||
| "1.2" for -v12, compat for -vcompat. <br> | |||||
| "1.2" for -v12, compat for -vcompat.<br> | |||||
| <em>Since Ant 1.7</em>, if you do not specify a version, and do not ask | <em>Since Ant 1.7</em>, if you do not specify a version, and do not ask | ||||
| for iiop or idl files, "compat" is selected. | for iiop or idl files, "compat" is selected. | ||||
| @@ -287,7 +285,7 @@ used.</p> | |||||
| <td valign="top">prefix</td> | <td valign="top">prefix</td> | ||||
| <td align="center" rowspan="2">See | <td align="center" rowspan="2">See | ||||
| <a href="../using.html#arg">Command-line Arguments</a>. | <a href="../using.html#arg">Command-line Arguments</a>. | ||||
| <em>Since Ant 1.8.</em></td> | |||||
| <em>Since Ant 1.8</em>.</td> | |||||
| <td valign="top" align="center">No</td> | <td valign="top" align="center">No</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -305,7 +303,7 @@ used.</p> | |||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <h4>compilerclasspath <em>since Ant 1.8.0</em></h4> | |||||
| <h4>compilerclasspath (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>A <a href="../using.html#path">PATH like structure</a> holding the | <p>A <a href="../using.html#path">PATH like structure</a> holding the | ||||
| classpath to use when loading the compiler implementation if a | classpath to use when loading the compiler implementation if a | ||||
| @@ -313,7 +311,7 @@ used.</p> | |||||
| using one of the built-in compilers.</p> | using one of the built-in compilers.</p> | ||||
| <h4>Any nested element of a type that implements RmicAdapter | <h4>Any nested element of a type that implements RmicAdapter | ||||
| <em>since Ant 1.8.0</em></h4> | |||||
| (<em>since Ant 1.8.0</em>)</h4> | |||||
| <p>If a defined type implements the <code>RmicAdapter</code> | <p>If a defined type implements the <code>RmicAdapter</code> | ||||
| interface a nested element of that type can be used as an | interface a nested element of that type can be used as an | ||||
| @@ -33,7 +33,7 @@ | |||||
| FileSet <i>only</i> works for copying files from the local machine to a | FileSet <i>only</i> works for copying files from the local machine to a | ||||
| remote machine.</p> | remote machine.</p> | ||||
| <p><b>Note:</b> This task depends on external libraries not included | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included | |||||
| in the Ant distribution. See <a | in the Ant distribution. See <a | ||||
| href="../install.html#librarydependencies">Library Dependencies</a> | href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information. This task has been tested with jsch-0.1.2 and later.</p> | for more information. This task has been tested with jsch-0.1.2 and later.</p> | ||||
| @@ -121,7 +121,7 @@ for more information. This task has been tested with jsch-0.1.2 and later.</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">trust</td> | <td valign="top">trust</td> | ||||
| <td valign="top">This trusts all unknown hosts if set to yes/true.<br> | <td valign="top">This trusts all unknown hosts if set to yes/true.<br> | ||||
| <strong>Note</strong> If you set this to false (the default), the | |||||
| <strong>Note</strong>: If you set this to false (the default), the | |||||
| host you connect to must be listed in your knownhosts file, this | host you connect to must be listed in your knownhosts file, this | ||||
| also implies that the file exists.</td> | also implies that the file exists.</td> | ||||
| <td valign="top" align="center">No, defaults to No.</td> | <td valign="top" align="center">No, defaults to No.</td> | ||||
| @@ -291,7 +291,7 @@ authentication.</b></p> | |||||
| </scp> | </scp> | ||||
| </pre> | </pre> | ||||
| <p><strong>Security Note:</strong> Hard coding passwords and/or usernames | |||||
| <p><strong>Security Note</strong>: Hardcoding passwords and/or usernames | |||||
| in scp task can be a serious security hole. Consider using variable | in scp task can be a serious security hole. Consider using variable | ||||
| substitution and include the password on the command line. For example: | substitution and include the password on the command line. For example: | ||||
| <p> | <p> | ||||
| @@ -309,7 +309,7 @@ system (via the ps command). The best approach is to use the | |||||
| .properties file. | .properties file. | ||||
| </p> | </p> | ||||
| <p><strong>Unix Note:</strong> File permissions are not retained when files | |||||
| <p><strong>Unix Note</strong>: File permissions are not retained when files | |||||
| are downloaded; they end up with the default <code>UMASK</code> permissions | are downloaded; they end up with the default <code>UMASK</code> permissions | ||||
| instead. This is caused by the lack of any means to query or set file | instead. This is caused by the lack of any means to query or set file | ||||
| permissions in the current Java runtimes. If you need a permission- | permissions in the current Java runtimes. If you need a permission- | ||||
| @@ -31,7 +31,7 @@ | |||||
| or | or | ||||
| <a href="https://scripting.dev.java.net">JSR 223</a> supported language. | <a href="https://scripting.dev.java.net">JSR 223</a> supported language. | ||||
| </p> | </p> | ||||
| <p><b>Note:</b> | |||||
| <p><strong>Note</strong>: | |||||
| This task depends on external libraries not included in the Apache Ant distribution. | This task depends on external libraries not included in the Apache Ant distribution. | ||||
| See <a href="../install.html#librarydependencies">Library Dependencies</a> | See <a href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information. | for more information. | ||||
| @@ -82,7 +82,7 @@ different location values.</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">manager</td> | <td valign="top">manager</td> | ||||
| <td valign="top"> | <td valign="top"> | ||||
| <em>Since: Ant 1.7.</em> | |||||
| <em>Since Ant 1.7</em>. | |||||
| The script engine manager to use. This can have | The script engine manager to use. This can have | ||||
| one of three values ("auto", "bsf" or "javax"). | one of three values ("auto", "bsf" or "javax"). | ||||
| The default value is "auto". | The default value is "auto". | ||||
| @@ -104,7 +104,7 @@ different location values.</p> | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">encoding</td> | <td valign="top">encoding</td> | ||||
| <td valign="top">The encoding of the script as a file. <em>since Ant 1.10.2.</em></td> | |||||
| <td valign="top">The encoding of the script as a file. <em>Since Ant 1.10.2</em>.</td> | |||||
| <td valign="top" align="center">No - defaults to default JVM encoding</td> | <td valign="top" align="center">No - defaults to default JVM encoding</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -153,7 +153,7 @@ different location values.</p> | |||||
| specific jar files. | specific jar files. | ||||
| </p> | </p> | ||||
| <p> | <p> | ||||
| <b>NB: (Since Ant 1.7.1)</b> | |||||
| <strong>Note</strong>: (<em>since Ant 1.7.1</em>) | |||||
| This classpath <em>can</em> be used to | This classpath <em>can</em> be used to | ||||
| specify the location of | specify the location of | ||||
| the BSF jar file and/or languages | the BSF jar file and/or languages | ||||
| @@ -41,7 +41,7 @@ of the script increases it would be better to migrate the task definition | |||||
| into a Java based custom task. | into a Java based custom task. | ||||
| </p> | </p> | ||||
| <p><b>Note:</b> This task depends on external libraries not included in the | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included in the | |||||
| Ant distribution. See | Ant distribution. See | ||||
| <a href="../install.html#librarydependencies">Library Dependencies</a> | <a href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information.</p> | for more information.</p> | ||||
| @@ -58,12 +58,12 @@ element name. This will return a list of all instances of the nested element. | |||||
| The instances in this list may be accessed by an integer index. | The instances in this list may be accessed by an integer index. | ||||
| </p> | </p> | ||||
| <p><b>Note:</b> Ant will turn all attribute and element names into all | |||||
| <p><strong>Note</strong>: Ant will turn all attribute and element names into all | |||||
| lowercase names, so even if you use name="SomeAttribute", you'll have | lowercase names, so even if you use name="SomeAttribute", you'll have | ||||
| to use "someattribute" to retrieve the attribute's value from the | to use "someattribute" to retrieve the attribute's value from the | ||||
| <code>attributes</code> collection.</p> | <code>attributes</code> collection.</p> | ||||
| <p>The name "self" (<i>since Ant 1.6.3</i>) is a pre-defined reference to the | |||||
| <p>The name "self" (<em>since Ant 1.6.3</em>) is a pre-defined reference to the | |||||
| script def task instance. | script def task instance. | ||||
| It can be used for logging, or for integration with the rest of | It can be used for logging, or for integration with the rest of | ||||
| Ant. the <code>self.text attribute</code> contains | Ant. the <code>self.text attribute</code> contains | ||||
| @@ -117,7 +117,7 @@ more information on writing scripts, please refer to the | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">encoding</td> | <td valign="top">encoding</td> | ||||
| <td valign="top">The encoding of the script as a file. <em>since Ant 1.10.2.</em></td> | |||||
| <td valign="top">The encoding of the script as a file. <em>since Ant 1.10.2</em>.</td> | |||||
| <td valign="top" align="center">No - defaults to default JVM encoding</td> | <td valign="top" align="center">No - defaults to default JVM encoding</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -126,7 +126,7 @@ more information on writing scripts, please refer to the | |||||
| evaluation for faster multiple executions, on the condition that the <em>manager</em> is "javax" and the | evaluation for faster multiple executions, on the condition that the <em>manager</em> is "javax" and the | ||||
| target engine implements <code>javax.script.Compilable</code>. | target engine implements <code>javax.script.Compilable</code>. | ||||
| Note that the <code>bsf</code> manager may automatically compiles the script. | Note that the <code>bsf</code> manager may automatically compiles the script. | ||||
| <em>since Ant 1.10.2.</em></td> | |||||
| <em>since Ant 1.10.2</em>.</td> | |||||
| <td valign="top" align="center">No - defaults to false</td> | <td valign="top" align="center">No - defaults to false</td> | ||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| @@ -25,7 +25,7 @@ | |||||
| <body> | <body> | ||||
| <h2 id="setpermissions">SetPermissions</h2> | <h2 id="setpermissions">SetPermissions</h2> | ||||
| <p><em>Since Ant 1.10.0.</em></p> | |||||
| <p><em>Since Ant 1.10.0</em>.</p> | |||||
| <h3>Description</h3> | <h3>Description</h3> | ||||
| <p>Changes the file permissions using Java's NIO support for | <p>Changes the file permissions using Java's NIO support for | ||||
| permissions.</p> | permissions.</p> | ||||
| @@ -30,7 +30,7 @@ | |||||
| the build failed or succeeded. You can specify either a specific | the build failed or succeeded. You can specify either a specific | ||||
| sound-file to play, or, if a directory is specified, the | sound-file to play, or, if a directory is specified, the | ||||
| <code><sound></code> task will randomly select a file to play. | <code><sound></code> task will randomly select a file to play. | ||||
| Note: At this point, the random selection is based on all the files | |||||
| <strong>Note</strong>: At this point, the random selection is based on all the files | |||||
| in the directory, not just those ending in appropriate suffixes | in the directory, not just those ending in appropriate suffixes | ||||
| for sound-files, so be sure you only have sound-files in the | for sound-files, so be sure you only have sound-files in the | ||||
| directory you specify.</p> | directory you specify.</p> | ||||
| @@ -124,7 +124,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||||
| <tr> | <tr> | ||||
| <td width="12%" valign="top">output</td> | <td width="12%" valign="top">output</td> | ||||
| <td width="78%" valign="top">Output file for result sets (defaults to System.out) | <td width="78%" valign="top">Output file for result sets (defaults to System.out) | ||||
| <b>Since Ant 1.8</b> can specify any Resource that supports output (see | |||||
| <em>Since Ant 1.8</em> can specify any Resource that supports output (see | |||||
| <a href="../develop.html#set-magic">note</a>). | <a href="../develop.html#set-magic">note</a>). | ||||
| </td> | </td> | ||||
| <td width="10%" valign="top">No (print to System.out by default)</td> | <td width="10%" valign="top">No (print to System.out by default)</td> | ||||
| @@ -226,7 +226,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||||
| <td width="12%" valign="top">showWarnings</td> | <td width="12%" valign="top">showWarnings</td> | ||||
| <td width="78%" valign="top">If true, SQLWarnings will be logged at | <td width="78%" valign="top">If true, SQLWarnings will be logged at | ||||
| the WARN level. <em>Since Ant 1.8.0</em>.<br/> | the WARN level. <em>Since Ant 1.8.0</em>.<br/> | ||||
| <b>Note:</b> even if the attribute is set to false, warnings that | |||||
| <strong>Note</strong>: even if the attribute is set to false, warnings that | |||||
| apply to the connection will be logged at the verbose level.</td> | apply to the connection will be logged at the verbose level.</td> | ||||
| <td width="10%" valign="top">No, default <em>false</em></td> | <td width="10%" valign="top">No, default <em>false</em></td> | ||||
| </tr> | </tr> | ||||
| @@ -256,7 +256,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||||
| quote character itself will be surrounded by the quote character. | quote character itself will be surrounded by the quote character. | ||||
| The quote character itself will be doubled if it appears inside of | The quote character itself will be doubled if it appears inside of | ||||
| the column's value.<br/> | the column's value.<br/> | ||||
| <b>Note:</b> BLOB values will never be quoted. | |||||
| <strong>Note</strong>: BLOB values will never be quoted. | |||||
| <em>Since Ant 1.8.0</em>.</td> | <em>Since Ant 1.8.0</em>.</td> | ||||
| <td width="10%" valign="top">No, default is not set (i.e. no quoting | <td width="10%" valign="top">No, default is not set (i.e. no quoting | ||||
| ever occurs)</td> | ever occurs)</td> | ||||
| @@ -29,10 +29,9 @@ | |||||
| <p><em>since Apache Ant 1.6</em></p> | <p><em>since Apache Ant 1.6</em></p> | ||||
| <p>Runs a command on a remote machine running SSH daemon. | |||||
| </p> | |||||
| <p>Runs a command on a remote machine running SSH daemon.</p> | |||||
| <p><b>Note:</b> This task depends on external libraries not included | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included | |||||
| in the Ant distribution. See <a | in the Ant distribution. See <a | ||||
| href="../install.html#librarydependencies">Library Dependencies</a> | href="../install.html#librarydependencies">Library Dependencies</a> | ||||
| for more information. This task has been tested with jsch-0.1.29 and above | for more information. This task has been tested with jsch-0.1.29 and above | ||||
| @@ -78,7 +77,7 @@ and won't work with versions of jsch earlier than | |||||
| <td valign="top">trust</td> | <td valign="top">trust</td> | ||||
| <td valign="top">This trusts all unknown hosts if set to yes/true.<br> | <td valign="top">This trusts all unknown hosts if set to yes/true.<br> | ||||
| <strong>Note</strong> If you set this to false (the default), the | |||||
| <strong>Note</strong>: If you set this to false (the default), the | |||||
| host you connect to must be listed in your knownhosts file, this | host you connect to must be listed in your knownhosts file, this | ||||
| also implies that the file exists.</td> | also implies that the file exists.</td> | ||||
| <td valign="top" align="center">No, defaults to No.</td> | <td valign="top" align="center">No, defaults to No.</td> | ||||
| @@ -283,7 +282,7 @@ and won't work with versions of jsch earlier than | |||||
| commandResource="to_run"/> | commandResource="to_run"/> | ||||
| </pre> | </pre> | ||||
| <p><strong>Security Note:</strong> Hard coding passwords and/or usernames | |||||
| <p><strong>Security Note</strong>: Hard coding passwords and/or usernames | |||||
| in sshexec task can be a serious security hole. Consider using variable | in sshexec task can be a serious security hole. Consider using variable | ||||
| substitution and include the password on the command line. For example:</p> | substitution and include the password on the command line. For example:</p> | ||||
| <pre> | <pre> | ||||
| @@ -35,7 +35,7 @@ remote tunnels over that connection, then executes any nested tasks | |||||
| before taking down the connection. | before taking down the connection. | ||||
| </p> | </p> | ||||
| <p><b>Note:</b> This task depends on external libraries not included | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included | |||||
| in the Ant | in the Ant | ||||
| distribution. See <a href="../install.html#librarydependencies">Library | distribution. See <a href="../install.html#librarydependencies">Library | ||||
| Dependencies</a> for more information. This task has been tested with | Dependencies</a> for more information. This task has been tested with | ||||
| @@ -90,7 +90,7 @@ and <a href="scp.html">scp</a> tasks</p> | |||||
| <td valign="top">trust</td> | <td valign="top">trust</td> | ||||
| <td valign="top">This trusts all unknown hosts if set to yes/true.<br> | <td valign="top">This trusts all unknown hosts if set to yes/true.<br> | ||||
| <strong>Note</strong> If you set this to false (the default), the | |||||
| <strong>Note</strong>: If you set this to false (the default), the | |||||
| host you connect to must be listed in your knownhosts file, this | host you connect to must be listed in your knownhosts file, this | ||||
| also implies that the file exists.</td> | also implies that the file exists.</td> | ||||
| <td valign="top" align="center">No, defaults to No.</td> | <td valign="top" align="center">No, defaults to No.</td> | ||||
| @@ -253,8 +253,7 @@ accessible, then run a get task using that tunnel.</b></p> | |||||
| </sshsession> | </sshsession> | ||||
| </pre> | </pre> | ||||
| <p><strong>Security Note:</strong> Hard coding passwords or | |||||
| <p><strong>Security Note</strong>: Hardcoding passwords or | |||||
| passphrases and/or usernames in sshsession task can be a serious | passphrases and/or usernames in sshsession task can be a serious | ||||
| security hole. Consider using variable substitution and include the | security hole. Consider using variable substitution and include the | ||||
| password on the command line. For example:</p> | password on the command line. For example:</p> | ||||
| @@ -30,7 +30,7 @@ | |||||
| <p>Process a set of documents via XSLT.</p> | <p>Process a set of documents via XSLT.</p> | ||||
| <p>This is useful for building views of XML based documentation, | <p>This is useful for building views of XML based documentation, | ||||
| or for generating code.</p> | or for generating code.</p> | ||||
| <p><b>Note:</b> If you are using JDK 1.4 or higher, this task does not require external libraries | |||||
| <p><strong>Note</strong>: If you are using JDK 1.4 or higher, this task does not require external libraries | |||||
| not supplied in the Apache Ant distribution. However, often the built in XSL engine is not as up | not supplied in the Apache Ant distribution. However, often the built in XSL engine is not as up | ||||
| to date as a fresh download, so an update is still highly recommended | to date as a fresh download, so an update is still highly recommended | ||||
| in particular since the built-in XSLT processors of Java 5 (and to a | in particular since the built-in XSLT processors of Java 5 (and to a | ||||
| @@ -50,7 +50,7 @@ inclusion/exclusion of files works, and how to write patterns.</p> | |||||
| as well as the nested <code><include></code>, <code><exclude></code> | as well as the nested <code><include></code>, <code><exclude></code> | ||||
| and <code><patternset></code> elements.</p> | and <code><patternset></code> elements.</p> | ||||
| <p><b>Note</b>: Unlike other similar tasks, this task treats | |||||
| <p><strong>Note</strong>: Unlike other similar tasks, this task treats | |||||
| directories that have been matched by the include/exclude patterns of | directories that have been matched by the include/exclude patterns of | ||||
| the implicit fileset in a special way. It will apply the stylesheets | the implicit fileset in a special way. It will apply the stylesheets | ||||
| to all files contain in them as well. Since the default include | to all files contain in them as well. Since the default include | ||||
| @@ -296,8 +296,8 @@ element is used to perform Entity and URI resolution.</p> | |||||
| <h4>param</h4> | <h4>param</h4> | ||||
| <p>Param is used to pass a parameter to the XSL stylesheet.</p> | <p>Param is used to pass a parameter to the XSL stylesheet.</p> | ||||
| <blockquote> | |||||
| <h4>Parameters</h4> | |||||
| <h5>Parameters</h5> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| <td valign="top"><b>Attribute</b></td> | <td valign="top"><b>Attribute</b></td> | ||||
| @@ -347,9 +347,7 @@ element is used to perform Entity and URI resolution.</p> | |||||
| <td valign="top">The param will not be passed <a href="../properties.html#if+unless">if this property is set</a>.</td> | <td valign="top">The param will not be passed <a href="../properties.html#if+unless">if this property is set</a>.</td> | ||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| </blockquote> | |||||
| <p> | <p> | ||||
| The <code>XPATH_*</code> types says that the <code>expression</code> is not just a primitive-type value but an XPath expression. | The <code>XPATH_*</code> types says that the <code>expression</code> is not just a primitive-type value but an XPath expression. | ||||
| @@ -367,8 +365,8 @@ element is used to perform Entity and URI resolution.</p> | |||||
| <p>Used to specify how you wish the result tree to be output | <p>Used to specify how you wish the result tree to be output | ||||
| as specified in the <a href="http://www.w3.org/TR/xslt#output"> | as specified in the <a href="http://www.w3.org/TR/xslt#output"> | ||||
| XSLT specifications</a>. | XSLT specifications</a>. | ||||
| <blockquote> | |||||
| <h4>Parameters</h4> | |||||
| <h5>Parameters</h5> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| <td valign="top"><b>Attribute</b></td> | <td valign="top"><b>Attribute</b></td> | ||||
| @@ -386,12 +384,11 @@ XSLT specifications</a>. | |||||
| <td align="center" valign="top">Yes</td> | <td align="center" valign="top">Yes</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| </blockquote> | |||||
| <h4 id="factory">factory ('trax' processors only)</h4> | <h4 id="factory">factory ('trax' processors only)</h4> | ||||
| Used to specify factory settings. | Used to specify factory settings. | ||||
| <blockquote> | |||||
| <h4>Parameters</h4> | |||||
| <h5>Parameters</h5> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| <td valign="top"><b>Attribute</b></td> | <td valign="top"><b>Attribute</b></td> | ||||
| @@ -409,8 +406,8 @@ Used to specify factory settings. | |||||
| <td align="center" valign="top">No. Defaults to the JAXP lookup mechanism.</td> | <td align="center" valign="top">No. Defaults to the JAXP lookup mechanism.</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| <h3>Parameters specified as nested elements</h3> | |||||
| <h4>attribute</h4> | |||||
| <h5>Parameters specified as nested elements</h5> | |||||
| <h6>attribute</h6> | |||||
| <p>Used to specify settings of the processor factory. | <p>Used to specify settings of the processor factory. | ||||
| The attribute names and values are entirely processor specific | The attribute names and values are entirely processor specific | ||||
| so you must be aware of the implementation to figure them out. | so you must be aware of the implementation to figure them out. | ||||
| @@ -431,7 +428,7 @@ And in Saxon 7.x: | |||||
| <li>...</li> | <li>...</li> | ||||
| </ul> | </ul> | ||||
| <blockquote> | <blockquote> | ||||
| <h4>Parameters</h4> | |||||
| <h6>Parameters</h6> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| <td valign="top"><b>Attribute</b></td> | <td valign="top"><b>Attribute</b></td> | ||||
| @@ -460,8 +457,9 @@ And in Saxon 7.x: | |||||
| with the given id. <em>since Ant 1.9.8</em></td> | with the given id. <em>since Ant 1.9.8</em></td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| </blockquote> | |||||
| <h4>Examples</h4> | |||||
| <h5>Examples</h5> | |||||
| <pre> | <pre> | ||||
| <path id="extension-path"> | <path id="extension-path"> | ||||
| @@ -478,10 +476,10 @@ And in Saxon 7.x: | |||||
| </pre> | </pre> | ||||
| <p>Sets the classloader to use when loading extension functions to a | <p>Sets the classloader to use when loading extension functions to a | ||||
| classloader using the <code>path</code> with the | classloader using the <code>path</code> with the | ||||
| id <code>extension-path</code>. | |||||
| </blockquote> | |||||
| <h4>feature</h4> | |||||
| id <code>extension-path</code>.</p> | |||||
| <p><em>since Ant 1.9.8</em></p> | <p><em>since Ant 1.9.8</em></p> | ||||
| <h6>feature</h6> | |||||
| <p>Used to specify settings of the processor factory. The feature | <p>Used to specify settings of the processor factory. The feature | ||||
| names are mostly processor specific so you must be aware of the | names are mostly processor specific so you must be aware of the | ||||
| implementation to figure them out. Read the documentation of your | implementation to figure them out. Read the documentation of your | ||||
| @@ -489,7 +487,7 @@ processor. The only feature all implementations are required to | |||||
| support | support | ||||
| is <code>http://javax.xml.XMLConstants/feature/secure-processing</code>. | is <code>http://javax.xml.XMLConstants/feature/secure-processing</code>. | ||||
| <blockquote> | <blockquote> | ||||
| <h4>Parameters</h4> | |||||
| <h6>Parameters</h6> | |||||
| <table> | <table> | ||||
| <tr> | <tr> | ||||
| <td valign="top"><b>Attribute</b></td> | <td valign="top"><b>Attribute</b></td> | ||||
| @@ -504,12 +502,12 @@ is <code>http://javax.xml.XMLConstants/feature/secure-processing</code>. | |||||
| <tr> | <tr> | ||||
| <td valign="top">value</td> | <td valign="top">value</td> | ||||
| <td valign="top">value of the feature. A boolean value | <td valign="top">value of the feature. A boolean value | ||||
| (i.e. permitted values are true,false,yes,no,on,off).</td> | |||||
| (i.e. permitted values are true, false, yes, no, on, off).</td> | |||||
| <td align="center" valign="top">No, defaults to false</td> | <td align="center" valign="top">No, defaults to false</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| </blockquote> | </blockquote> | ||||
| </blockquote> | |||||
| <h4>mapper</h4> | <h4>mapper</h4> | ||||
| <p><em>since Ant 1.6.2</em></p> | <p><em>since Ant 1.6.2</em></p> | ||||
| @@ -547,7 +545,6 @@ with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||||
| <p><em>since Ant 1.8.0</em>.</p> | <p><em>since Ant 1.8.0</em>.</p> | ||||
| <h3>Examples</h3> | <h3>Examples</h3> | ||||
| <blockquote> | |||||
| <pre> | <pre> | ||||
| <xslt basedir="doc" destdir="build/doc" | <xslt basedir="doc" destdir="build/doc" | ||||
| extension=".html" style="style/apache.xsl"/></pre> | extension=".html" style="style/apache.xsl"/></pre> | ||||
| @@ -670,8 +667,7 @@ with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||||
| <project> | <project> | ||||
| <xslt style="printFilename.xsl" destdir="out" basedir="in" extension=".txt" | <xslt style="printFilename.xsl" destdir="out" basedir="in" extension=".txt" | ||||
| filenameparameter="filename" | filenameparameter="filename" | ||||
| filedirparameter="filedir" | |||||
| /> | |||||
| filedirparameter="filedir"/> | |||||
| </project> | </project> | ||||
| <xsl:stylesheet | <xsl:stylesheet | ||||
| @@ -693,11 +689,9 @@ with <a href="../Types/propertyset.html">syspropertyset</a>s.</p> | |||||
| <pre> | <pre> | ||||
| <xslt ...> | <xslt ...> | ||||
| <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" | <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" | ||||
| value="org.apache.xerces.parsers.XIncludeParserConfiguration" | |||||
| /> | |||||
| value="org.apache.xerces.parsers.XIncludeParserConfiguration"/> | |||||
| <xslt> | <xslt> | ||||
| </pre> | </pre> | ||||
| </blockquote> | |||||
| </body> | </body> | ||||
| </html> | </html> | ||||
| @@ -52,7 +52,7 @@ set of links to record, or a set of property files to create links from. | |||||
| <tr> | <tr> | ||||
| <td valign="top">link</td> | <td valign="top">link</td> | ||||
| <td valign="top">The name of the link to be created or deleted.<br/> | <td valign="top">The name of the link to be created or deleted.<br/> | ||||
| <b>Note</b> this attribute is resolved against the current | |||||
| <strong>Note</strong>: this attribute is resolved against the current | |||||
| working directory rather than the project's basedir for | working directory rather than the project's basedir for | ||||
| historical reasons. It is recommended you always use an | historical reasons. It is recommended you always use an | ||||
| absolute path or a path like <code>${basedir}/some-path</code> | absolute path or a path like <code>${basedir}/some-path</code> | ||||
| @@ -124,7 +124,7 @@ set of links to record, or a set of property files to create links from. | |||||
| <symlink action="delete" link="${dir.top}/foo"/> | <symlink action="delete" link="${dir.top}/foo"/> | ||||
| </pre> | </pre> | ||||
| <p><strong>Java 1.2 and earlier:</strong> Due to limitations on executing system | |||||
| <p><strong>Java 1.2 and earlier</strong>: Due to limitations on executing system | |||||
| level commands in Java versions earlier than 1.3 this task may have difficulty | level commands in Java versions earlier than 1.3 this task may have difficulty | ||||
| operating with a relative path in ANT_HOME. The typical symptom is an | operating with a relative path in ANT_HOME. The typical symptom is an | ||||
| IOException where Apache Ant can't find /some/working/directory${ANT_HOME}/bin/antRun | IOException where Apache Ant can't find /some/working/directory${ANT_HOME}/bin/antRun | ||||
| @@ -132,7 +132,7 @@ set of links to record, or a set of property files to create links from. | |||||
| variable to an absolute path, which will remove the /some/working/directory portion | variable to an absolute path, which will remove the /some/working/directory portion | ||||
| of the above path and allow Ant to find the correct commandline execution script. | of the above path and allow Ant to find the correct commandline execution script. | ||||
| <p><strong>NOTE:</strong> Starting Ant version 1.10.2, this task relies on the symbolic | |||||
| <p><strong>Note</strong>: <em>Since Ant 1.10.2</em>, this task relies on the symbolic | |||||
| link support introduced in Java 7 through the java.nio.file.Files APIs</p> | link support introduced in Java 7 through the java.nio.file.Files APIs</p> | ||||
| </body> | </body> | ||||
| @@ -58,7 +58,7 @@ dir, it will get removed from the target.</p> | |||||
| <td valign="top">includeEmptyDirs</td> | <td valign="top">includeEmptyDirs</td> | ||||
| <td valign="top">Copy any empty directories included in the | <td valign="top">Copy any empty directories included in the | ||||
| resource collection(s).<br/> | resource collection(s).<br/> | ||||
| <b>Note</b> this attribute also controls the behavior for any | |||||
| <strong>Note</strong> this attribute also controls the behavior for any | |||||
| nested <preserveintarget> element. If this attribute is | nested <preserveintarget> element. If this attribute is | ||||
| false (the default) empty directories that only exist in the | false (the default) empty directories that only exist in the | ||||
| target directory will be removed even if they are matched by | target directory will be removed even if they are matched by | ||||
| @@ -243,11 +243,11 @@ and the rest are use the default mode (read-write by owner). The first | |||||
| fileset selects just the executable files. The second fileset must exclude | fileset selects just the executable files. The second fileset must exclude | ||||
| the executable files and include all others.</p> | the executable files and include all others.</p> | ||||
| <p><strong>Note:</strong> The tar task does not ensure that a file is only selected | |||||
| <p><strong>Note</strong>: The tar task does not ensure that a file is only selected | |||||
| by one resource collection. If the same file is selected by more than one collection, it will be included in the | by one resource collection. If the same file is selected by more than one collection, it will be included in the | ||||
| tar file twice, with the same path.</p> | tar file twice, with the same path.</p> | ||||
| <p><strong>Note:</strong> The patterns in the include and exclude | |||||
| <p><strong>Note</strong>: The patterns in the include and exclude | |||||
| elements are considered to be relative to the corresponding dir | elements are considered to be relative to the corresponding dir | ||||
| attribute as with all other filesets. In the example above, | attribute as with all other filesets. In the example above, | ||||
| <code>${dist.name}</code> is not an absolute path, but a simple name | <code>${dist.name}</code> is not an absolute path, but a simple name | ||||
| @@ -265,7 +265,7 @@ Unix file permissions have been stored as part of the ZIP file, they | |||||
| will be retained in the resulting tar archive.</p> | will be retained in the resulting tar archive.</p> | ||||
| <p><strong>Note:</strong> | |||||
| <p><strong>Note</strong>: | |||||
| Please note the tar task creates a tar file, it does not append | Please note the tar task creates a tar file, it does not append | ||||
| to an existing tar file. The existing tar file is replaced instead. | to an existing tar file. The existing tar file is replaced instead. | ||||
| As with most tasks in Ant, the task only takes action if the output | As with most tasks in Ant, the task only takes action if the output | ||||
| @@ -32,7 +32,7 @@ nested <tt><read></tt> to indicate strings to wait for, and | |||||
| <p>If you do specify a userid and password, the system will | <p>If you do specify a userid and password, the system will | ||||
| assume a common unix prompt to wait on. This behavior can be easily over-ridden.</p> | assume a common unix prompt to wait on. This behavior can be easily over-ridden.</p> | ||||
| <p><b>Note:</b> This task depends on external libraries not included in the Apache Ant distribution. | |||||
| <p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant distribution. | |||||
| See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> | See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> | ||||
| <h3>Parameters</h3> | <h3>Parameters</h3> | ||||
| @@ -32,7 +32,7 @@ at the same time. In addition to working with a single file, this Task | |||||
| can also work on <a href="../Types/resources.html">resources</a> and | can also work on <a href="../Types/resources.html">resources</a> and | ||||
| resource collections (which also includes directories). Prior to Apache Ant | resource collections (which also includes directories). Prior to Apache Ant | ||||
| 1.7 only FileSet or <a href="../Types/filelist.html">Filelist</a> | 1.7 only FileSet or <a href="../Types/filelist.html">Filelist</a> | ||||
| (since Ant 1.6) have been supported.</p> | |||||
| (<em>since Ant 1.6</em>) have been supported.</p> | |||||
| <p>Ant uses the API of <code>java.io.File</code> to set the last | <p>Ant uses the API of <code>java.io.File</code> to set the last | ||||
| modification time which has some limitations. For example the | modification time which has some limitations. For example the | ||||
| @@ -99,7 +99,7 @@ resource collections (which also includes directories). Prior to Apache Ant | |||||
| <p>You can use any number of nested resource collection elements to | <p>You can use any number of nested resource collection elements to | ||||
| define the resources for this task and refer to resources defined | define the resources for this task and refer to resources defined | ||||
| elsewhere. <b>Note:</b> resources passed to this task must implement | |||||
| elsewhere. <strong>Note</strong>: resources passed to this task must implement | |||||
| the <code>org.apache.tools.ant.types.resources.Touchable</code> | the <code>org.apache.tools.ant.types.resources.Touchable</code> | ||||
| interface, this is true for all filesystem-based resources like those | interface, this is true for all filesystem-based resources like those | ||||
| returned by path, fileset ot filelist.</p> | returned by path, fileset ot filelist.</p> | ||||
| @@ -88,7 +88,7 @@ a single file, this Task can also work on | |||||
| <p>You can use any number of nested resource collection elements to | <p>You can use any number of nested resource collection elements to | ||||
| define the resources for this task and refer to resources defined | define the resources for this task and refer to resources defined | ||||
| elsewhere. <b>Note:</b> resources passed to this task are expected | |||||
| elsewhere. <strong>Note</strong>: resources passed to this task are expected | |||||
| to be filesystem-based.</p> | to be filesystem-based.</p> | ||||
| <h3>Examples</h3> | <h3>Examples</h3> | ||||
| @@ -91,7 +91,7 @@ archive.</p> | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">compression</td> | <td valign="top">compression</td> | ||||
| <td valign="top"><b>Note:</b> This attribute is only available for | |||||
| <td valign="top"><strong>Note</strong>: This attribute is only available for | |||||
| the <code>untar</code> task.<br> | the <code>untar</code> task.<br> | ||||
| compression method. Allowable values are "none", | compression method. Allowable values are "none", | ||||
| "gzip", "xz" and "bzip2". Default is | "gzip", "xz" and "bzip2". Default is | ||||
| @@ -130,7 +130,7 @@ archive.</p> | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">scanForUnicodeExtraFields</td> | <td valign="top">scanForUnicodeExtraFields</td> | ||||
| <td valign="top"><b>Note:</b> This attribute is not available for | |||||
| <td valign="top"><strong>Note</strong>: This attribute is not available for | |||||
| the <code>untar</code> task.<br> | the <code>untar</code> task.<br> | ||||
| If the archive contains uncode extra fields then use them to set | If the archive contains uncode extra fields then use them to set | ||||
| the file names, ignoring the specified encoding. | the file names, ignoring the specified encoding. | ||||
| @@ -82,7 +82,7 @@ target execution depending on the relative age of the specified files.</p> | |||||
| <a href="../Types/fileset.html">fileset</a> and allows you to | <a href="../Types/fileset.html">fileset</a> and allows you to | ||||
| specify a set of files to check against the target file(s).</p> | specify a set of files to check against the target file(s).</p> | ||||
| <p><strong>Note:</strong> You can specify either the <code>srcfile</code> | |||||
| <p><strong>Note</strong>: You can specify either the <code>srcfile</code> | |||||
| attribute or nested <code><srcfiles></code> elements, but not both. | attribute or nested <code><srcfiles></code> elements, but not both. | ||||
| <p>Note that the task will completely ignore any directories that seem | <p>Note that the task will completely ignore any directories that seem | ||||
| @@ -212,7 +212,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||||
| that the permissions haven't been stored at all rather than real | that the permissions haven't been stored at all rather than real | ||||
| permissions and will instead apply its own default values.<br/> | permissions and will instead apply its own default values.<br/> | ||||
| Set this attribute to true if you really want to preserve the | Set this attribute to true if you really want to preserve the | ||||
| original permission field.<em>since Ant 1.8.0</em> | |||||
| original permission field. <em>since Ant 1.8.0</em> | |||||
| </td> | </td> | ||||
| <td valign="top" align="center">No, default is false</td> | <td valign="top" align="center">No, default is false</td> | ||||
| </tr> | </tr> | ||||
| @@ -75,7 +75,7 @@ | |||||
| The classpath to use, given as a | The classpath to use, given as a | ||||
| <a href="../using.html#references">reference</a> | <a href="../using.html#references">reference</a> | ||||
| to a path defined elsewhere. | to a path defined elsewhere. | ||||
| <em>Since Apache Ant 1.7.1.</em> | |||||
| <em>Since Apache Ant 1.7.1</em>. | |||||
| </td> | </td> | ||||
| <td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
| </tr> | </tr> | ||||
| @@ -145,7 +145,7 @@ is roughly equivalent to the following fragments in a build.xml file: | |||||
| </tr> | </tr> | ||||
| <tr> | <tr> | ||||
| <td valign="top">delimiter</td> | <td valign="top">delimiter</td> | ||||
| <td valign="top">Delimiter for splitting multiple values.<br><i>since Apache Ant 1.7.1</i></td> | |||||
| <td valign="top">Delimiter for splitting multiple values.<br><em>since Apache Ant 1.7.1</em></td> | |||||
| <td valign="top" align="center">No, defaults to comma</td> | <td valign="top" align="center">No, defaults to comma</td> | ||||
| </tr> | </tr> | ||||
| </table> | </table> | ||||
| @@ -210,7 +210,7 @@ archive.</p> | |||||
| <td valign="top">Whether the file modification times will be | <td valign="top">Whether the file modification times will be | ||||
| rounded up to the next even number of seconds.<br> | rounded up to the next even number of seconds.<br> | ||||
| Zip archives store file modification times with a granularity of | Zip archives store file modification times with a granularity of | ||||
| two seconds, so the times will either be rounded up or down. If | |||||
| two seconds, so the times will either be rounded up or down. If | |||||
| you round down, the archive will always seem out-of-date when you | you round down, the archive will always seem out-of-date when you | ||||
| rerun the task, so the default is to round up. Rounding up may | rerun the task, so the default is to round up. Rounding up may | ||||
| lead to a different type of problems like JSPs inside a web | lead to a different type of problems like JSPs inside a web | ||||
| @@ -246,7 +246,7 @@ archive.</p> | |||||
| <tr> | <tr> | ||||
| <td valign="top">useLanguageEncodingFlag</td> | <td valign="top">useLanguageEncodingFlag</td> | ||||
| <td valign="top">Whether to set the language encoding flag if the | <td valign="top">Whether to set the language encoding flag if the | ||||
| encoding is UTF-8. This setting doesn't have any effect if the | |||||
| encoding is UTF-8. This setting doesn't have any effect if the | |||||
| encoding is not UTF-8. | encoding is not UTF-8. | ||||
| <em>Since Ant 1.8.0</em>.<br/> | <em>Since Ant 1.8.0</em>.<br/> | ||||
| See also the <a href="#encoding">discussion below</a></td> | See also the <a href="#encoding">discussion below</a></td> | ||||
| @@ -301,7 +301,7 @@ archive.</p> | |||||
| <p>More recent versions of the ZIP specification introduce something | <p>More recent versions of the ZIP specification introduce something | ||||
| called the "language encoding flag" which can be used to | called the "language encoding flag" which can be used to | ||||
| signal that a file name has been encoded using UTF-8. <em>Since | signal that a file name has been encoded using UTF-8. <em>Since | ||||
| Ant 1.8.0</em>, all zip-/jar- and similar archives written by Ant will set | |||||
| Ant 1.8.0</em>, all zip, jar and similar archives written by Ant will set | |||||
| this flag, if the encoding has been set to UTF-8. Our | this flag, if the encoding has been set to UTF-8. Our | ||||
| interoperability tests with existing archivers didn't show any ill | interoperability tests with existing archivers didn't show any ill | ||||
| effects (in fact, most archivers ignore the flag to date), but you | effects (in fact, most archivers ignore the flag to date), but you | ||||
| @@ -345,7 +345,7 @@ archive.</p> | |||||
| jars from your CLASSPATH reads and writes UTF-8 names, it doesn't | jars from your CLASSPATH reads and writes UTF-8 names, it doesn't | ||||
| set or recognize any flags or unicode extra fields.</li> | set or recognize any flags or unicode extra fields.</li> | ||||
| <li>Starting with Java 7 <code>java.util.zip</code> writes UTF-8 by | |||||
| <li>Since Java 7, <code>java.util.zip</code> writes UTF-8 by | |||||
| default and uses the language encoding flag. It is possible to | default and uses the language encoding flag. It is possible to | ||||
| specify a different encoding when reading/writing ZIPs via new | specify a different encoding when reading/writing ZIPs via new | ||||
| constructors. The package now recognizes the language encoding | constructors. The package now recognizes the language encoding | ||||
| @@ -411,8 +411,8 @@ archive.</p> | |||||
| will be written has to be made before writing the entry's | will be written has to be made before writing the entry's | ||||
| content.</p> | content.</p> | ||||
| <p>Starting with Ant 1.9.0 Ant supports Zip64 extensions but didn't | |||||
| provide any control over their usage, starting with Ant 1.9.1 a | |||||
| <p>Ant 1.9.0 introduced support for Zip64 extensions but didn't | |||||
| provide any control over their usage. <em>Since Ant 1.9.1</em>, a | |||||
| new <em>zip64mode</em> attribute was added to the <code>zip</code> | new <em>zip64mode</em> attribute was added to the <code>zip</code> | ||||
| family of tasks. It supports three values: | family of tasks. It supports three values: | ||||
| @@ -420,7 +420,7 @@ archive.</p> | |||||
| <li><em>never</em> means no Zip64 extra fields will ever be | <li><em>never</em> means no Zip64 extra fields will ever be | ||||
| written, this is the behavior of Ant 1.8.x and earlier and the | written, this is the behavior of Ant 1.8.x and earlier and the | ||||
| default behavior of <code>jar</code>, <code>ear</code> | default behavior of <code>jar</code>, <code>ear</code> | ||||
| and <code>war</code> starting with Ant 1.9.1.</li> | |||||
| and <code>war</code> <em>since Ant 1.9.1</em>.</li> | |||||
| <li><em>always</em> means Zip64 extra fields are written for all | <li><em>always</em> means Zip64 extra fields are written for all | ||||
| entries.</li> | entries.</li> | ||||
| <li><em>as-needed</em> means Zip64 extra fields are written for all | <li><em>as-needed</em> means Zip64 extra fields are written for all | ||||
| @@ -461,29 +461,25 @@ the same way that <i>zipfileset src</i> files are added.</p> | |||||
| <h3>Examples</h3> | <h3>Examples</h3> | ||||
| <pre> <zip destfile="${dist}/manual.zip" | <pre> <zip destfile="${dist}/manual.zip" | ||||
| basedir="htdocs/manual" | |||||
| /></pre> | |||||
| basedir="htdocs/manual"/></pre> | |||||
| <p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | <p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | ||||
| in the <code>${dist}</code> directory.</p> | in the <code>${dist}</code> directory.</p> | ||||
| <pre> <zip destfile="${dist}/manual.zip" | <pre> <zip destfile="${dist}/manual.zip" | ||||
| basedir="htdocs/manual" | basedir="htdocs/manual" | ||||
| update="true" | |||||
| /></pre> | |||||
| update="true"/></pre> | |||||
| <p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | <p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | ||||
| in the <code>${dist}</code> directory. If <code>manual.zip</code> | in the <code>${dist}</code> directory. If <code>manual.zip</code> | ||||
| doesn't exist, it is created; otherwise it is updated with the | doesn't exist, it is created; otherwise it is updated with the | ||||
| new/changed files.</p> | new/changed files.</p> | ||||
| <pre> <zip destfile="${dist}/manual.zip" | <pre> <zip destfile="${dist}/manual.zip" | ||||
| basedir="htdocs/manual" | basedir="htdocs/manual" | ||||
| excludes="mydocs/**, **/todo.html" | |||||
| /></pre> | |||||
| excludes="mydocs/**, **/todo.html"/></pre> | |||||
| <p>zips all files in the <code>htdocs/manual</code> directory. Files in the directory <code>mydocs</code>, | <p>zips all files in the <code>htdocs/manual</code> directory. Files in the directory <code>mydocs</code>, | ||||
| or files with the name <code>todo.html</code> are excluded.</p> | or files with the name <code>todo.html</code> are excluded.</p> | ||||
| <pre> <zip destfile="${dist}/manual.zip" | <pre> <zip destfile="${dist}/manual.zip" | ||||
| basedir="htdocs/manual" | basedir="htdocs/manual" | ||||
| includes="api/**/*.html" | includes="api/**/*.html" | ||||
| excludes="**/todo.html" | |||||
| /></pre> | |||||
| excludes="**/todo.html"/></pre> | |||||
| <p>zips all files in the <code>htdocs/manual</code> directory. Only html files under the directory <code>api</code> | <p>zips all files in the <code>htdocs/manual</code> directory. Only html files under the directory <code>api</code> | ||||
| are zipped, and files with the name <code>todo.html</code> are excluded.</p> | are zipped, and files with the name <code>todo.html</code> are excluded.</p> | ||||
| <pre> <zip destfile="${dist}/manual.zip"> | <pre> <zip destfile="${dist}/manual.zip"> | ||||
| @@ -17,50 +17,70 @@ | |||||
| */ | */ | ||||
| h2 { | h2 { | ||||
| font-size: 200%; | font-size: 200%; | ||||
| background-color: ffffff; | |||||
| background-color: white; | |||||
| } | } | ||||
| h3 { | h3 { | ||||
| font-size: 130%; | font-size: 130%; | ||||
| color: #ffffff; | |||||
| color: white; | |||||
| background-color: #525D76; | background-color: #525D76; | ||||
| } | } | ||||
| h4 { | h4 { | ||||
| color: #ffffff; | |||||
| color: white; | |||||
| background-color: #828DA6; | background-color: #828DA6; | ||||
| } | } | ||||
| h5 { | |||||
| font-size: 100%; | |||||
| color: white; | |||||
| background-color: #a6adbe; | |||||
| margin-top: .5rem; | |||||
| margin-bottom: .5rem; | |||||
| } | |||||
| h6 { | |||||
| font-size: 100%; | |||||
| color: white; | |||||
| background-color: #c1c5d1; | |||||
| margin-top: .5rem; | |||||
| margin-bottom: .5rem; | |||||
| } | |||||
| h5 + p, h6 + p { | |||||
| margin-top: .5rem; | |||||
| margin-bottom: .5rem; | |||||
| } | |||||
| td { | td { | ||||
| background-color: eeeeee; | |||||
| color: 000000; | |||||
| background-color: #eeeeee; | |||||
| color: black; | |||||
| } | } | ||||
| /* first row */ | /* first row */ | ||||
| table tr:first-child td { | table tr:first-child td { | ||||
| background-color: cccccc; | |||||
| color: 000000; | |||||
| background-color: silver; | |||||
| color: black; | |||||
| } | } | ||||
| /* or th as first row */ | /* or th as first row */ | ||||
| table th { | table th { | ||||
| background-color: cccccc; | |||||
| color: 000000; | |||||
| background-color: silver; | |||||
| color: black; | |||||
| } | } | ||||
| pre { | pre { | ||||
| background-color: efefef; | |||||
| background-color: #efefef; | |||||
| } | } | ||||
| /* code snippets in examples and tutorials */ | /* code snippets in examples and tutorials */ | ||||
| .code { | .code { | ||||
| background: #EFEFEF; | background: #EFEFEF; | ||||
| margin-top: | |||||
| } | } | ||||
| /* highlight console output */ | /* highlight console output */ | ||||
| .output { | .output { | ||||
| color: #FFFFFF; | |||||
| color: white; | |||||
| background: #837A67; | background: #837A67; | ||||
| } | } | ||||