Added target attribute for external links (the web is no longer frame-friendlyâ¦)
Project: http://git-wip-us.apache.org/repos/asf/ant/repo Commit: http://git-wip-us.apache.org/repos/asf/ant/commit/97d81a72 Tree: http://git-wip-us.apache.org/repos/asf/ant/tree/97d81a72 Diff: http://git-wip-us.apache.org/repos/asf/ant/diff/97d81a72 Branch: refs/heads/master Commit: 97d81a726de13c369cc6b22ef1e6532df7b3d112 Parents: f02565d Author: Gintas Grigelionis <gin...@apache.org> Authored: Thu Mar 8 07:43:53 2018 +0100 Committer: Gintas Grigelionis <gin...@apache.org> Committed: Thu Mar 8 07:44:27 2018 +0100 ---------------------------------------------------------------------- manual/Integration/jext-plugin.html | 23 +- manual/Tasks/BorlandEJBTasks.html | 4 +- manual/Tasks/cab.html | 3 +- manual/Tasks/changelog.html | 12 +- manual/Tasks/checksum.html | 36 +- manual/Tasks/concat.html | 4 +- manual/Tasks/conditions.html | 6 +- manual/Tasks/cvs.html | 6 +- manual/Tasks/cvspass.html | 4 +- manual/Tasks/cvstagdiff.html | 2 +- manual/Tasks/defaultexcludes.html | 12 +- manual/Tasks/delete.html | 2 +- manual/Tasks/depend.html | 3 +- manual/Tasks/ear.html | 24 +- manual/Tasks/echo.html | 6 +- manual/Tasks/ejb.html | 48 ++- manual/Tasks/exec.html | 28 +- manual/Tasks/ftp.html | 51 +-- manual/Tasks/import.html | 6 +- manual/Tasks/include.html | 4 +- manual/Tasks/jar.html | 40 +- manual/Tasks/jarlib-available.html | 9 +- manual/Tasks/jarlib-display.html | 8 +- manual/Tasks/jarlib-manifest.html | 8 +- manual/Tasks/jarlib-resolve.html | 8 +- manual/Tasks/java.html | 4 +- manual/Tasks/javac.html | 24 +- manual/Tasks/javadoc.html | 30 +- manual/Tasks/javah.html | 11 +- manual/Tasks/jdepend.html | 3 +- manual/Tasks/jjdoc.html | 6 +- manual/Tasks/jjtree.html | 6 +- manual/Tasks/jspc.html | 11 +- manual/Tasks/junit.html | 7 +- manual/Tasks/junitreport.html | 8 +- manual/Tasks/loadfile.html | 2 +- manual/Tasks/loadresource.html | 2 +- manual/Tasks/macrodef.html | 8 +- manual/Tasks/mail.html | 8 +- manual/Tasks/manifest.html | 8 +- manual/Tasks/mimemail.html | 7 +- manual/Tasks/parallel.html | 2 +- manual/Tasks/pathconvert.html | 2 +- manual/Tasks/property.html | 15 +- manual/Tasks/pvcstask.html | 2 +- manual/Tasks/rmic.html | 14 +- manual/Tasks/schemavalidate.html | 21 +- manual/Tasks/script.html | 25 +- manual/Tasks/scriptdef.html | 21 +- manual/Tasks/setpermissions.html | 4 +- manual/Tasks/signjar.html | 19 +- manual/Tasks/sos.html | 4 +- manual/Tasks/sql.html | 4 +- manual/Tasks/style.html | 2 +- manual/Tasks/tar.html | 4 +- manual/Tasks/touch.html | 2 +- manual/Tasks/tstamp.html | 19 +- manual/Tasks/typedef.html | 15 +- manual/Tasks/unzip.html | 8 +- manual/Tasks/xmlvalidate.html | 14 +- manual/Tasks/zip.html | 12 +- manual/Types/assertions.html | 90 ++-- manual/Types/extension.html | 18 +- manual/Types/extensionset.html | 17 +- manual/Types/filterchain.html | 99 +++-- manual/Types/mapper.html | 166 ++++---- manual/Types/regexp.html | 37 +- manual/Types/selectors.html | 429 ++++++++++---------- manual/Types/tarfileset.html | 57 ++- manual/Types/xmlcatalog.html | 118 +++--- manual/Types/zipfileset.html | 42 +- manual/api/index.html | 13 +- manual/cover.html | 26 +- manual/develop.html | 12 +- manual/developlist.html | 4 +- manual/feedback.html | 65 ++- manual/ide.html | 38 +- manual/install.html | 26 +- manual/listeners.html | 245 +++++------ manual/platform.html | 161 ++++---- manual/properties.html | 353 +++++++--------- manual/proxy.html | 11 +- manual/running.html | 9 +- manual/tasksoverview.html | 54 ++- manual/tutorial-HelloWorldWithAnt.html | 28 +- manual/tutorial-tasks-filesets-properties.html | 60 +-- manual/tutorial-writing-tasks.html | 12 +- manual/using.html | 388 +++++++----------- 88 files changed, 1539 insertions(+), 1750 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Integration/jext-plugin.html ---------------------------------------------------------------------- diff --git a/manual/Integration/jext-plugin.html b/manual/Integration/jext-plugin.html index cf0734f..7cd2482 100644 --- a/manual/Integration/jext-plugin.html +++ b/manual/Integration/jext-plugin.html @@ -30,25 +30,24 @@ by <hr/> <p>You can download the plugin - at: <a href="http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download";>http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download</a></p> +at: <a href="http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download"; +target="_top">http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download</a></p> <h2>Installation instructions from the Readme.txt</h2> <p>You have to enable the Jext Console to see the Apache Ant output (menu: -Edit→Options…–General Panel), because Ant messages are -redirected to the Jext console.</p> +Edit→Options…–General Panel), because Ant messages are redirected to the Jext +console.</p> -<p>You can configure the Ant call in the Jext menu: Edit→Options…– -Plugin Options–Antwork Plugin Panel; here you can set Ant home -directory and the path to your build file.</p> +<p>You can configure the Ant call in the Jext menu: Edit→Options…– Plugin +Options–Antwork Plugin Panel; here you can set Ant home directory and the path to your build +file.</p> -<p>You can start AntWork in the menu: Plugins→Ant→Work Now! In the -appearing dialog box you can enter the target which you want to -compile.</p> +<p>You can start AntWork in the menu: Plugins→Ant→Work Now! In the appearing dialog box +you can enter the target which you want to compile.</p> -<p>If a <code>javac</code> error occurs in the Ant run, an error list opens within -Jext. With a double click on the error message you jump to the error -in the specified Java source file.</p> +<p>If a <code>javac</code> error occurs in the Ant run, an error list opens within Jext. With a +double click on the error message you jump to the error in the specified Java source file.</p> </body> </html> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/BorlandEJBTasks.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/BorlandEJBTasks.html b/manual/Tasks/BorlandEJBTasks.html index a401527..4bf5976 100644 --- a/manual/Tasks/BorlandEJBTasks.html +++ b/manual/Tasks/BorlandEJBTasks.html @@ -36,8 +36,8 @@ Deployment Descriptor, builds the jar file including the support files and verif produced jar is valid or not.</p> <p>Benoit Moussaud maintains a -separate <a href="https://web.archive.org/web/20141122083215/http://www.moussaud.org/ejbjar.html";>FAQ</a> -for this task at his homepage.</p> +separate <a href="https://web.archive.org/web/20141122083215/http://www.moussaud.org/ejbjar.html"; +target="_top">FAQ</a> for this task at his homepage.</p> <h3>Borland element</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/cab.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/cab.html b/manual/Tasks/cab.html index 1934cd5..d83487c 100644 --- a/manual/Tasks/cab.html +++ b/manual/Tasks/cab.html @@ -31,7 +31,8 @@ the <a href="../Tasks/jar.html">jar</a> or <a href="../Tasks/zip.html">zip</a> t will work on Windows using the external <code>cabarc</code> tool (provided by Microsoft) which must be located in your executable path.</p> <p>To use this task on other platforms you need to download and compile <code>libcabinet</code> -from <a href="https://www.freshports.org/archivers/libcabinet/";>https://www.freshports.org/archivers/libcabinet/</a>.</p> +from <a href="https://www.freshports.org/archivers/libcabinet/"; +target="_top">https://www.freshports.org/archivers/libcabinet/</a>.</p> <p>See the section on <a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the inclusion/exclusion of files works, and how to write patterns.</p> <p>This task forms an implicit <a href="../Types/fileset.html">FileSet</a> and supports most http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/changelog.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/changelog.html b/manual/Tasks/changelog.html index a685226..58c17b1 100644 --- a/manual/Tasks/changelog.html +++ b/manual/Tasks/changelog.html @@ -28,12 +28,12 @@ <h3>Description</h3> <p>Generates an XML-formatted report file of the change logs recorded in a <a href="https://www.nongnu.org/cvs/"; target="_top">CVS</a> repository.</p> -<p><strong>Important</strong>: This task needs <code>cvs</code> on the path. If it isn't, you will get -an error (such as error <code>2</code> on Windows). If <code><cvs></code> doesn't work, try to -execute <code>cvs.exe</code> from the command line in the target directory in which you are working. -Also note that this task assumes that the cvs executable is compatible with the Unix version, this -is not completely true for certain other CVS clients—like CVSNT for example—and some -operation may fail when using such an incompatible client.</p> +<p><strong>Important</strong>: This task needs <code>cvs</code> on the path. If it isn't, you will +get an error (such as <code>error=2</code> on Windows). If <code><cvs></code> doesn't work, +try to execute <code>cvs.exe</code> from the command line in the target directory in which you are +working. Also note that this task assumes that the cvs executable is compatible with the Unix +version, this is not completely true for certain other CVS clients—like CVSNT for +example—and some operation may fail when using such an incompatible client.</p> <h3>Parameters</h3> <table class="attr"> <tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/checksum.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/checksum.html b/manual/Tasks/checksum.html index 0970dea..627e634 100644 --- a/manual/Tasks/checksum.html +++ b/manual/Tasks/checksum.html @@ -31,19 +31,19 @@ <p>Note that many popular message digest functions—including MD5 and SHA-1—have been broken recently. If you are going to use the task to create checksums used in an environment where security is important, please take some time to investigate the algorithms offered by your JCE -provider. Note also that some JCE providers like the one -by <a href="https://www.bouncycastle.org/";>The Legion of the Bouncy Castle</a>, -the <a href="https://www.gnu.org/software/gnu-crypto/";>GNU project</a> -or <a href="https://jce.iaik.tugraz.at/sic/Products";>the Technical University Graz</a> offer more -digest algorithms than those built-in into your JDK.</p> +provider. Note also that some JCE providers like the one by <a href="https://www.bouncycastle.org/"; +target="_top">The Legion of the Bouncy Castle</a>, +the <a href="https://www.gnu.org/software/gnu-crypto/"; target="_top">GNU project</a> +or <a href="https://jce.iaik.tugraz.at/sic/Products"; target="_top">the Technical University Graz</a> +offer more digest algorithms than those built-in into your JDK.</p> <p>Warning: the case of the extension is that of the algorithm used. If you ask for <samp>SHA1</samp>, you get a <samp>.SHA1</samp> extension; if you ask for <samp>sha1</samp>, you get a file ending in <samp>.sha1</samp>. The Java Crypto Engines are case-insensitive in matching algorithms, so choose a name to match your desired output extension, or set the <var>fileext</var> -attribute. The names of common hashing algorithms can be located on the <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#MessageDigest";>Cryptography -Architecture Standard Algorithm Name Documentation</a></p> +attribute. The names of common hashing algorithms can be located on +the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#MessageDigest"; +target="_top">Cryptography Architecture Standard Algorithm Name Documentation</a></p> <h3>Parameters</h3> <table class="attr"> @@ -66,10 +66,10 @@ Architecture Standard Algorithm Name Documentation</a></p> </tr> <tr> <td>algorithm</td> - <td>Specifies the algorithm to be used to compute the checksum. Please check the - <a target="_blank" - href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#MessageDigest";>documentation</a> - for available algorithm names, like <q>SHA-1</q> or <q>SHA-512</q>. + <td>Specifies the algorithm to be used to compute the checksum. Please check + the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#MessageDigest"; + target="_top">documentation</a> for available algorithm names, like <q>SHA-1</q> + or <q>SHA-512</q>. </td> <td>No; defaults to <q>MD5</q></td> </tr> @@ -101,12 +101,12 @@ Architecture Standard Algorithm Name Documentation</a></p> <tr> <td>pattern</td> <td>Specifies the pattern to use as a pattern suitable - for <a href="https://docs.oracle.com/javase/8/docs/api/java/text/MessageFormat.html";>MessageFormat</a> - where <code>{0}</code> is replaced with the checksum and <code>{1}</code> with the file - name. <em>Since Ant 1.7.0</em><br/><em>Since Ant 1.8.2</em> <code>{2}</code> is replaced by the - path of the file relative to the checksum file being written, <code>{3}</code> with tha path of - the file relative to the project's <var>basedir</var> and <code>{4}</code> with the absolute - path of the file.</td> + for <a href="https://docs.oracle.com/javase/8/docs/api/java/text/MessageFormat.html"; + target="_top">MessageFormat</a> where <code>{0}</code> is replaced with the checksum + and <code>{1}</code> with the file name. <em>Since Ant 1.7.0</em><br/><em>Since Ant + 1.8.2</em> <code>{2}</code> is replaced by the path of the file relative to the checksum file + being written, <code>{3}</code> with the path of the file relative to the + project's <var>basedir</var> and <code>{4}</code> with the absolute path of the file.</td> <td>No; default is <q>{0}</q></td> </tr> <tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/concat.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/concat.html b/manual/Tasks/concat.html index a7e6aaf..cccacc6 100644 --- a/manual/Tasks/concat.html +++ b/manual/Tasks/concat.html @@ -81,8 +81,8 @@ <tr> <td>encoding</td> <td>Specifies the encoding for the input files. Please - see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html";>Supported - Encodings</a> for a list of possible values.</td> + see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html"; + target="_top">Supported Encodings</a> for a list of possible values.</td> <td>No; defaults to default JVM character encoding</td> </tr> <tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/conditions.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/conditions.html b/manual/Tasks/conditions.html index 42d4873..0efbb69 100644 --- a/manual/Tasks/conditions.html +++ b/manual/Tasks/conditions.html @@ -28,7 +28,7 @@ <p>Conditions are nested elements of the <a href="condition.html"><code><condition></code></a> and <a href="waitfor.html"><code><waitfor></code></a> tasks. There are core conditions and custom conditions. Custom conditions are described -in <a href="../Types/custom-programming.html#customconditions"> Custom Conditions</a>. Core +in <a href="../Types/custom-programming.html#customconditions">Custom Conditions</a>. Core Conditions are described below.</p> <h3 id="coreconditions">Core Conditions</h3> @@ -440,8 +440,8 @@ include tasks, datatypes, scriptdefs, macrodefs and presetdefs.</p> <p>Evaluate a condition based on a script in any <a href="https://jakarta.apache.org/bsf"; target="_top">Apache BSF</a> -or <a href="https://jcp.org/aboutJava/communityprocess/maintenance/jsr223/223ChangeLog.html";>JSR -223</a> supported language.</p> +or <a href="https://jcp.org/aboutJava/communityprocess/maintenance/jsr223/223ChangeLog.html"; +target="_top">JSR 223</a> supported language.</p> <p>See the <a href="../Tasks/script.html">Script</a> task for an explanation of scripts and dependencies.</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/cvs.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/cvs.html b/manual/Tasks/cvs.html index 9d63ae3..3e18376 100644 --- a/manual/Tasks/cvs.html +++ b/manual/Tasks/cvs.html @@ -29,7 +29,7 @@ <p>Handles packages/modules retrieved from a <a href="https://www.nongnu.org/cvs/"; target="_top">CVS</a> repository.</p> <p><strong>Important:</strong> This task needs <code>cvs</code> binary on the path. If it isn't, you -will get an error (such as error <code>2</code> on Windows). If <code><cvs></code> doesn't +will get an error (such as <code>error=2</code> on Windows). If <code><cvs></code> doesn't work, try to execute <code>cvs.exe</code> from the command line in the target directory in which you are working. Also note that this task assumes that the cvs executable is compatible with the Unix version, this is not completely true for certain other CVS clients—like CVSNT for @@ -38,8 +38,8 @@ example—and some operation may fail when using such an incompatible client <p><strong>CVSNT Note</strong>: CVSNT prefers users to store the passwords inside the registry. If the <a href="cvspass.html">cvspass task</a> and the <var>passfile</var> attribute don't seem to work for you, the most likely reason is that CVSNT ignores your <samp>.cvspass</samp> file completely. -See <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=21657#c5";>bugzilla report 21657</a> -for recommended workarounds.</p> +See <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=21657#c5"; target="_top">bugzilla +report 21657</a> for recommended workarounds.</p> <h3>Parameters</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/cvspass.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/cvspass.html b/manual/Tasks/cvspass.html index 89816c5..64ed090 100644 --- a/manual/Tasks/cvspass.html +++ b/manual/Tasks/cvspass.html @@ -32,8 +32,8 @@ a <code>cvs login</code> command.</p> <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 most likely reason is that CVSNT ignores your <samp>.cvspass</samp> file -completely. See <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=21657#c5";>bugzilla -report 21657</a> for recommended workarounds.</p> +completely. See <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=21657#c5"; +target="_top">bugzilla report 21657</a> for recommended workarounds.</p> <h3>Parameters</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/cvstagdiff.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/cvstagdiff.html b/manual/Tasks/cvstagdiff.html index 3605c49..7b4c358 100644 --- a/manual/Tasks/cvstagdiff.html +++ b/manual/Tasks/cvstagdiff.html @@ -26,7 +26,7 @@ <p>Generates an XML-formatted report file of the changes between two tags or dates recorded in a <a href="https://www.nongnu.org/cvs/"; target="_top">CVS</a> repository.</p> <p><strong>Important</strong>: This task needs <code>cvs</code> on the path. If it isn't, you will -get an error (such as error <code>2</code> on Windows). If <code><cvs></code> doesn't work, +get an error (such as <code>error=2</code> on Windows). If <code><cvs></code> doesn't work, try to execute <code>cvs.exe</code> from the command line in the target directory in which you are working. Also note that this task assumes that the cvs executable is compatible with the Unix version, this is not completely true for certain other CVS clients—like CVSNT for http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/defaultexcludes.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/defaultexcludes.html b/manual/Tasks/defaultexcludes.html index 5afac39..b26ed19 100644 --- a/manual/Tasks/defaultexcludes.html +++ b/manual/Tasks/defaultexcludes.html @@ -84,12 +84,12 @@ normal behavior</p> <h3>Notes</h3> <p>By default the pattern <samp>**/.svn</samp> and <samp>**/.svn/**</samp> are set as default -excludes. Since version 1.3, Subversion supports the <a target="_blank" -href="https://subversion.apache.org/docs/release-notes/1.3.html#_svn-hack";>"_svn -hack"</a>. That means, that the svn-libraries evaluate environment variables and -use <samp>.svn</samp> or <samp>_svn</samp> directory regarding to that value. We had chosen not to -evaluate environment variables to get a more reliable build. Instead you have to change the settings -by yourself by changing the exclude patterns:</p> +excludes. Since version 1.3, Subversion supports +the <a href="https://subversion.apache.org/docs/release-notes/1.3.html#_svn-hack"; +target="_top">"_svn hack"</a>. That means, that the svn-libraries evaluate environment +variables and use <samp>.svn</samp> or <samp>_svn</samp> directory regarding to that value. We had +chosen not to evaluate environment variables to get a more reliable build. Instead you have to +change the settings by yourself by changing the exclude patterns:</p> <pre> <defaultexcludes remove="**/.svn"/> <defaultexcludes remove="**/.svn/**"/> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/delete.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/delete.html b/manual/Tasks/delete.html index 783625c..81d1460 100644 --- a/manual/Tasks/delete.html +++ b/manual/Tasks/delete.html @@ -124,7 +124,7 @@ nested <code><fileset></code>.</p> <tr> <td>defaultexcludes</td> <td><em><u>Deprecated</u></em>. Use resource collections. Whether to - use <a href="../dirtasks.html#defaultexcludes"> default excludes.</a></td> + use <a href="../dirtasks.html#defaultexcludes">default excludes.</a></td> <td>No; default <q>true</q></td> </tr> <tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/depend.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/depend.html b/manual/Tasks/depend.html index 1d5b58c..a000010 100644 --- a/manual/Tasks/depend.html +++ b/manual/Tasks/depend.html @@ -40,7 +40,8 @@ class references encoded into the class files by the compiler. This is generally the Java source files.</p> <p>To learn more about how this information is obtained from the class files, please refer -to <a href="https://docs.oracle.com/javase/specs/";>the Java Virtual Machine Specification</a></p> +to <a href="https://docs.oracle.com/javase/specs/"; target="_top">the Java Virtual Machine +Specification</a></p> <p>Since a class' dependencies only change when the class itself changes, the <code>depend</code> task is able to cache dependency information. Only those class files which have http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/ear.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/ear.html b/manual/Tasks/ear.html index 6796982..60c1a69 100644 --- a/manual/Tasks/ear.html +++ b/manual/Tasks/ear.html @@ -122,10 +122,10 @@ attribute to a value other than its default, <q>add</q>.</strong></p> <tr> <td>filesetmanifest</td> <td>behavior when a manifest file is found in a <code>zipfileset</code> - or <code>zipgroupfileset</code> file. Valid values are <q>skip</q>, <q>merge</q>, - and <q>mergewithoutmain</q>. <q>merge</q> will merge all of the manifests together, and merge - this into any other specified manifests. <q>mergewithoutmain</q> merges everything but the Main - section of the manifests.</td> + or <code>zipgroupfileset</code> file. Valid values are <q>skip</q>, <q>merge</q>, + and <q>mergewithoutmain</q>. <q>merge</q> will merge all of the manifests together, and merge + this into any other specified manifests. <q>mergewithoutmain</q> merges everything but the + Main section of the manifests.</td> <td>No; defaults to <q>skip</q></td> </tr> <tr> @@ -142,10 +142,11 @@ attribute to a value other than its default, <q>add</q>.</strong></p> <tr> <td>index</td> <td>whether to create - an <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JAR_Index";>index - list</a> to speed up classloading. This is a JDK 1.3+ specific feature. Unless you specify - additional jars with nested <a href="jar.html#indexjars"><code>indexjars</code></a> elements, - only the contents of this jar will be included in the index.</td> + an <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JAR_Index"; + target="_top">index list</a> to speed up classloading. This is a JDK 1.3+ specific feature. + Unless you specify additional jars with + nested <a href="jar.html#indexjars"><code>indexjars</code></a> elements, only the contents of + this jar will be included in the index.</td> <td>No; defaults to <q>false</q></td> </tr> <tr> @@ -153,9 +154,10 @@ attribute to a value other than its default, <q>add</q>.</strong></p> <td>whether to include <samp>META-INF</samp> and its children in the index. Doesn't have any effect if <var>index</var> is false.<br/>Oracle's jar implementation used to skip the <samp>META-INF</samp> directory and Ant followed that example. The behavior has been - changed with <a href="https://bugs.openjdk.java.net/browse/JDK-4408526";>Java 5</a>. In order - to avoid problems with Ant generated jars on Java 1.4 or earlier, Ant will not - include <samp>META-INF</samp> unless explicitly asked to.<br/><em>Since Ant 1.8.0</em>.</td> + changed with <a href="https://bugs.openjdk.java.net/browse/JDK-4408526"; target="_top">Java + 5</a>. In order to avoid problems with Ant generated jars on Java 1.4 or earlier, Ant will + not include <samp>META-INF</samp> unless explicitly asked to.<br/><em>Since Ant + 1.8.0</em>.</td> <td>No; defaults to <q>false</q></td> </tr> <tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/echo.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/echo.html b/manual/Tasks/echo.html index 5a0c383..3294854 100644 --- a/manual/Tasks/echo.html +++ b/manual/Tasks/echo.html @@ -59,7 +59,7 @@ file is available, and the <var>level</var> option is ignored</p> <td>append</td> <td>Append to an existing file (or <a href="https://docs.oracle.com/javase/8/docs/api//java/io/FileWriter.html#FileWriter-java.lang.String-boolean-"; - target="_blank"> open a new file / overwrite an existing file</a>)? + target="_top"> open a new file / overwrite an existing file</a>)? </td> <td>No; ignored unless <var>output</var> indicates a filesystem destination, default is <q>false</q></td> @@ -96,8 +96,8 @@ three lines; the first line is a blank </echo></pre> <p>The newline immediately following the <code><echo></code> tag will be part of the output. Newlines in character data within the content of an element are not discarded by XML -parsers.<br/>See <a href="https://www.w3.org/TR/xml/#sec-line-ends";>W3C Recommendation 26 November -2008 / End of Line handling</a> for more details.</p> +parsers.<br/>See <a href="https://www.w3.org/TR/xml/#sec-line-ends"; target="_top">W3C Recommendation +26 November 2008 / End of Line handling</a> for more details.</p> <pre><echo message="Deleting drive C:" level="debug"/></pre> <p>A message which only appears in <code>-debug</code> mode.</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/ejb.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/ejb.html b/manual/Tasks/ejb.html index 303cb01..e45f08e 100644 --- a/manual/Tasks/ejb.html +++ b/manual/Tasks/ejb.html @@ -56,13 +56,15 @@ Server.</p> <p>The tasks support:</p> <ul> - <li><a href="http://www.borland.com";>Borland</a>Application Server 4.5</li> - <li><a href="https://web.archive.org/web/20020202082841/http://www.iplanet.com:80/products/iplanet_application/home_ias.html";>iPlanet</a>Application Server 6.0</li> + <li><a href="http://www.borland.com"; target="_top">Borland</a>Application Server 4.5</li> + <li><a href="https://web.archive.org/web/20020202082841/http://www.iplanet.com:80/products/iplanet_application/home_ias.html"; + target="_top">iPlanet</a> Application Server 6.0</li> <li><a href="https://www.jboss.org/"; target="_top">JBoss 2.1</a> and above EJB servers</li> - <li><a href="https://web.archive.org/web/20080516210506/http://www.ironflare.com/";>Orion Application Server</a> 2.0 (<em>since Ant 1.10.2</em>)</li> + <li><a href="https://web.archive.org/web/20080516210506/http://www.ironflare.com/"; + target="_top">Orion Application Server</a> 2.0 (<em>since Ant 1.10.2</em>)</li> <li><a href="http://www.bea.com"; target="_top">WebLogic</a> 4.5.1 through to 7.0 EJB servers</li> <li><a href="https://jonas.ow2.org/"; target="_top">JOnAS</a> 2.4.x and 2.5 Open Source EJB server</li> - <li><a href="https://www.ibm.com/websphere";>IBM WebSphere</a> 4.0</li> + <li><a href="https://www.ibm.com/websphere"; target="_top">IBM WebSphere</a> 4.0</li> </ul> <p>Vendors such as BEA and IBM now provide custom Ant tasks to work with their particular products. More importantly, EJB 3.0 renders this whole process obsolete. Accordingly, development @@ -74,16 +76,20 @@ applications and definitely not new EJB 2.x servers.</p> <h2 id="ejbtasks">EJB Tasks</h2> <table> <tr><th>Task</th><th colspan="2">Application Servers</th></tr> - <tr><td><a href="BorlandGenerateClient.html">blgenclient</a></td><td colspan="2">Borland Application Server 4.5 and 5.x</td></tr> - <tr><td><a href="#iplanet-ejbc">iplanet-ejbc</a></td><td colspan="2">iPlanet Application Server 6.0</td></tr> + <tr><td><a href="BorlandGenerateClient.html">blgenclient</a></td><td colspan="2">Borland + Application Server 4.5 and 5.x</td></tr> + <tr><td><a href="#iplanet-ejbc">iplanet-ejbc</a></td><td colspan="2">iPlanet Application Server + 6.0</td></tr> <tr><td rowspan="8"><a href="#ejbjar">ejbjar</a></td><th colspan="2">Nested Elements</th></tr> - <tr><td><a href="BorlandEJBTasks.html">borland</a></td><td>Borland Application Server 4.5 and 5.x</td></tr> + <tr><td><a href="BorlandEJBTasks.html">borland</a></td><td>Borland Application Server 4.5 and + 5.x</td></tr> <tr><td><a href="#ejbjar_iplanet">iPlanet</a></td><td>iPlanet Application Server 6.0</td></tr> <tr><td><a href="#ejbjar_jboss">jboss</a></td><td>JBoss</td></tr> <tr><td><a href="#ejbjar_jonas">jonas</a></td><td>JOnAS 2.4.x and 2.5</td></tr> <tr><td><a href="#ejbjar_weblogic">weblogic</a></td><td>WebLogic 5.1 to 7.0</td></tr> <tr><td><a href="#ejbjar_websphere">websphere</a></td><td>IBM WebSphere 4.0</td></tr> - <tr><td><a href="#ejbjar_orion">orion</a></td><td>IronFlare (Oracle) Orion Application Server 2.0.6</td></tr> + <tr><td><a href="#ejbjar_orion">orion</a></td><td>IronFlare (Oracle) Orion Application Server + 2.0.6</td></tr> </table> <hr/> @@ -504,7 +510,8 @@ specific deployment tools. These currently include:</p> <li>WebLogic 5.1/6.0 session/entity beans using the <code>weblogic.ejbc</code> tool</li> <li>IBM WebSphere 4.0</li> <li>TOPLink for WebLogic 2.5.1-enabled entity beans</li> - <li><a href="https://jonas.ow2.org/";>JOnAS</a> 2.4.x and 2.5 Open Source EJB server</li> + <li><a href="https://jonas.ow2.org/"; target="_top">JOnAS</a> 2.4.x and 2.5 Open Source EJB + server</li> <li>IronFlare Orion Application Server 2.0</li> </ul> @@ -528,11 +535,10 @@ its target jar file and determine if it is out of date with respect to the class deployment descriptors that make up the bean. If any of these files are newer than the jar file the jar will be rebuilt otherwise a message is logged that the jar file is up to date.</p> -<p>The task uses -the <a href="https://commons.apache.org/bcel/";>BCEL</a> <a href="../install.html#librarydependencies">library</a> -to extract all dependent classes. This means that, in addition to the classes that are mentioned in -the deployment descriptor, any classes that these depend on are also automatically included in the -jar file.</p> +<p>The task uses the <a href="https://commons.apache.org/bcel/"; +target="_top">BCEL</a> <a href="../install.html#librarydependencies">library</a> to extract all +dependent classes. This means that, in addition to the classes that are mentioned in the deployment +descriptor, any classes that these depend on are also automatically included in the jar file.</p> <h3 id="naming">Naming convention</h3> @@ -596,10 +602,10 @@ classes or as parameters to the bean's methods.</p> super classes and super interfaces of the bean classes. For this technique to work the bean classes had to be loaded into Ant's JVM. This was not always possible due to class dependencies.</p> -<p><em>Since Ant 1.5</em> the task uses the <a href="https://commons.apache.org/bcel/";>BCEL</a> -library to analyze the bean's class files directly, rather than loading them into the JVM. This also -allows <code>ejbjar</code> to add all of the required support classes for a bean and not just super -classes.</p> +<p><em>Since Ant 1.5</em> the task uses the <a href="https://commons.apache.org/bcel/"; +target="_top">BCEL</a> library to analyze the bean's class files directly, rather than loading them +into the JVM. This also allows <code>ejbjar</code> to add all of the required support classes for a +bean and not just super classes.</p> <p><em>Since Ant 1.5</em>, a <var>dependency</var> attribute allows the buildfile to control what additional classes are added to the generated jar. It takes three possible values</p> @@ -611,9 +617,9 @@ additional classes are added to the generated jar. It takes three possible value <li><q>full</q>—In this mode all classes used by the bean's classes and interfaces are added to the jar</li> </ul> -<p>The <q>super</q> and <q>full</q> values require -the <a href="https://commons.apache.org/bcel/";>BCEL</a> library to be available. If it is -not, <code>ejbjar</code> will drop back to the behaviour corresponding to the value <q>none</q>.</p> +<p>The <q>super</q> and <q>full</q> values require the <a href="https://commons.apache.org/bcel/"; +target="_top">BCEL</a> library to be available. If it is not, <code>ejbjar</code> will drop back to +the behaviour corresponding to the value <q>none</q>.</p> <h3>Parameters</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/exec.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/exec.html b/manual/Tasks/exec.html index 1dde415..edc8725 100644 --- a/manual/Tasks/exec.html +++ b/manual/Tasks/exec.html @@ -46,11 +46,11 @@ should be more reliable, as would be something like</p> <h4>Windows Users</h4> <p>The <code><exec></code> task delegates to <code>Runtime.exec</code> which in turn apparently -calls <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms682425(v=vs.85).aspx"> <code>::CreateProcess</code></a>. It -is the latter Win32 function that defines the exact semantics of the call. In particular, if you do -not put a file extension on the executable, only <samp>.EXE</samp> files are looked for, -not <samp>.COM</samp>, <samp>.CMD</samp> or other file types listed in the environment -variable <code>PATHEXT</code>. That is only used by the shell.</p> +calls <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms682425(v=vs.85).aspx" +target="_top"><code>::CreateProcess</code></a>. It is the latter Win32 function that defines the +exact semantics of the call. In particular, if you do not put a file extension on the executable, +only <samp>.EXE</samp> files are looked for, not <samp>.COM</samp>, <samp>.CMD</samp> or other file +types listed in the environment variable <code>PATHEXT</code>. That is only used by the shell.</p> <p>Note that <samp>.bat</samp> files cannot in general by executed directly. One normally needs to execute the command shell executable <code>cmd</code> using the <code>/c</code> switch.</p> <pre> @@ -75,8 +75,8 @@ the <var>executable</var> attribute in your buildfile.</p> executable parameter. This is because JVM in which Ant is running is a standard Windows executable and is not aware of the Cygwin environment (i.e., doesn't load <samp>cygwin1.dll</samp>). The only work-around for this is to compile a JVM under Cygwin (at your own risk). See for -instance <a href="https://cdn.rawgit.com/AdoptOpenJDK/openjdk-jdk9/dev/common/doc/building.html#cygwin";>OpenJDK -build instructions for cygwin</a>.</p> +instance <a href="https://cdn.rawgit.com/AdoptOpenJDK/openjdk-jdk9/dev/common/doc/building.html#cygwin"; +target="_top">OpenJDK build instructions for cygwin</a>.</p> <h4>OpenVMS Users</h4> <p>The command specified using <code>executable</code> and <code><arg></code> elements is @@ -98,9 +98,9 @@ the <var>fork</var> attribute set to <q>true</q> instead as this task will follo interpretation of exit codes.</p> <h4>RedHat S/390 Users</h4> -<p>It has been <a href="https://www.mail-archive.com/linux-390@vm.marist.edu/msg22223.html";>reported -on linux-390</a> that shell scripts invoked via the Ant Exec task must have their interpreter -specified, i.e., the scripts must start with something like:</p> +<p>It has been <a href="https://www.mail-archive.com/linux-390@vm.marist.edu/msg22223.html"; +target="_top">reported on linux-390</a> that shell scripts invoked via the Ant Exec task must have +their interpreter specified, i.e., the scripts must start with something like:</p> <pre>#!/bin/bash</pre> <p>or the task will fail as follows:</p> @@ -323,10 +323,10 @@ property and have it assigned to the result code (barring immutability, of cours then <code><exec></code> halts the build unless <var>failifexecutionfails</var> is set to <q>false</q>. You can use that to run a program if it exists, but otherwise do nothing.</p> <p>What do those error codes mean? Well, they are OS dependent. On Windows boxes you have to look -at <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms681382(v=vs.85).aspx"> the -documentation</a>; <code>error=2</code> means 'no such program', which usually means it is not on -the path. Any time you see such an error from any Ant task, it is usually not an Ant bug, but some -configuration problem on your machine.</p> +at <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms681382(v=vs.85).aspx" +target="_top">the documentation</a>; <code>error=2</code> means 'no such program', which usually +means it is not on the path. Any time you see such an error from any Ant task, it is usually not an +Ant bug, but some configuration problem on your machine.</p> <h3>Examples</h3> <pre> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/ftp.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/ftp.html b/manual/Tasks/ftp.html index 0ded19d..d47bb57 100644 --- a/manual/Tasks/ftp.html +++ b/manual/Tasks/ftp.html @@ -223,8 +223,8 @@ connection.</p> <tr> <td colspan="3" class="left"> <p><strong>The following attributes - require <a href="https://commons.apache.org/net/download_net.cgi";>jakarta-commons-net-1.4.0 or - greater</a>.</strong></p> + require <a href="https://commons.apache.org/net/download_net.cgi"; + target="_top">jakarta-commons-net-1.4.0 or greater</a>.</strong></p> <p>Use these options when the standard options don't work, because</p> <ul> <li>the server is in a different timezone and you need timestamp dependency checking</li> @@ -259,44 +259,45 @@ connection.</p> <tr> <td>serverTimeZoneConfig</td> <td>Specify as a - Java <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html";>TimeZone</a> - identifier, (e.g. <q>GMT</q>, <q>America/Chicago</q> or <q>Asia/Jakarta</q>) the timezone used - by the server for timestamps. This enables timestamp dependency checking even when the server - is in a different time zone from the client. Time Zones know, also, about daylight savings - time, and do not require you to calculate milliseconds of difference. If not specified, (or - specified as <q></q>), the time zone of the client is assumed.<br/><em>Since Ant 1.7</em></td> + Java <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html"; + target="_top">TimeZone</a> identifier, (e.g. <q>GMT</q>, <q>America/Chicago</q> + or <q>Asia/Jakarta</q>) the timezone used by the server for timestamps. This enables + timestamp dependency checking even when the server is in a different time zone from the + client. Time Zones know, also, about daylight savings time, and do not require you to + calculate milliseconds of difference. If not specified, (or specified as <q></q>), the time + zone of the client is assumed.<br/><em>Since Ant 1.7</em></td> <td>No</td> </tr> <tr> <td>defaultDateFormatConfig</td> <td>Specify in - Java <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html";>SimpleDateFormat</a> - notation, (e.g. <q>yyyy-MM-dd</q>), the date format generally used by the FTP server to parse - dates. In some cases this will be the only date format used. In others, (<q>unix</q> for - example) this will be used for dates older than a year - old. (See <var>recentDateFormatConfig</var>). When specified as <q></q>, default value will - be used.<br/><em>Since Ant 1.7</em></td> + Java <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html"; + target="_top">SimpleDateFormat</a> notation, (e.g. <q>yyyy-MM-dd</q>), the date format + generally used by the FTP server to parse dates. In some cases this will be the only date + format used. In others, (<q>unix</q> for example) this will be used for dates older than a + year old. (See <var>recentDateFormatConfig</var>). When specified as <q></q>, default value + will be used.<br/><em>Since Ant 1.7</em></td> <td>No; defaults to default date format for the system type indicated by <var>systemTypeKey</var></td> </tr> <tr> <td>recentDateFormatConfig</td> <td>Specify in - Java <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html";>SimpleDateFormat</a> - notation, (e.g. <q>MMM dd hh:mm</q>) the date format used by the FTP server to parse dates - less than a year old. If not specified (or specified as <q></q>), and if the system type - indicated by the <var>systemTypeKey</var> uses a recent date format, its standard format will - be used.<br/><em>Since Ant 1.7</em></td> + Java <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html"; + target="_top">SimpleDateFormat</a> notation, (e.g. <q>MMM dd hh:mm</q>) the date format used + by the FTP server to parse dates less than a year old. If not specified (or specified + as <q></q>), and if the system type indicated by the <var>systemTypeKey</var> uses a recent + date format, its standard format will be used.<br/><em>Since Ant 1.7</em></td> <td>No</td> </tr> <tr> <td>serverLanguageCodeConfig</td> - <td>a <a href="http://www.mathguide.de/info/tools/languagecode.html";>two-letter ISO-639 language - code</a> used to specify the language used by the server to format month names. This only - needs to be specified when the server uses non-numeric abbreviations for months in its date - listings in a language other than English. This appears to be becoming rarer and rarer, as - commonly distributed FTP servers seem increasingly to use English or all-numeric formats. - Languages supported are: + <td>a <a href="http://www.mathguide.de/info/tools/languagecode.html"; target="_top">two-letter + ISO-639 language code</a> used to specify the language used by the server to format month + names. This only needs to be specified when the server uses non-numeric abbreviations for + months in its date listings in a language other than English. This appears to be becoming + rarer and rarer, as commonly distributed FTP servers seem increasingly to use English or + all-numeric formats. Languages supported are: <ul> <li><q>en</q>—English</li> <li><q>fr</q>—French</li> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/import.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/import.html b/manual/Tasks/import.html index c01b1bd..ebdd394 100644 --- a/manual/Tasks/import.html +++ b/manual/Tasks/import.html @@ -34,9 +34,9 @@ Ant to use a ProjectHelper other than Ant's default, this task may or may not work.</p> <p>In the common use case where only Ant's default project helper is used, it basically works like - the <a href="https://ant.apache.org/faq.html#xml-entity-include";>Entity Includes as explained in - the Ant FAQ</a>, as if the imported file was contained in the importing file, minus the - top <code><project></code> tag.</p> + the <a href="https://ant.apache.org/faq.html#xml-entity-include"; target="_top">Entity Includes + as explained in the Ant FAQ</a>, as if the imported file was contained in the importing file, + minus the top <code><project></code> tag.</p> <p>The <code>import</code> task may only be used as a top-level task. This means that it may not be used in a target.</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/include.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/include.html b/manual/Tasks/include.html index 100ce18..620e71e 100644 --- a/manual/Tasks/include.html +++ b/manual/Tasks/include.html @@ -32,8 +32,8 @@ <p>On execution it will read another Ant file into the same project rewriting the included target <var>name</var>s and <var>depends</var> lists. This is different - from <a href="https://ant.apache.org/faq.html#xml-entity-include";>Entity Includes as explained - in the Ant FAQ</a> insofar as the target names get prefixed by the included + from <a href="https://ant.apache.org/faq.html#xml-entity-include"; target="_top">Entity Includes + as explained in the Ant FAQ</a> insofar as the target names get prefixed by the included project's <var>name</var> or <var>as</var> attribute and do not appear as if the file was contained in the including file.</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jar.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jar.html b/manual/Tasks/jar.html index 1664bbc..4df78e4 100644 --- a/manual/Tasks/jar.html +++ b/manual/Tasks/jar.html @@ -71,15 +71,14 @@ a <code>zipfileset</code> in a <code>Zip</code> task. The one difference is that the <var>manifest</var> attribute is not specified, the <code>Jar</code> task will include an empty one for you.)</p> -<p>Manifests are processed by the <code>Jar</code> task according to the <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html";>Jar file -specification.</a> Note in particular that this may result in manifest lines greater than 72 bytes -being wrapped and continued on the next line.</p> +<p>Manifests are processed by the <code>Jar</code> task according to +the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html"; target="_top">Jar +file specification.</a> Note in particular that this may result in manifest lines greater than 72 +bytes being wrapped and continued on the next line.</p> <p>The <code>Jar</code> task checks whether you specified package information according to -the <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/versioning/spec/versioning2.html#wp90779";> -versioning specification</a>.</p> +the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/versioning/spec/versioning2.html#wp90779"; +target="_top">versioning specification</a>.</p> <p><strong>Please note that the ZIP format allows multiple files of the same fully-qualified name to exist within a single archive. This has been documented as causing various problems for unsuspecting @@ -89,7 +88,7 @@ other than its default, <q>add</q>.</strong></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 +<p>For creating a simple version of a <a href="http://openjdk.java.net/jeps/238"; target="_top">JEP 238 multi-release jar</a>, you don't need any special tools. Just set the required <code>manifest</code> entry and place the files where required, as you could see in the <a href="#jep238-example">JEP 238 example</a>. If you want to tune this kind of jar, @@ -202,10 +201,10 @@ e.g. decreasing the size by deleting 'same' classes from the versions-branches, <tr> <td>index</td> <td>whether to create - an <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JAR_Index";>index - list</a> to speed up classloading. This is a JDK 1.3+ specific feature. Unless you specify - additional jars with nested <a href="#indexjars"><code>indexjars</code></a> elements, only the - contents of this jar will be included in the index.</td> + an <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JAR_Index"; + target="_top">index list</a> to speed up classloading. This is a JDK 1.3+ specific feature. + Unless you specify additional jars with nested <a href="#indexjars"><code>indexjars</code></a> + elements, only the contents of this jar will be included in the index.</td> <td>No; defaults to <q>false</q></td> </tr> <tr> @@ -213,8 +212,8 @@ e.g. decreasing the size by deleting 'same' classes from the versions-branches, <td>whether to include <samp>META-INF</samp> and its children in the index. Doesn't have any effect if <var>index</var> is <q>false</q>.<br/>Sun's jar implementation used to skip the <samp>META-INF</samp> directory and Ant followed that example. The behavior has been - changed with <a href="https://bugs.openjdk.java.net/browse/JDK-4408526";>Java 5</a>. In order - to avoid problems with Ant generated jars on Java 1.4 or earlier Ant will not + changed with <a href="https://bugs.openjdk.java.net/browse/JDK-4408526"; target="_top">Java + 5</a>. In order to avoid problems with Ant generated jars on Java 1.4 or earlier Ant will not include <samp>META-INF</samp> unless explicitly asked to. <em>Since Ant 1.8.0</em></td> <td>No; defaults to <q>false</q></td> </tr> @@ -355,10 +354,11 @@ to <q>true</q>.</p> <p><em>Since Ant 1.7.0</em></p> <p>The nested <code>service</code> element specifies a service. Services are described in -the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#Service_Provider";>service -provider overview</a>. The approach is to have providers JARs include files named by the service -provided, for example, <samp>META-INF/services/javax.script.ScriptEngineFactory</samp> which can -include implementation class names, one per line (usually just one per JAR).</p> +the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#Service_Provider"; +target="_top">service provider overview</a>. The approach is to have providers JARs include files +named by the service provided, for +example, <samp>META-INF/services/javax.script.ScriptEngineFactory</samp> which can include +implementation class names, one per line (usually just one per JAR).</p> <p>The name of the service is set by the <var>type</var> attribute. The classname implementing the service is the the <var>provider</var> attribute, or if one wants to specify a number of classes @@ -464,7 +464,7 @@ embeds all the classes from all the jars in <samp>lib/main</samp>.</p> <include name="build"/> <manifest> <!-- If this is an Applet or Web Start application, include - the proper attributes from <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jweb/index.html";>https://docs.oracle.com/javase/8/docs/technotes/guides/jweb/index.html</a> --> + the proper attributes from <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jweb/index.html"; target="_top">https://docs.oracle.com/javase/8/docs/technotes/guides/jweb/index.html</a> --> <attribute name="Permissions" value="sandbox"/> <attribute name="Codebase" value="example.com"/> <!-- Who is building this jar? --> @@ -521,7 +521,7 @@ JDK 6 scripting interface:</p> <h4 id="jep238-example">JEP 238 example: a Multi-Release JAR Files</h4> <p>Here we want to create a <em>Multi-Release JAR File</em> according the -specification <a target="_blank" href="http://openjdk.java.net/jeps/238";>JEP 238</a>. It defines on +specification <a href="http://openjdk.java.net/jeps/238"; target="_top">JEP 238</a>. 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/> Basically it says, that you have to set the manifest entry <code>Multi-Release: true</code> and place all additional or overwriting classes http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jarlib-available.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jarlib-available.html b/manual/Tasks/jarlib-available.html index 5efd196..9122c99 100644 --- a/manual/Tasks/jarlib-available.html +++ b/manual/Tasks/jarlib-available.html @@ -31,10 +31,10 @@ If the extension is present then a property is set.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <em>Optional Package Versioning</em> -in the documentation bundle for your Java Standard Edition package, in file -<samp>guide/extensions/versioning.html</samp> or the online <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html";> Extension -and ExtensionSet documentation</a> for further details.</p> +in the documentation bundle for your Java Standard Edition package, in +file <samp>guide/extensions/versioning.html</samp> or the +online <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html"; +target="_top">Extension and ExtensionSet documentation</a> for further details.</p> <h3>Parameters</h3> <table class="attr"> @@ -121,3 +121,4 @@ extension in.</p> </body> </html> + http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jarlib-display.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jarlib-display.html b/manual/Tasks/jarlib-display.html index 2da3ba5..c5ee3a4 100644 --- a/manual/Tasks/jarlib-display.html +++ b/manual/Tasks/jarlib-display.html @@ -31,10 +31,10 @@ specified jars.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <em>Optional Package Versioning</em> -in the documentation bundle for your Java Standard Edition package, in file -<samp>guide/extensions/versioning.html</samp> or the online <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html";> Extension -and ExtensionSet documentation</a> for further details.</p> +in the documentation bundle for your Java Standard Edition package, in +file <samp>guide/extensions/versioning.html</samp> or the +online <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html"; +target="_top">Extension and ExtensionSet documentation</a> for further details.</p> <h3>Parameters</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jarlib-manifest.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jarlib-manifest.html b/manual/Tasks/jarlib-manifest.html index 7811784..490d204 100644 --- a/manual/Tasks/jarlib-manifest.html +++ b/manual/Tasks/jarlib-manifest.html @@ -32,10 +32,10 @@ specifications in the manifests of the jars.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <em>Optional Package Versioning</em> -in the documentation bundle for your Java Standard Edition package, in file -<code>guide/extensions/versioning.html</code> or the online <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html";>Extension -and ExtensionSet documentation</a> for further details.</p> +in the documentation bundle for your Java Standard Edition package, in +file <code>guide/extensions/versioning.html</code> or the +online <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html"; +target="_top">Extension and ExtensionSet documentation</a> for further details.</p> <h3>Parameters</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jarlib-resolve.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jarlib-resolve.html b/manual/Tasks/jarlib-resolve.html index 6cf3e19..0c2cf65 100644 --- a/manual/Tasks/jarlib-resolve.html +++ b/manual/Tasks/jarlib-resolve.html @@ -34,10 +34,10 @@ thrown.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <em>Optional Package Versioning</em> -in the documentation bundle for your Java Standard Edition package, in file -<code>guide/extensions/versioning.html</code> or the online <a target="_blank" -href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html";> Extension -and ExtensionSet documentation</a> for further details.</p> +in the documentation bundle for your Java Standard Edition package, in +file <code>guide/extensions/versioning.html</code> or the +online <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/extensions/versioning.html"; +target="_top">Extension and ExtensionSet documentation</a> for further details.</p> <h3>Parameters</h3> <table class="attr"> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/java.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/java.html b/manual/Tasks/java.html index 46459c3..ac1829f 100644 --- a/manual/Tasks/java.html +++ b/manual/Tasks/java.html @@ -311,8 +311,8 @@ project, <em>not</em> the directory in which the Java task is run. If you need t relative to the directory the task will be run in, you need to explicitly create the full path to the JAR file.</p> <p>When using the <var>jar</var> attribute, all classpath settings are ignored according -to <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html";>Oracle's -specification</a>. +to <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html"; +target="_top">Oracle's specification</a>. <h3>Examples</h3> <pre> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/javac.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/javac.html b/manual/Tasks/javac.html index 7a87642..951937b 100644 --- a/manual/Tasks/javac.html +++ b/manual/Tasks/javac.html @@ -69,7 +69,7 @@ for either the <code>build.compiler</code> property or the <var>compiler</var> a (the <a href="https://web.archive.org/web/20050212025507/http://www.dms.at/kopi/index.html"; target="_top">kopi</a> compiler).</li> <li><q>gcj</q> (the <code>gcj</code> compiler - from <a href="https://gcc.gnu.org/gcc-7/changes.html#java";>GCC</a>).</li> + from <a href="https://gcc.gnu.org/gcc-7/changes.html#java"; target="_top">GCC</a>).</li> <li><q>sj</q> (Symantec Java compiler) – <q>symantec</q> can be used as an alias.</li> <li><q>extJavac</q> (run either modern or classic in a JVM of its own).</li> </ul> @@ -309,8 +309,9 @@ file will not get compiled even if a native header file generated for it would b magic <a href="../javacprops.html#target"><code>ant.build.javac.target</code></a> property is set<br/><strong>Note that the default value depends on JDK that is running Ant and on <var>source</var> - (see <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javac.html#BHCJDCID";>Cross-Compilation - Options</a>). We highly recommend to always specify this attribute.</strong></td> + (see <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javac.html#BHCJDCID"; + target="_top">Cross-Compilation Options</a>). We highly recommend to always specify this + attribute.</strong></td> </tr> <tr> <td>compiler</td> @@ -345,9 +346,10 @@ file will not get compiled even if a native header file generated for it would b compiler for doing unnecessary work. However, for some edge cases, involving generics, the <code>javac</code> compiler needs to compile the dependent classes to get the generics information. One example is documented in the bug - report: <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=40776";>Bug 40776 - a - problem compiling a Java 5 project with generics</a>. Setting the attribute to <q>false</q> - will cause the compiler to recompile dependent classes. <em>Since Ant 1.7.1</em>.</td> + report: <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=40776"; target="_top">Bug + 40776 - a problem compiling a Java 5 project with generics</a>. Setting the attribute + to <q>false</q> will cause the compiler to recompile dependent classes. <em>Since Ant + 1.7.1</em>.</td> <td>No; default is <q>true</q></td> </tr> <tr> @@ -578,8 +580,8 @@ certain packages below a common root, use the <var>include</var>/<var>exclude</v or <code><include></code>/<code><exclude></code> nested elements to filter for these packages. Do not include part of your package structure in the <var>srcdir</var> attribute (or nested <code><src></code> elements), or Ant will recompile your source files every time you -run your compile target. See the <a href="https://ant.apache.org/faq.html#always-recompiles";>Ant -FAQ</a> for additional information.</p> +run your compile target. See the <a href="https://ant.apache.org/faq.html#always-recompiles"; +target="_top">Ant FAQ</a> for additional information.</p> <p>If you wish to compile only files explicitly specified and disable <code>javac</code>'s default searching mechanism then you can unset the <var>sourcepath</var> attribute:</p> @@ -734,9 +736,9 @@ references to strings that can by used in an OS independent fashion </javac></pre> <h3>OpenJDK notes</h3> -<p>The <a href="http://openjdk.java.net/";>openjdk</a> project has provided -the <code>javac</code> <a href="http://openjdk.java.net/groups/compiler/";>compiler</a> as an open -source project. The output of this project is a <code>javac.jar</code> which contains +<p>The <a href="http://openjdk.java.net/"; target="_top">OpenJDK</a> project has provided +the <code>javac</code> <a href="http://openjdk.java.net/groups/compiler/"; target="_top">compiler</a> +as an open source project. The output of this project is a <code>javac.jar</code> which contains the <code>javac</code> compiler. This compiler may be used with the <code><javac></code> task with the use of a <code>-Xbootclasspath/p</code> Java argument. The argument needs to be given to the runtime system of the <code>javac</code> executable, so it needs to be prepended with http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/javadoc.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/javadoc.html b/manual/Tasks/javadoc.html index 3a2184d..829faec 100644 --- a/manual/Tasks/javadoc.html +++ b/manual/Tasks/javadoc.html @@ -57,7 +57,7 @@ attribute it is up to you to ensure that this command supports the attributes yo <p><strong>Note</strong>: When generating the JavaDocs for classes which contains annotations you maybe get a <code>java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl</code>. This is -due <a href="https://bugs.openjdk.java.net/browse/JDK-6442982"; target="_blank">bug-6442982</a>. The +due <a href="https://bugs.openjdk.java.net/browse/JDK-6442982"; target="_top">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 <code>@XmlType</code>, ...) to <code><javadoc></code> using <var>classpath</var>, <var>classpathref</var> attributes or @@ -493,8 +493,8 @@ with the <var>exclude</var> patterns of the <code>packageset</code> (and vice ve CVE-2013-1571. <em>Since Ant 1.9.2</em><br/> There is a frame injection attack possible in javadocs generated by Oracle JDKs prior to Java 7 update 25 (<a href="https://www.oracle.com/technetwork/java/javase/7u25-relnotes-1955741.html#jpi-upt"; - target="_blank">details</a>). When this flag is set to <q>true</q>, Ant will check whether - the docs are vulnerable and will try to fix them.</td> + target="_top">details</a>). When this flag is set to <q>true</q>, Ant will check whether the + docs are vulnerable and will try to fix them.</td> <td>1.4</td> <td>No; defaults to <q>true</q></td> </tr> @@ -678,12 +678,12 @@ task.</p> <h4>doclet</h4> <p>The doclet nested element is used to specify -the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/doclet/overview.html";>doclet</a> -that <code>javadoc</code> will use to process the input source files. A number of the -standard <code>javadoc</code> arguments are actually arguments of the standard doclet. If these are -specified in the <code>javadoc</code> task's attributes, they will be passed to the doclet specified -in the <code><doclet></code> nested element. Such attributes should only be specified, -therefore, if they can be interpreted by the doclet in use.</p> +the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/doclet/overview.html"; +target="_top">doclet</a> that <code>javadoc</code> will use to process the input source files. A +number of the standard <code>javadoc</code> arguments are actually arguments of the standard +doclet. If these are specified in the <code>javadoc</code> task's attributes, they will be passed to +the doclet specified in the <code><doclet></code> nested element. Such attributes should only +be specified, therefore, if they can be interpreted by the doclet in use.</p> <p>If the doclet requires additional parameters, these can be specified with <code><param></code> elements within the <code><doclet></code> element. These @@ -742,8 +742,8 @@ those tags.</p> <td>If this attribute is specified, this element will behave as an implicit <a href="../Types/fileset.html">fileset</a>. The files included by this fileset should contain each tag definition on a separate line, as described in - the <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#javadoctags";>Javadoc - reference guide</a>: + the <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#javadoctags"; + target="_top">Javadoc reference guide</a>: <pre>ejb.bean:t:XDoclet EJB Tag todo:a:To Do</pre> <strong>Note</strong>: The Javadoc reference quide has double quotes around the description @@ -757,9 +757,10 @@ todo:a:To Do</pre> <h4 id="tagletelement">taglet</h4> <p>The taglet nested element is used to specify -custom <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/taglet/overview.html";>taglets</a> +custom <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/taglet/overview.html"; +target="_top">taglets</a> beyond <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#javadoctags"; -target="_blank">the default taglets</a>.</p> +target="_top">the default taglets</a>.</p> <h5>Parameters</h5> <table class="attr"> @@ -771,7 +772,8 @@ target="_blank">the default taglets</a>.</p> <tr> <td>name</td> <td>The name of the taglet class - (e.g. <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/taglet/ToDoTaglet.java";><code>com.sun.tools.doclets.ToDoTaglet</code></a>)</td> + (e.g. <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/taglet/ToDoTaglet.java"; + target="_top"><code>com.sun.tools.doclets.ToDoTaglet</code></a>)</td> <td>Yes</td> </tr> <tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/javah.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/javah.html b/manual/Tasks/javah.html index cc0815f..ec767dd 100644 --- a/manual/Tasks/javah.html +++ b/manual/Tasks/javah.html @@ -29,10 +29,10 @@ <p>Generates JNI headers from a Java class.</p> <p>When this task executes, it will generate the C header and source files that are needed to implement native methods. JNI operates differently depending on -whether <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javah.html";>JDK -1.2+</a> -or <a href="https://web.archive.org/web/20021018232717/http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/javah.html";>pre-1.2 -JDK</a> systems are used.</p> +whether <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javah.html"; +target="_top">JDK 1.2+</a> +or <a href="https://web.archive.org/web/20021018232717/http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/javah.html"; +target="_top">pre-1.2 JDK</a> systems are used.</p> <p>If you are building with Java 8 or above consider using <a href="javac.html"><code>javac</code></a>'s <var>nativeheaderdir</var> attribute instead @@ -47,7 +47,8 @@ attribute:</p> <ul> <li><q>default</q>—the default compiler for the platform.</li> <li><q>sun</q>—the standard compiler of the JDK.</li> - <li><q>kaffeh</q>—the native standard compiler of <a href="http://www.kaffe.org"; target="_top">Kaffe</a>.</li> + <li><q>kaffeh</q>—the native standard compiler of <a href="http://www.kaffe.org"; + target="_top">Kaffe</a>.</li> <li><q>gcjh</q>—the native standard compiler of <a href="https://gcc.gnu.org/gcc-7/changes.html#java"; target="_top">gcj and gij</a>. <em>Since Apache Ant 1.8.2</em></li> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jdepend.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jdepend.html b/manual/Tasks/jdepend.html index 2263689..6273332 100644 --- a/manual/Tasks/jdepend.html +++ b/manual/Tasks/jdepend.html @@ -27,7 +27,8 @@ <h3>Description</h3> -<p>Invokes the <a href="http://www.clarkware.com/software/JDepend.html";>JDepend</a> parser.</p> +<p>Invokes the <a href="http://www.clarkware.com/software/JDepend.html"; target="_top">JDepend</a> +parser.</p> <p>This parser "traverses a set of Java source file directories and generates design quality metrics for each Java package". It allows to "automatically measure the quality of a http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jjdoc.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jjdoc.html b/manual/Tasks/jjdoc.html index c61e892..a202ea8 100644 --- a/manual/Tasks/jjdoc.html +++ b/manual/Tasks/jjdoc.html @@ -26,9 +26,9 @@ <p><em>Since Apache Ant 1.6</em></p> <h3>Description</h3> -<p>Invokes the <a href="https://javacc.org/";>JJDoc</a> preprocessor for the JavaCC compiler -compiler. It takes a JavaCC parser specification and produces documentation for the BNF grammar. It -can operate in three modes, determined by command line options. +<p>Invokes the <a href="https://javacc.org/"; target="_top">JJDoc</a> preprocessor for the JavaCC +compiler compiler. It takes a JavaCC parser specification and produces documentation for the BNF +grammar. It can operate in three modes, determined by command line options. <p>To use the <code>jjdoc</code> task, set the <var>target</var> attribute to the name of the JavaCC grammar file to process. You also need to specify the directory containing the JavaCC installation using the <var>javacchome</var> attribute, so that Ant can find the JavaCC classes. Optionally, you http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jjtree.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jjtree.html b/manual/Tasks/jjtree.html index 9e691de..5ef0f39 100644 --- a/manual/Tasks/jjtree.html +++ b/manual/Tasks/jjtree.html @@ -25,9 +25,9 @@ <h2 id="jjtree">JJTree</h2> <h3>Description</h3> -<p>Invokes the <a href="https://javacc.org/";>JJTree</a> preprocessor for the JavaCC compiler -compiler. It inserts parse tree building actions at various places in the JavaCC source that it -generates. The output of JJTree is run through JavaCC to create the parser.</p> +<p>Invokes the <a href="https://javacc.org/"; target="_top">JJTree</a> preprocessor for the JavaCC +compiler compiler. It inserts parse tree building actions at various places in the JavaCC source +that it generates. The output of JJTree is run through JavaCC to create the parser.</p> <p>To use the <code>jjtree</code> task, set the <var>target</var> attribute to the name of the JJTree grammar file to process. You also need to specify the directory containing the JavaCC installation using the <var>javacchome</var> attribute, so that Ant can find the JavaCC http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/jspc.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jspc.html b/manual/Tasks/jspc.html index 02acd3d..6b68a24 100644 --- a/manual/Tasks/jspc.html +++ b/manual/Tasks/jspc.html @@ -31,9 +31,10 @@ the task shipping with Tomcat instead.</em> This task is only tested against To known problems with Tomcat 5.x that won't get fixed in Ant, please use Tomcat's <code>jspc</code> task instead.<br/> Instead of relying on container-specific JSP compilers we suggest deploying the raw files (<samp>*.jsp</samp>) and use the container build-in functions: after deploying run a test -suite (e.g. with <a href="https://attic.apache.org/projects/jakarta-cactus.html";>Cactus</a> -or <a href="http://httpunit.sourceforge.net/";>HttpUnit</a>) against the deployed web application. So -you'll get the test result <em>and</em> the compiled JSPs.</p> +suite (e.g. with <a href="https://attic.apache.org/projects/jakarta-cactus.html"; +target="_top">Cactus</a> or <a href="http://httpunit.sourceforge.net/"; target="_top">HttpUnit</a>) +against the deployed web application. So you'll get the test result <em>and</em> the compiled +JSPs.</p> <h3>Description</h3> <p>Apache Ant task to run the JSP compiler and turn JSP pages into Java source files.</p> @@ -47,8 +48,8 @@ dependencies, or <code><jsp:include></code> references.</p> <p>By default the task uses the Jasper JSP compiler. This means the task needs <samp>jasper.jar</samp> and <samp>jasper-runtime.jar</samp>, which come with builds of Tomcat -4/Catalina from the <a href="https://tomcat.apache.org/";>Apache Tomcat project</a>, and any other -jar files which may be needed in future versions (it changes).</p> +4/Catalina from the <a href="https://tomcat.apache.org/"; target="_top">Apache Tomcat project</a>, +and any other jar files which may be needed in future versions (it changes).</p> <p>We recommend (in March 2003) Tomcat version 4.1.x for the most robust version of Jasper.</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/junit.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/junit.html b/manual/Tasks/junit.html index 1382816..e2e7a96 100644 --- a/manual/Tasks/junit.html +++ b/manual/Tasks/junit.html @@ -25,9 +25,10 @@ <h3>Description</h3> <p>This task runs tests from the JUnit testing framework. The latest version of the framework can be -found at <a href="https://junit.org";>https://junit.org</a>. 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.x, -including "pure" JUnit 4 tests using only annotations and no <code>JUnit4TestAdapter</code>.</p> +found at <a href="https://junit.org"; target="_top">https://junit.org</a>. 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.x, including "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 in the Apache Ant distribution. See <a href="../install.html#librarydependencies"> Library Dependencies</a> for more information.</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/junitreport.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/junitreport.html b/manual/Tasks/junitreport.html index 6f4b79e..c81c2cf 100644 --- a/manual/Tasks/junitreport.html +++ b/manual/Tasks/junitreport.html @@ -34,10 +34,10 @@ information.</p> <h3>Requirements</h3> -<p>The task needs Apache <a href="https://xml.apache.org/xalan-j/";>Xalan 2.4.1+ or Xalan XSLTC</a> -(JDK 1.4 contains a version of Xalan 2.x, while JDK 1.5 ships with a version of XSLTC). JDK 1.4.2-01 -and later ships with a bundled Xalan 2.4.1+, meaning that JDKs prior to version 1.4.2-01 won't work -out of the box. The table below summarize the compatibility status.</p> +<p>The task needs Apache <a href="https://xml.apache.org/xalan-j/"; target="_top">Xalan 2.4.1+ or +Xalan XSLTC</a> (JDK 1.4 contains a version of Xalan 2.x, while JDK 1.5 ships with a version of +XSLTC). JDK 1.4.2-01 and later ships with a bundled Xalan 2.4.1+, meaning that JDKs prior to version +1.4.2-01 won't work out of the box. The table below summarize the compatibility status.</p> <table> <tr><th>Xalan</th><th>Sun JDK Bundle</th><th>Status<th></tr> <tr><td>2.4.1+</td><td>JDK 1.4.2-01+</td><td>OK</td></tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/loadfile.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/loadfile.html b/manual/Tasks/loadfile.html index 87d2c2c..4a251ae 100644 --- a/manual/Tasks/loadfile.html +++ b/manual/Tasks/loadfile.html @@ -68,7 +68,7 @@ is not set.</p> </tr> </table> -<p>The LoadFile task supports nested <a href="../Types/filterchain.html"> FilterChain</a>s.</p> +<p>The LoadFile task supports nested <a href="../Types/filterchain.html">FilterChain</a>s.</p> <h3>Examples</h3> <pre> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/loadresource.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/loadresource.html b/manual/Tasks/loadresource.html index 2c8efa7..af86248 100644 --- a/manual/Tasks/loadresource.html +++ b/manual/Tasks/loadresource.html @@ -67,7 +67,7 @@ the property is not set.</p> <td>No; default is <q>false</q></td> </tr> </table> -<p>The LoadResource task supports nested <a href="../Types/filterchain.html"> FilterChain</a>s.</p> +<p>The LoadResource task supports nested <a href="../Types/filterchain.html">FilterChain</a>s.</p> <h3>Examples</h3> <pre> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/macrodef.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/macrodef.html b/manual/Tasks/macrodef.html index bfdd851..ffde288 100644 --- a/manual/Tasks/macrodef.html +++ b/manual/Tasks/macrodef.html @@ -107,9 +107,8 @@ <tr> <td>doubleexpanding</td> <td>Controls whether or not property references in the attribute are expanded twice or just - once. See - the <a href="https://ant.apache.org/faq.html#macrodef-property-expansion";>FAQ</a> for - details. <em>Since Ant 1.8.3</em></td> + once. See the <a href="https://ant.apache.org/faq.html#macrodef-property-expansion"; + target="_top">FAQ</a> for details. <em>Since Ant 1.8.3</em></td> <td>No; default is <q>true</q></td> </tr> </table> @@ -205,7 +204,8 @@ <p>The following fragment defines a task called <code><call-cc></code> which take the attributes <var>target</var>, <var>link</var> and <var>target.dir</var> and the nested element <code>cc-elements</code>. The body of the task uses the <code><cc></code> task - from the <a href="http://ant-contrib.sourceforge.net/";>ant-contrib</a> project.</p> + from the <a href="http://ant-contrib.sourceforge.net/"; target="_top">ant-contrib</a> + project.</p> <pre class="code"> <macrodef name="call-cc"> <attribute name="target"/> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/mail.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/mail.html b/manual/Tasks/mail.html index 6c2c831..d096004 100644 --- a/manual/Tasks/mail.html +++ b/manual/Tasks/mail.html @@ -84,8 +84,8 @@ more information.</p> <tr> <td>messagefileinputencoding</td> <td>Specifies the encoding of the input file. Please - see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html";>Supported - Encodings</a> for a list of possible values. <em>Since Ant 1.9.4</em> + see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html"; + target="_top">Supported Encodings</a> for a list of possible values. <em>Since Ant 1.9.4</em> </td> <td>No; defaults to default JVM character encoding</td> </tr> @@ -237,8 +237,8 @@ can contain email addresses of the form:</p> <td>inputencoding</td> <td> Specifies the encoding of the input file. Please - see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html";>Supported - Encodings</a> for a list of possible values. <em>Since Ant 1.9.4</em> + see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html"; + target="_top">Supported Encodings</a> for a list of possible values. <em>Since Ant 1.9.4</em> </td> <td>No; defaults to default JVM character encoding</td> </tr> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/manifest.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/manifest.html b/manual/Tasks/manifest.html index 1c8a205..e11d306 100644 --- a/manual/Tasks/manifest.html +++ b/manual/Tasks/manifest.html @@ -32,8 +32,8 @@ file.</p> <p>Manifests are processed according to -the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html";>Jar file -specification</a>. Specifically, a manifest element consists of a set of attributes and +the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html"; target="_top">Jar +file specification</a>. Specifically, a manifest element consists of a set of attributes and sections. These sections in turn may contain attributes. Note in particular that this may result in manifest lines greater than 72 bytes being wrapped and continued on the next line.</p> @@ -151,8 +151,8 @@ sections.</p> attribute will take the value of the Ant property <code>${user.name}</code>. The same is true for the <code>${version}</code> and <code>${TODAY}</code> properties. This example produces a <samp>MANIFEST.MF</samp> that -contains <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/versioning/spec/versioning2.html#wp90779";>package -version identification</a> for the package <samp>common</samp>.</p> +contains <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/versioning/spec/versioning2.html#wp90779"; +target="_top">package version identification</a> for the package <samp>common</samp>.</p> <p>The manifest produced by the above would look like this:</p> http://git-wip-us.apache.org/repos/asf/ant/blob/97d81a72/manual/Tasks/mimemail.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/mimemail.html b/manual/Tasks/mimemail.html index 9554d00..f55863a 100644 --- a/manual/Tasks/mimemail.html +++ b/manual/Tasks/mimemail.html @@ -31,9 +31,10 @@ <h3>Description</h3> <p>Sends SMTP mail with MIME -attachments. <a href="https://www.oracle.com/technetwork/java/index-138643.html";>JavaMail</a> -and <a href="https://www.oracle.com/technetwork/java/javase/jaf-135115.html";>Java Activation -Framework</a> are required for this task.</p> +attachments. <a href="https://www.oracle.com/technetwork/java/index-138643.html"; +target="_top">JavaMail</a> +and <a href="https://www.oracle.com/technetwork/java/javase/jaf-135115.html"; target="_top">Java +Activation Framework</a> are required for this task.</p> <p>Multiple files can be attached using <a href="../Types/fileset.html">FileSets.</a></p> <h3>Parameters</h3> <table class="attr">
