<?xml version="1.0"?>
<document url="http://www.dom4j.org/index.xml">

  <properties>
    <title>dom4j: the flexible XML framework for Java</title>
    <author email="jstrachan@apache.org">James Strachan</author>
 </properties>
 
  <body>

    <section name="Welcome to dom4j!">
      <p>
      <i>dom4j</i> is an easy to use, open source library for working with XML, XPath and
      XSLT on the Java platform using the Java Collections Framework and with full
      support for DOM, SAX and JAXP.
      </p>
    </section>

    <section name="News">
      <ul>
        <li>dom4j 1.6.1 has been relased! This is a bugfix relase. Take a look at the <a href="changes-report.html">changelog</a> to see what has changed.</li>
        <li>dom4j 1.6 has been released! Take a look at the <a href="changes-report.html">changelog</a> to see what has changed.</li>
        <li><a href="http://www.jetbrains.com/">JetBrains</a> was so kind to provide an open-source license of its famous 
            <a href="http://www.jetbrains.com/idea/index.html">IntelliJ IDEA</a> product.</li>
        <li>The internal Aelfred2 parser has been removed from the dom4j codebase due to an incompatible license. You can download a version
            of dom4j without Aelfred2 from the downloads page.</li>
        <li>A maintenance relase of dom4j is available. Click <a href="changes-report.html">here</a> to see what has changed in dom4j 1.5.1.</li>
        <li>dom4j 1.5 is finally released! A list of changes can be found <a href="changes-report.html">here</a>.</li>
        <li>dom4j now has an open source license for the use of <a href="http://www.cenqua.com/clover/">Clover</a></li>
        <li><a href="http://www.refactorit.com">RefactorIT</a> has added dom4j to it's list of featured open source projects. This means that all 
          the power of RefactorIT is available for the dom4j sources.
        </li> 
        <li>The new <a href="status.html">dom4j 1.4</a> release is finally out featuring numerous bug fixes and patches.
        </li>
        <li>Check out these new <a href="benchmarks/xpath/index.html">Performance Benchmarks</a> comparing dom4j and Jaxen against Xerces and Xalan. 
        </li>
        <li>The new <a href="status.html">dom4j 1.3</a> release is out featuring numerous bug fixes and patches.
        </li>
        <li>Check out Dennis Sosnoski's new <a href="http://www-106.ibm.com/developerworks/library/x-injava2/">article</a> for IBM comparing various XML object models - its good stuff.
        </li>
        <li>The new <a href="status.html">dom4j 1.2</a> release is out featuring improved whitespace handling 
          for more efficient parsing, a new Swing TableModel for displaying XML data in Swing and numerous bug fixes and patches.
        </li>
        <li>The <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a> projects new 
          <a ref="http://jakarta.apache.org/velocity/dvsl/index.html">DVSL</a> technology uses dom4j.
        </li>
        <li>Interesting <a href="http://www.xml.com/pub/a/2001/11/14/dom-sax.html?page=2">article</a>
          outlining the social dominance of DOM and SAX and the importance of XPath. 
        </li>
        <li>The new <a href="status.html">dom4j 1.1</a> release is out featuring support for DTD declarations and
          numerous bug fixes and patches.
        </li>
        <li>Read the latest performance <a href="http://www-106.ibm.com/developerworks/xml/library/x-injava/index.html">benchmarks</a> 
          on IBM's site comparing dom4j against all the other XML document models.
        </li>
        <li>The new <a href="status.html">dom4j 1.0</a> release is out featuring better SAX and <a href="http://jaxen.org">Jaxen</a> support,
          some performance tuning and numerous patches.
        </li>
        <li>Sun's reference implementation of <a href="http://developer.java.sun.com/developer/earlyAccess/xml/jaxm/">JAXM</a>
          (Java API for XML Messaging) is based on dom4j!
        </li>
        <li>The new <a href="status.html">dom4j 0.9</a> release is out featuring full <a href="http://jaxen.codehaus.org">Jaxen</a> support!
        </li>
        <li>Toby's <a href="cookbook.html">cookbook</a> is now online!
        </li>
        <li>Updated the quick start <a href="guide.html">guide</a>
        </li>
      </ul>
    </section>

    <section name="Features">
      <ul>
        <li>designed for the Java platform with full support for the
        <a href="http://java.sun.com/products/jdk/1.2/docs/guide/collections/index.html">Java Collections Framework</a>
        (Java 2 Collections)</li>
        <li>full support for 
        <a href="http://java.sun.com/xml/xml_jaxp.html">JAXP</a>, 
        <a href="http://java.sun.com/xml/xml_jaxp.html">TrAX</a>, 
        <a href="http://www.saxproject.org/">SAX</a>, 
        <a href="http://www.w3.org/DOM/">DOM</a>, 
        and <a href="http://www.w3.org/TR/xslt.html">XSLT</a>        
        </li>
        <li>fully integrated 
        <a href="http://www.w3.org/TR/xpath.html">XPath</a> 
        support for easy navigation of XML documents
        </li>
        <li>event based proccessing mode to support for massive documents or XML streams
        </li>
        <li>based on Java interfaces for flexible plug and play implementations.
        </li>
        <li>support for 
         <a href="http://www.w3.org/TR/xmlschema-2/">XML Schema Data Type</a>
         support using Kohsuke Kawaguchi's excellent
         <a href="http://www.sun.com/software/xml/developers/multischema/">Multi Schema Validator</a> library
        </li>
      </ul>
    </section>

    <section name="Getting Started">
      <p>You can download the current release 
        or a snapshot build via the <a href="download.html">download page</a>.</p>

      <p>For a quick overview of <i>dom4j</i> and how to use it try the reading the
        <a href="guide.html">quick start guide</a> or browsing the
        <a href="faq.html">FAQ</a> or the online 
        <a href="apidocs/index.html">JavaDoc</a>.
      </p>
      
      <p>To see how <i>dom4j</i> compares to other XML object models you could try
        reading our <a href="compare.html">comparison</a></p>
        
      <p>Contributors are welcome to join this project. 
        Once you've browsed the <a href="faq.html">FAQ</a> you could try
        sending an email to one of the mailing lists below or check out the
        <a href="http://sourceforge.net/projects/dom4j/">project page</a>.</p>
    </section>

    <section name="Useful Links">
      <p>We really like XPath and if you are working with XML we highly recommend
        you try to experiment with it. If you need help learning XPath
        try the excellent
        <a href="http://www.zvon.org/xxl/XPathTutorial/General/examples.html">Zvon tutorial</a> 
        .</p>

      <p>Alternatively you could try Elliotte Rusty Harold's great 
        <a href="http://www.oreilly.com/catalog/xmlnut/chapter/ch09.html">XML in a nutshell</a> 
        .</p>

      <p>Finally you could try reading the 
        <a href="http://www.w3.org/TR/xpath">XPath spec</a>.
      </p>
    </section>

    <section name="Mailing Lists">
      <p>For developers there is an email list at 
        <a href="http://lists.sourceforge.net/lists/listinfo/dom4j-dev">
          dom4j-dev
        </a> 
        where you can make requests for new features or changes to the API, 
        discuss alternate implementation strategies, submit patches or just
        talk about any relevant topic of the day.
      </p>        
      <p>For <i>dom4j</i> users wanting help using dom4j there is an email list at
        <a href="http://lists.sourceforge.net/lists/listinfo/dom4j-user">
          dom4j-user
        </a> 
        where you can share ideas and experiences, ask for help, 
        give us feedback or discuss your requirements.
      </p>

      <p>You can browse the archives for here
        <a href="http://www.geocrawler.com/lists/3/SourceForge/8798/0/">
          dom4j-dev
        </a> 
        or here
        <a href="http://www.mail-archive.com/dom4j-dev%40lists.sourceforge.net/">
          dom4j-dev
        </a> 
        and here
        <a href="http://www.geocrawler.com/lists/3/SourceForge/8797/0/">
          dom4j-user
        </a>
        or here
        <a href="http://www.mail-archive.com/dom4j-user%40lists.sourceforge.net/">
          dom4j-user
        </a>
      </p>
    </section>

  </body>
</document>
