From c4b1bed3b6dda60444688c398126ca6164c45fe3 Mon Sep 17 00:00:00 2001 From: Steve Loughran Date: Mon, 9 Sep 2002 16:49:23 +0000 Subject: [PATCH] rolling back feature support, but retaining the extra explanation text under existing examples git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@273314 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/OptionalTasks/xmlvalidate.html | 49 ++++++---------------- 1 file changed, 12 insertions(+), 37 deletions(-) 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