aboutsummaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
Diffstat (limited to 'examples')
-rw-r--r--examples/README21
-rw-r--r--examples/hybrid/README3
-rw-r--r--examples/inheritance/README3
-rw-r--r--examples/performance/README4
-rw-r--r--examples/persistence/README3
-rw-r--r--examples/processing/README4
-rw-r--r--examples/roundtrip/README3
7 files changed, 41 insertions, 0 deletions
diff --git a/examples/README b/examples/README
new file mode 100644
index 0000000..1a55867
--- /dev/null
+++ b/examples/README
@@ -0,0 +1,21 @@
+processing
+ Shows how to parse a specific XML vocabulary, extract the data, and store
+ it back to XML.
+
+persistence
+ Shows how to implement C++ classes that know how to persist themselves in
+ XML.
+
+inheritance
+ Shows how to implement XML persistence for C++ classes that use inheritance.
+
+roundtrip
+ Shows how to "roundtrip" an XML document, that is, parse it and serialize
+ it back to XML.
+
+hybrid
+ Shows how to implement hybrid, partially in-memory, partially streaming
+ parsing and serialization.
+
+performance
+ Measures the performance of the parser.
diff --git a/examples/hybrid/README b/examples/hybrid/README
index e69de29..89ad83a 100644
--- a/examples/hybrid/README
+++ b/examples/hybrid/README
@@ -0,0 +1,3 @@
+This example shows how to implement hybrid, partially in-memory, partially
+streaming parsing and serialization. It includes a sample implementation
+of a DOM-like representation of raw XML (dom.?xx).
diff --git a/examples/inheritance/README b/examples/inheritance/README
index e69de29..c74510b 100644
--- a/examples/inheritance/README
+++ b/examples/inheritance/README
@@ -0,0 +1,3 @@
+This example shows how to implement XML persistence for C++ classes that use
+inheritance. For the simple case without inheritance see the 'persistence'
+example.
diff --git a/examples/performance/README b/examples/performance/README
index e69de29..1ec5a9f 100644
--- a/examples/performance/README
+++ b/examples/performance/README
@@ -0,0 +1,4 @@
+This example measures the performance of the parser. You can generate smaller
+or larger test files using the gen.cxx program. You can also compare the
+result to the no-op Expat implementation by compiling and running the
+expat.cxx program.
diff --git a/examples/persistence/README b/examples/persistence/README
index e69de29..14b9acc 100644
--- a/examples/persistence/README
+++ b/examples/persistence/README
@@ -0,0 +1,3 @@
+This example shows how to implement C++ classes that know how to persist
+themselves in XML. This is the simple case that doesn't involve inheritance.
+For inheritance support see the 'inheritance' example. \ No newline at end of file
diff --git a/examples/processing/README b/examples/processing/README
index e69de29..fb48877 100644
--- a/examples/processing/README
+++ b/examples/processing/README
@@ -0,0 +1,4 @@
+This example shows how to parse a specific XML vocabulary, extract the
+data, and store it back to XML. This example can be used as a base for
+applications that need to process the data without creating any kind of
+object model.
diff --git a/examples/roundtrip/README b/examples/roundtrip/README
index e69de29..3df848e 100644
--- a/examples/roundtrip/README
+++ b/examples/roundtrip/README
@@ -0,0 +1,3 @@
+This example shows how to "roundtrip" an XML document, that is, parse it
+and serialize it back to XML. It can be used as a base for converters and
+filters.