1 files changed, 59 insertions, 0 deletions
diff --git a/xsd-examples/cxx/tree/multiroot/README b/xsd-examples/cxx/tree/multiroot/README
new file mode 100644
index 0000000..81c6b26
--- /dev/null
+++ b/xsd-examples/cxx/tree/multiroot/README
@@ -0,0 +1,59 @@
+This example shows how to handle XML vocabularies with multiple
+root elements using the C++/Tree mapping.
+
+See also the messaging example for an alternative approach that
+uses the element type and element map features of the C++/Tree
+mapping.
+
+The example consists of the following files:
+
+protocol.xsd
+  XML Schema which defines a simple bank account protocol with
+  requests such as withdraw and deposit.
+
+balance.xml
+withdraw.xml
+deposit.xml
+  Sample XML instances for the protocol requests.
+
+protocol.hxx
+protocol.cxx
+  C++ types that represent the given vocabulary and a set of
+  parsing functions that convert XML documents to a tree-like
+  in-memory object model.
+
+  These files are generated by the XSD compiler from protocol.xsd using
+  the following command line:
+
+  xsd cxx-tree --root-element-all protocol.xsd
+
+dom-parse.hxx
+dom-parse.cxx
+  Definition and implementation of the parse() function that
+  parses an XML document to a DOM document.
+
+driver.cxx
+  Driver for the example. It first calls the above parse() function
+  to parse the input file to a DOM document. It then determines the
+  type of request being handled and calls the corresponding parsing
+  function that constructs the object model from this DOM document.
+  Finally, it prints the content of this object model to STDERR.
+  This example intentionally does not support the deposit request
+  to show how to handle unknown documents.
+
+To compile and link the example manually from the command line we can use
+the following commands (replace 'c++' with your C++ compiler name):
+
+c++ -DXSD_CXX11 -c protocol.cxx
+c++ -DXSD_CXX11 -c dom-parse.cxx
+c++ -DXSD_CXX11 -c driver.cxx
+c++ -o driver driver.o protocol.o dom-parse.o -lxerces-c
+
+Note that we need to define the XSD_CXX11 preprocessor macro since the
+source code includes libxsd headers directly.
+
+To run the example on the sample XML request documents execute:
+
+./driver balance.xml
+./driver withdraw.xml
+./driver deposit.xml