cDomlette - technical details
=============================

Overview
--------

cDomlette is a DOM-like interface for Python implemented in C.

Features
--------

 * DOM-based node creation and manipulation API
 * expat parser for creating cDomlette documents from XML text
   - XInclude processing (http://www.w3.org/TR/xinclude)
 * Support for xml:base (http://www.w3.org/TR/xmlbase)
 * string pooling (using intern semantics) for efficiency

The state machine
-----------------

The expat parser uses an explicit state machine in its operation.  The
core of the state machine is in state_machine.c and state_machine.h.

To do
-----

 * external parsed entity parsing to document fragment
 * 
