<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="http://castor.codehaus.org/xml-howto.xml">

  <body>

    <section title="Castor XML - HOW-TO's">

      <section title="Introduction">
        <p>
          This is a collection of HOW-TOs. The Castor project is actively
          seeking  additional HOW-TO contributors to expand this collection. For
          information  on how to do that, please see 'How to write a How-to'.
          Note that document titles <font color="lightgrey">in light grey</font>
          identify documents that do not exist yet and are thus in search of an
          author.
        </p>
      </section>

      <section title="Documentation">
        <ul>
          <li><font color="lightgrey">How to Author a How-To</font> <i>(Author wanted!)</i></li>
          <li><font color="lightgrey">How to Author an FAQ</font> <i>(Author wanted!)</i></li>
          <li><font color="lightgrey">How to Author a Code Snippet</font> <i>(Author wanted!)</i></li>
          <li><font color="lightgrey">How to Author Core Documentation</font> <i>(Author wanted!)</i></li>
        </ul>
      </section>

      <section title="Contribution">
        <ul>
          <li><a href="how-to-submit-an-xml-bug.html">How to submit an XML-specific bug report</a></li>
          <li><a href="how-to-prepare-a-patch.html">How to prepare a patch</a></li>
          <li><font color="lightgrey">How to Contribute a Patch via Jira <i>(Author wanted!)</i></font></li>
          <li><a href="how-to-run-xml-ctf-suite.html">How to run Castor XML's test suite</a></li>
        </ul>
      </section>

      <section title="Mapping">
        <ul>
          <li><a href="how-to-use-XMLContext.html">How to use XMLContext for un-/marshalling</a></li>
          <li><a href="how-to-map-a-collection.html">How to map a collection of elements</a></li>
          <li><a href="how-to-map-a-hashtable.html">How to map a map/hashtable of elements</a></li>
          <li><a href="how-to-map-a-list-at-root.html">How to map a list of elements at the root</a></li>
          <li><a href="how-to-map-a-class-with-constructors.html">How to map constructor arguments</a></li>
          <li><a href="how-to-map-an-inner-class.html">How to map an inner class</a></li>
          <li><a href="how-to-unmarshal-raw-xml.html">How to Unmarshal raw XML segments into arbitrary types</a></li>
          <li><a href="how-to-use-references-in-xml.html">How to use references in XML and Castor</a></li>
          <li><a href="how-to-wrap-a-collection-with-a-wrapper-element.html">How to wrap a collection with a wrapper element</a></li>
          <li><a href="how-to-prevent-collection-from-being-exposed.html">How to prevent a collection from being exposed</a></li>
          <li><a href="how-to-write-a-configurablefieldhandler.html">How to write a configurable field handler</a></li>
          <li><a href="how-to-map-both-structure-and-content.html">How to map text content</a></li>
         <li><a href="how-to-work-with-wrapper-elements-around-collections.html">How to work with wrapper elements around collections</a></li>
        </ul>
      </section>

      <section title="Validation">
        <ul>
          <li><a href="how-to-enable-xml-validation.html">How to use XML validation</a></li>
        </ul>
      </section>

      <section title="Source generation">
        <ul>
          <li><a href="how-to-use-a-binding-file-with-source-generation.html">How to use a binding file with source generation</a></li>
        </ul>
      </section>

      <section title="Others">
        <ul>
          <li><a href="how-to-implement-custom-serializer.html">How to implement a custom serializer</a></li>
          <li><a href="how-to-fetch-dtds-and-schemas-from-jars.html">How to fetch DTDs and XML Schemas from JAR files</a></li>
          <li><a href="how-to-map-hibernate-proxies.html">How to marshal Hibernate proxies</a></li>
        </ul>
      </section>

     </section>

  </body>

</document>
