This package defines API modeled after XML Information Set for building incrmentally XML trees from events streamed from pull parser (user can start navigating tree before whole XML input was parsed!) and has an unique ability to bypass tree building for selected sub trees to work directly with underlying event stream. This coupled with ability to create XML tree that can mix in any Java Object allows to represent objects derived from XML (databinding) in the XML tree.

## Features

- unique ability to achieve high performance that is common in streaming parsers and ease of use associated with tree approaches in the same API by provising very precise control over XML tree creation and access to underlying streaming parser during tree creation (API users needs to do it if and only if they do want to bypass default tree creation and replace it with their customized object tree, work directly with XML events or just skip unneded parts of XML that do not need to be in XML node tree).
- easy to use: modeled after XML Information Set to build on well established abstract model to represent XML
- small: only few classes and interfaces
- fast: builds on the most powerful XmlPull API that makes possible to create high perfromance parser implemntations
- flexible: based on the state of the art interface-implementation approach allowing anybody to modify and extend easily API

## Overview

API is directly modeled on XML Information Set with few minor exceptions but expands on it to provide additional functions to create and manipulate XML Information Set (essentially providing Synthetic Infoset).

### TODO:

- when generics are supported in JDK upgrade API to use Iterator<T> instead of Enumeration ...

  Last modified: $Id: package.html,v 1.1 2003/04/13 00:59:23 aslom Exp $