Browse Source

regex requirements are softer now that Ant requires Java 1.4

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@1027524 13f79535-47bb-0310-9956-ffa450edef68
master
Stefan Bodewig 14 years ago
parent
commit
c139652358
1 changed files with 13 additions and 10 deletions
  1. +13
    -10
      docs/manual/Types/mapper.html

+ 13
- 10
docs/manual/Types/mapper.html View File

@@ -368,27 +368,30 @@ ignored.</p>


<p>Note that you need to escape a dollar-sign (<code>$</code>) with <p>Note that you need to escape a dollar-sign (<code>$</code>) with
another dollar-sign in Ant.</p> another dollar-sign in Ant.</p>

<p>The regexp mapper needs a supporting library and an implementation <p>The regexp mapper needs a supporting library and an implementation
of <code>org.apache.tools.ant.util.regexp.RegexpMatcher</code> that of <code>org.apache.tools.ant.util.regexp.RegexpMatcher</code> that
hides the specifics of the library. Ant comes with implementations for
<a href="http://download.oracle.com/javase/6/docs/api/java/util/regex/package-summary.html" target="_top">the java.util.regex package</a>,
<a href="http://jakarta.apache.org/regexp/" target="_top">jakarta-regexp</a> and <a
href="http://jakarta.apache.org/oro/" target="_top">jakarta-ORO</a>. If you compile
from sources and plan to use one of them, make sure the libraries are
in your <code>CLASSPATH</code>. For information about using <a
hides the specifics of the library. <em>Since Ant 1.8.0</em> Ant
requires Java 1.4 to run, so the implementation based on
the <code>java.util.regex</code> package will always be available.
You can still use Jakarta ORO or Jakarta Regex instead if your
provide the corresponding jar in your CLASSPATH.</p>

<p>For information about using <a
href="http://www.cacas.org/~wes/java/" target="_top">gnu.regexp</a> or <a href="http://www.cacas.org/~wes/java/" target="_top">gnu.regexp</a> or <a
href="http://www.crocodile.org/~sts/Rex/" target="_top">gnu.rex</a> with Ant, see <a href="http://www.crocodile.org/~sts/Rex/" target="_top">gnu.rex</a> with Ant, see <a
href="http://marc.theaimsgroup.com/?l=ant-dev&m=97550753813481&w=2" target="_top">this</a> href="http://marc.theaimsgroup.com/?l=ant-dev&m=97550753813481&w=2" target="_top">this</a>
article.</p> article.</p>
<p>If you want to use one of the supported regular expression
libraries you need to also use
the corresponding <code>ant-[jakarta-oro, jakarta-regexp, apache-oro, apache-regexp}.jar</code>

<p>If you want to use one of the regular expression
libraries other than <code>java.util.regex</code> you need to also use
the corresponding <code>ant-[apache-oro, apache-regexp].jar</code>
from the Ant release you are using. from the Ant release you are using.
Make sure, both will be loaded from the same Make sure, both will be loaded from the same
classpath, that is either put them into your <code>CLASSPATH</code>, classpath, that is either put them into your <code>CLASSPATH</code>,
<code>ANT_HOME/lib</code> directory or a nested <code>ANT_HOME/lib</code> directory or a nested
<code>&lt;classpath&gt;</code> element of the mapper - you cannot have <code>&lt;classpath&gt;</code> element of the mapper - you cannot have
<code>ant-[jakarta-oro, jakarta-regexp, apache-oro, apache-regexp].jar</code> in <code>ANT_HOME/lib</code>
<code>ant-[apache-oro, apache-regexp].jar</code> in <code>ANT_HOME/lib</code>
and the library and the library
in a nested <code>&lt;classpath&gt;</code>.</p> in a nested <code>&lt;classpath&gt;</code>.</p>
<p>Ant will choose the regular-expression library based on the <p>Ant will choose the regular-expression library based on the


Loading…
Cancel
Save