docs/readme.xml

<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "./dtd/document.dtd">

<s1 title="&javaparsernamelong; Readme">
	<s2 title="&javaparsernamelong; &javaparserversion; Release">
		<p>The &javaparsernamelong; &javaparserversion; supports 
		<jump href="http://www.w3.org/TR/1998/REC-xml-19980210">XML 1.0</jump> 
		recommendation and contains advanced parser functionality, such as 
		<jump href="http://www.w3.org/XML/Group/Schemas.html">XML Schema</jump>, 
		<jump href="http://www.w3.org/TR/DOM-Level-2/">DOM Level 2 version 1.0</jump>, and 
		<jump href="http://www.megginson.com/SAX/">SAX Version 2</jump>, 
		in addition to supporting the industry-standard 
		<jump href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html">DOM Level 1</jump> and 
		<jump href="http://www.megginson.com/SAX/SAX1/">SAX version 1</jump>
		APIs.</p>
        <p>
        Note that because some of the standards
		are still not complete, the stable API will definitely be 
		different from its current form in &javaparsername; &javaparserversion;. 
		This is your chance to give us 
		feedback on the features that are important to you, and let us know
		whether the APIs that we are providing are the right ones. Please 
		direct your feedback to the &javaparsername; mailing list.</p>

	</s2>
	<s2 title="License Information">
		<p>The &javaparsername; &javaparserversion; release is available in both source code
		and precompiled binary (JAR files) form. Both &javaparsername; 
                packages are made available under the <jump href='../../LICENSE'>Apache
                Software License</jump>.
                </p>
	</s2>
	<s2 title="Applications of the &javaparsername; Parser">
		<p>The rich generating and validating capabilities allow the &javaparsername; 
		Parser to be used for: </p>
		<ul>
			<li>Building XML-savvy Web servers. </li>
			<li>The next generation of vertical applications which will use 
				XML as their data format. </li>
			<li>On-the-fly validation for creating XML editors. </li>
			<li>Ensuring the integrity of e-business data expressed in XML. </li>
			<li>Building truly internationalized XML applications. </li>
		</ul>
	</s2>
	<s2 title="XML Schema (alpha) Support">
		<p>This release includes preliminary support for the W3C XML Schema 
		Language. The <link idref="schema">Schema</link> page contains a 
		complete description of the 
		schema capabilities of this release. We intend to track the W3C XML 
		Schema Language in subsequent updates of &javaparsername;.</p>
	</s2>
	<s2 title="DOM Level 2 (beta) Support">
		<p>This release includes support for the 
		<jump href="http://www.w3.org/TR/WD-DOM-Level-2">DOM Level 2</jump>.
                As of this writing, the DOM Level 2 specification is now a
                Candidate Recommendation.</p>
	</s2>
	<s2 title="SAX 2 Support">
		<p>This release includes support for the <jump href="http://www.megginson.com/SAX/">
		SAX Version 2</jump> API&apos;s which have been finalized.</p>
	</s2>
	<s2 title="Configuration Mechanism">
		<p>&javaparsername; &javaparserversion; uses a collection of methods to configure 
		various settings in the parser. This release includes a new mechanism 
		for setting parser switches. This mechanism uses the SAX2 configuration
		methods that are part of the XMLReader interface. We have defined a series 
		of <link idref="properties">properties</link> and 
		<link idref="features">features</link> for the &javaparsername; 
		options. </p>
	</s2>
</s1>