Changed the internals a lot for DOM, entity support, slight changes of API,
more (if not all) formating of function comments, started documentation, Daniel.
diff --git a/doc/DOM.fig b/doc/DOM.fig
new file mode 100644
index 0000000..7a48a32
--- /dev/null
+++ b/doc/DOM.fig
@@ -0,0 +1,64 @@
+#FIG 3.2
+Landscape
+Center
+Inches
+Letter
+100.00
+Single
+-2
+1200 2
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 825 1125 2625 1125 2625 3375 825 3375 825 1125
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 4125 1125 5925 1125 5925 3375 4125 3375 4125 1125
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 2025 3075 2025 1650 1050 1650 1050 3075 2025 3075
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1425 1875 1575 1875 1575 2025 1425 2025 1425 1875
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1200 2175 1350 2175 1350 2325 1200 2325 1200 2175
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1500 2175 1650 2175 1650 2325 1500 2325 1500 2175
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1800 2175 1950 2175 1950 2325 1800 2325 1800 2175
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1500 2475 1650 2475 1650 2625 1500 2625 1500 2475
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1725 2700 1875 2700 1875 2850 1725 2850 1725 2700
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1275 2700 1425 2700 1425 2850 1275 2850 1275 2700
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1500 2025 1350 2175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1500 2025 1575 2175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1500 2025 1875 2175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1575 2325 1575 2475
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1650 2625 1725 2700
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1500 2625 1425 2700
+2 3 0 2 0 7 0 0 -1 6.000 0 0 -1 0 0 5
+ 2550 1725 2175 1950 2175 2850 2550 3075 2550 1725
+2 3 0 2 0 7 0 0 -1 6.000 0 0 -1 0 0 5
+ 4575 1725 4200 1950 4200 2850 4575 3075 4575 1725
+2 2 0 1 0 7 0 0 -1 4.000 0 0 -1 0 0 5
+ 2700 2025 4050 2025 4050 2775 2700 2775 2700 2025
+2 1 0 2 0 7 0 0 -1 6.000 0 0 -1 0 0 2
+ 5025 2025 4575 2175
+2 1 1 2 0 7 0 0 -1 6.000 0 0 -1 1 0 3
+ 1 1 2.00 120.00 240.00
+ 4575 2175 4200 2250 2025 2250
+2 1 1 2 0 7 0 0 -1 6.000 0 0 -1 0 0 3
+ 2025 2475 4200 2475 4575 2550
+2 1 0 2 0 7 0 0 -1 6.000 0 0 -1 1 0 2
+ 1 1 2.00 120.00 240.00
+ 4575 2550 5025 2625
+4 0 0 0 0 0 18 0.0000 4 255 1155 1050 825 Program 1\001
+4 0 0 0 0 0 18 0.0000 4 255 1155 4425 900 Program 2\001
+4 0 0 0 0 0 18 0.0000 4 195 585 1350 1500 XML\001
+4 0 0 0 0 0 18 0.0000 4 195 975 3000 3075 CORBA\001
+4 0 0 0 0 0 18 0.0000 4 195 735 3000 3375 ORBit\001
+4 0 0 0 0 0 18 0.0000 4 195 1395 2175 1575 DOM server\001
+4 0 0 0 0 0 18 0.0000 4 195 1335 4200 1650 DOM client\001
diff --git a/doc/DOM.gif b/doc/DOM.gif
new file mode 100644
index 0000000..a44882f
--- /dev/null
+++ b/doc/DOM.gif
Binary files differ
diff --git a/doc/structure.fig b/doc/structure.fig
new file mode 100644
index 0000000..34f6237
--- /dev/null
+++ b/doc/structure.fig
@@ -0,0 +1,303 @@
+#FIG 3.2
+Landscape
+Center
+Inches
+Letter
+100.00
+Single
+-2
+1200 2
+6 1275 4425 5475 5100
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 2250 5100 2250 4425 1275 4425 1275 5100 2250 5100
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 3975 5100 3975 4425 3000 4425 3000 5100 3975 5100
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 5475 5100 5475 4425 4500 4425 4500 5100 5475 5100
+4 0 0 0 0 14 16 0.0000 4 135 600 4650 4725 TEXT\001
+4 0 0 0 0 14 16 0.0000 4 135 600 1425 4725 TEXT\001
+4 0 0 0 0 14 16 0.0000 4 135 900 3075 4725 ENTITY\001
+4 0 0 0 0 14 16 0.0000 4 135 450 3075 4950 REF\001
+-6
+6 825 4575 900 5100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4575 900 5100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 5025 825 5100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4950 825 5025
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4800 825 4875
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4875 825 4950
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4650 825 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4725 825 4800
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 900 4575 825 4650
+-6
+6 1125 2325 1200 2850
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2325 1200 2850
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2775 1125 2850
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2700 1125 2775
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2550 1125 2625
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2625 1125 2700
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2400 1125 2475
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2475 1125 2550
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 1200 2325 1125 2400
+-6
+6 2550 4650 2625 5175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 4650 2625 5175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 5100 2550 5175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 5025 2550 5100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 4875 2550 4950
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 4950 2550 5025
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 4725 2550 4800
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 4800 2550 4875
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2625 4650 2550 4725
+-6
+6 6000 4200 6075 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4200 6075 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4650 6000 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4575 6000 4650
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4425 6000 4500
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4500 6000 4575
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4275 6000 4350
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4350 6000 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 6075 4200 6000 4275
+-6
+6 2475 4425 2550 4950
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4950 2475 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4500 2550 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4575 2550 4500
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4725 2550 4650
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4650 2550 4575
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4875 2550 4800
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4800 2550 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 2475 4950 2550 4875
+-6
+6 5775 4425 5850 4950
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4950 5775 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4500 5850 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4575 5850 4500
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4725 5850 4650
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4650 5850 4575
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4875 5850 4800
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4800 5850 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 5775 4950 5850 4875
+-6
+6 9000 2100 9075 2625
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2625 9000 2100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2175 9075 2100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2250 9075 2175
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2400 9075 2325
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2325 9075 2250
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2550 9075 2475
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2475 9075 2400
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 9000 2625 9075 2550
+-6
+6 11850 4050 11925 4575
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4575 11850 4050
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4125 11925 4050
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4200 11925 4125
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4350 11925 4275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4275 11925 4200
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4500 11925 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4425 11925 4350
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2
+ 11850 4575 11925 4500
+-6
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 3150 375 4425 375 4425 1275 3150 1275 3150 375
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 2850 2775 2850 2100 1875 2100 1875 2775 2850 2775
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 5550 2775 5550 2100 4575 2100 4575 2775 5550 2775
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 8175 2775 8175 2100 7200 2100 7200 2775 8175 2775
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 7650 4725 7650 4050 6675 4050 6675 4725 7650 4725
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 9675 4725 9675 4050 8700 4050 8700 4725 9675 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 3750 1275 2400 2100
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 2850 2325 4575 2325
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 5550 2325 7200 2325
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 8175 2325 9000 2325
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 7200 2550 5550 2550
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 4575 2550 2850 2550
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 1875 2550 1200 2550
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 2250 2100 3525 1275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 5100 2100 4050 1275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 7725 2100 4125 1275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 7725 2775 7125 4050
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 7650 4275 8700 4275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 8700 4425 7650 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 9675 4275 10275 4275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 6675 4500 6075 4500
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 1275 3375 2250 3375 2250 3825 1275 3825 1275 3375
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 3000 3375 3975 3375 3975 3825 3000 3825 3000 3375
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 2325 2775 1725 3375
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 2250 3600 3000 3600
+2 4 0 1 0 7 0 0 -1 0.000 0 0 7 0 0 5
+ 11250 4725 11250 4050 10275 4050 10275 4725 11250 4725
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 11250 4275 11850 4275
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 10275 4425 9675 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 1725 3825 1725 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 3450 3825 3450 4425
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 3975 4650 4500 4650
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 5475 4650 5775 4650
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 4500 4875 3975 4875
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 2250 4650 2550 4650
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 1275 4875 900 4875
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 975 5625 2550 5625 2550 5850 975 5850 975 5625
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 4200 5625 5775 5625 5775 5850 4200 5850 4200 5625
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 6450 5250 8025 5250 8025 5475 6450 5475 6450 5250
+2 2 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 5
+ 10125 5250 11700 5250 11700 5475 10125 5475 10125 5250
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 1725 5100 1725 5625
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 4875 5100 4875 5625
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 7050 4725 7050 5250
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 10650 4725 10650 5250
+2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 3000 4875 2625 4875
+4 0 0 0 0 0 16 0.0000 4 150 420 3000 2250 next\001
+4 0 0 0 0 0 16 0.0000 4 180 450 3975 2775 prev\001
+4 0 0 0 0 0 16 0.0000 4 210 630 5100 2025 parent\001
+4 0 0 0 0 14 15 0.0000 4 135 945 7200 2475 ELEMENT\001
+4 0 0 0 0 14 15 0.0000 4 135 945 4575 2475 ELEMENT\001
+4 0 0 0 0 14 15 0.0000 4 135 945 1875 2475 ELEMENT\001
+4 0 0 0 0 14 16 0.0000 4 135 450 8775 4590 REF\001
+4 0 0 0 0 14 16 0.0000 4 135 900 8775 4350 ENTITY\001
+4 0 0 0 0 14 16 0.0000 4 135 600 10350 4425 TEXT\001
+4 0 0 0 0 14 16 0.0000 4 135 600 6750 4425 TEXT\001
+4 0 0 0 0 14 16 0.0000 4 150 1050 1275 2025 xmlNode\001
+4 0 0 0 0 14 16 0.0000 4 150 900 2175 675 xmlDoc\001
+4 0 0 0 0 14 16 0.0000 4 150 1050 675 3300 xmlAttr\001
+4 0 0 0 0 14 16 0.0000 4 135 1200 3225 825 DOCUMENT\001
+4 0 0 0 0 0 16 0.0000 4 150 390 3375 1650 root\001
+4 0 0 0 0 -1 20 0.0000 4 285 4770 5175 825 A DOM tree as built by the XML parser\001
+4 0 0 0 0 -1 20 0.0000 4 180 465 1050 6150 text\001
+4 0 0 0 0 -1 16 0.0000 4 225 990 2250 3000 properties\001
+4 0 0 0 0 -1 16 0.0000 4 150 720 1800 5475 content\001
diff --git a/doc/structure.gif b/doc/structure.gif
new file mode 100644
index 0000000..6711480
--- /dev/null
+++ b/doc/structure.gif
Binary files differ
diff --git a/doc/xml.html b/doc/xml.html
new file mode 100644
index 0000000..d0f57a4
--- /dev/null
+++ b/doc/xml.html
@@ -0,0 +1,78 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
+ "http://www.w3.org/TR/REC-html40/loose.dtd">
+<html>
+<head>
+<title>No title</title>
+<meta name="GENERATOR" content="amaya V1.3b">
+</head>
+<body bgcolor="#ffffff">
+
+<h1 align="center">The XML library for Gnome</h1>
+<p>
+This document describes the <a href="http://www.w3.org/XML/">XML</a> library
+provideed in the <a href="http://www.gnome.org/">Gnome</a> framework. XML is a
+standard to build tag based structured documents. The internal document
+repesentation is as close as possible to the <a
+href="http://www.w3.org/DOM/">DOM</a> interfaces.</p>
+
+<h2>xml</h2>
+<p>
+XML is a standard for markup based structured documents, here is an
+example:</p>
+<pre><?xml version="1.0"?>
+<EXAMPLE prop1="gnome is great" prop2="&linux; too">
+ <head>
+ <title>Welcome to Gnome</title>
+ </head>
+ <chapter>
+ <title>The Linux adventure</title>
+ <p>bla bla bla ...</p>
+ <image href="linus.gif"/>
+ <p>...</p>
+ </chapter>
+</EXAMPLE></pre>
+<p>
+ </p>
+
+<h2>Invoking the parser</h2>
+
+<h2>The tree output</h2>
+<p>
+The parser returns a tree built during the document analysis. The value
+returned is an <strong>xmlDocPtr</strong> (i.e. a pointer to an
+<strong>xmlDoc</strong> structure). This structure contains informations like
+the file name, the document type, and a <strong>root</strong> pointer which
+is the root of the document (or more exactly the first child under the root
+which is the document). The tree is made of <strong>xmlNode</strong>s, chained
+in double linked lists of siblings and with childs<->parent relationship.
+An xmlNode can also carry properties (a chain of xmlAttr structures). An
+attribute may have a value which is a list of TEXT or ENTITY_REF nodes.</p>
+<p>
+Here is an example (erroneous w.r.t. the XML spec since there should be only
+one ELEMENT under the root):</p>
+<p>
+<img src="structure.gif" alt=" structure.gif "></p>
+<p>
+</p>
+
+<h2>Modifying the tree</h2>
+
+<h2>Saving a tree</h2>
+
+<h2>DOM interfaces</h2>
+<p>
+<a href="http://www.w3.org/DOM/">DOM</a> stands for the <em>Document Object
+Model</em> this is an API for accessing XML or HTML structured documents.
+Native support for DOM in Gnome is on the way (module gnome-dom), and it will
+be based on gnome-xml. DOM defiles a set of IDL (or Java) interfaces allowing
+to traverse and manipulate a document. The DOM library will allow accessing
+and modifying "live" documents presents on other programs like this:</p>
+<p>
+<img src="DOM.gif" alt=" DOM.gif "></p>
+<p>
+This should help greatly doing things like modifying a gnumeric spreadsheet
+embedded in a GWP document for example.</p>
+<p>
+</p>
+</body>
+</html>
