diff --git a/docs/manual/OptionalTasks/xmlvalidate.html b/docs/manual/OptionalTasks/xmlvalidate.html index 5cd4b693e..71ead0e57 100644 --- a/docs/manual/OptionalTasks/xmlvalidate.html +++ b/docs/manual/OptionalTasks/xmlvalidate.html @@ -9,17 +9,14 @@

XMLValidate

Description

-

This task checks XML files are valid (or only well formed). The +

This task checks xml files are valid (or only well formed). The task uses the SAX2 parser implementation provided by JAXP by default -(usually the one that is used by Ant itself), but one can specify any -SAX1/2 parser if needed. Ant ships with Xerces, which is also what is built in -to Java 1.4: XML parsers built into the runtime override Ant's choice.

+(probably the one that is used by Ant itself), but one can specify any +SAX1/2 parser if needed.

-

This task supports the use of nested -

  • <xmlcatalog> elements -
  • <dtd> elements which are used to resolve DTDs and other entities. -
  • <feature> elements which are used to set features. These can be any number of http://xml.org/sax/features/ -

    +

    This task supports the use of nested xmlcatalog elements and/or nested +<dtd> elements which are used to resolve DTDs and entities.

    Parameters

    @@ -65,7 +62,7 @@ to Java 1.4: XML parsers built into the runtime override Ant's choice.

    Nested Elements

    dtd

    -<dtd> is used to specify different locations for DTD and entity resolution. +<dtd> is used to specify different locations for DTD resolution.
    @@ -87,19 +84,14 @@ to Java 1.4: XML parsers built into the runtime override Ant's choice.

    xmlcatalog

    The xmlcatalog element is used to perform Entity resolution.

    -

    feature

    -

    The feature element is used to set SAX Parser features. -A feature essentialy changes the mode of the parser. -There can be an arbitrary amount of features set as defined here: - http://xml.org/sax/features/ - -

    Examples

     <xmlvalidate file="toto.xml"/>
    -
    +
    +Validate toto.xml +
     <xmlvalidate failonerror="no" lenient="yes" warn="yes"
                  classname="org.apache.xerces.parsers.SAXParser">
                  classpath="lib/xerces.jar">
    @@ -108,8 +100,8 @@ There can  be an arbitrary amount of features set as defined here:
     
    Validate all .xsl files in src/style, but only warn if there is an error, rather than halt the build. -
    +
     <xmlvalidate file="struts-config.xml" warn="false">
       <dtd publicId="-//Apache Software Foundation//DTD Struts Configuration 1.0//EN"
            location="struts-config_1_0.dtd"/>
    @@ -117,8 +109,7 @@ halt the build.
     
    Validate a struts configuration, using a local copy of the DTD. -
    -
    +
     
     <xmlvalidate failonerror="no">
       <fileset dir="${project.dir}" includes="**/*.xml"/>
       <xmlcatalog refid="mycatalog"/>
    @@ -127,7 +118,6 @@ Validate a struts configuration, using a local copy of the DTD.
     
     Scan all XML files in the project, using a predefined catalog to map URIs to local files.
     
    -
     <xmlvalidate failonerror="no">
       <fileset dir="${project.dir}" includes="**/*.xml"/>
       <xmlcatalog>
    @@ -137,22 +127,7 @@ Scan all XML files in the project, using a predefined catalog to map URIs to loc
       </xmlcatalog>
     </xmlvalidate>
     
    - Scan all XML files in the project, using the catalog defined inline. - -
    -
    -<xmlvalidate failonerror="yes" lenient="no" warn="yes">
    -
    -  <fileset dir="xml" includes="**/*.xml"/>
    -  <feature name="http://xml.org/sax/features/validation" value="true"/>
    -  <feature name="http://apache.org/xml/features/validation/schema"  value="true"/>
    -
    -</xmlvalidate>
    -
    - -Validate the XML files using XML Schema validation. -

    Copyright © 2001-2002 Apache Software Foundation. All rights

    Attribute