Castor XML - HOW-TO's
=====================

Introduction
------------

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'.

Documentation
-------------

-   How to Author a How-To **(Author wanted!)**
-   How to Author an FAQ **(Author wanted!)**
-   How to Author a Code Snippet **(Author wanted!)**
-   How to Author Core Documentation **(Author wanted!)**

Contribution
------------

-   [How to submit an XML-specific bug report](http://www.castor.org/how-to-submit-an-xml-bug.html)
-   [How to prepare a patch](http://www.castor.org/how-to-prepare-a-patch.html)
-   How to Contribute a Patch via Jira **(Author wanted!)**
-   [How to run Castor XML's test suite](http://www.castor.org/how-to-run-xml-ctf-suite.html)

Mapping
-------

-   [How to use XMLContext for un-/marshalling](http://www.castor.org/how-to-use-XMLContext.html)
-   [How to map a collection of elements](http://www.castor.org/how-to-map-a-collection.html)
-   [How to map a map/hashtable of elements](http://www.castor.org/how-to-map-a-hashtable.html)
-   [How to map a list of elements at the root](http://www.castor.org/how-to-map-a-list-at-root.html)
-   [How to map constructor arguments](http://www.castor.org/how-to-map-a-class-with-constructors.html)
-   [How to map an inner class](http://www.castor.org/how-to-map-an-inner-class.html)
-   [How to Unmarshal raw XML segments into arbitrary types](http://www.castor.org/how-to-unmarshal-raw-xml.html)
-   [How to use references in XML and Castor](http://www.castor.org/how-to-use-references-in-xml.html)
-   [How to wrap a collection with a wrapper element](http://www.castor.org/how-to-wrap-a-collection-with-a-wrapper-element.html)
-   [How to prevent a collection from being exposed](http://www.castor.org/how-to-prevent-collection-from-being-exposed.html)
-   [How to write a configurable field handler](http://www.castor.org/how-to-write-a-configurablefieldhandler.html)
-   [How to map text content](http://www.castor.org/how-to-map-both-structure-and-content.html)
-   [How to work with wrapper elements around collections](http://www.castor.org/how-to-work-with-wrapper-elements-around-collections.html)
-   [How to work marshal XML documents with version 1.1](http://www.castor.org/how-to-marshall-version-1.1-xml.html)

Validation
----------

-   [How to use XML validation](http://www.castor.org/how-to-enable-xml-validation.html)

Source generation
-----------------

-   [How to use a binding file with source generation](http://www.castor.org/how-to-use-a-binding-file-with-source-generation.html)

Others
------

-   [How to implement a custom serializer](http://www.castor.org/how-to-implement-custom-serializer.html)
-   [How to fetch DTDs and XML Schemas from JAR files](http://www.castor.org/how-to-fetch-dtds-and-schemas-from-jars.html)
-   [How to marshal Hibernate proxies](http://www.castor.org/how-to-map-hibernate-proxies.html)
