Blame - doc/tree.html - platform/external/libxml2

blob: a730a2e83e0a9fbcc9f8002c37dc2cc4f1154879 [file] [log] [blame]

Daniel Veillard	43d3f61	2001-11-10 11:57:23 +0000	[diff] [blame]	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	2	<html>
				3	<head>
				4	<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
				5	<style type="text/css"><!--
Daniel Veillard	2c748c6	2002-01-16 15:37:50 +0000	[diff] [blame]	6	TD {font-size: 14pt; font-family: Verdana,Arial,Helvetica}
				7	BODY {font-size: 14pt; font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
				8	H1 {font-size: 20pt; font-family: Verdana,Arial,Helvetica}
				9	H2 {font-size: 18pt; font-family: Verdana,Arial,Helvetica}
				10	H3 {font-size: 16pt; font-family: Verdana,Arial,Helvetica}
Daniel Veillard	b8cfbd1	2001-10-25 10:53:28 +0000	[diff] [blame]	11	A:link, A:visited, A:active { text-decoration: underline }
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	12	--></style>
				13	<title>The tree output</title>
				14	</head>
				15	<body bgcolor="#8b7765" text="#000000" link="#000000" vlink="#000000">
				16	<table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr>
				17	<td width="180">
				18	<a href="http://www.gnome.org/"><img src="smallfootonly.gif" alt="Gnome Logo"></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo"></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo"></a>
				19	</td>
				20	<td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center">
				21	<h1>The XML C library for Gnome</h1>
				22	<h2>The tree output</h2>
				23	</td></tr></table></td></tr></table></td>
				24	</tr></table>
				25	<table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr>
Daniel Veillard	594cf0b	2001-10-25 08:09:12 +0000	[diff] [blame]	26	<td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td>
				27	<table width="100%" border="0" cellspacing="1" cellpadding="3">
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	28	<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr>
Daniel Veillard	8acca11	2002-01-21 09:52:27 +0000	[diff] [blame]	29	<tr><td bgcolor="#fffacd"><ul>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	30	<li><a href="index.html">Home</a></li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	31	<li><a href="intro.html">Introduction</a></li>
Daniel Veillard	b8cfbd1	2001-10-25 10:53:28 +0000	[diff] [blame]	32	<li><a href="FAQ.html">FAQ</a></li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	33	<li><a href="docs.html">Documentation</a></li>
				34	<li><a href="bugs.html">Reporting bugs and getting help</a></li>
				35	<li><a href="help.html">How to help</a></li>
				36	<li><a href="downloads.html">Downloads</a></li>
				37	<li><a href="news.html">News</a></li>
Daniel Veillard	7b602b4	2002-01-08 13:26:00 +0000	[diff] [blame]	38	<li><a href="XMLinfo.html">XML</a></li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	39	<li><a href="XSLT.html">XSLT</a></li>
Daniel Veillard	b8cfbd1	2001-10-25 10:53:28 +0000	[diff] [blame]	40	<li><a href="architecture.html">libxml architecture</a></li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	41	<li><a href="tree.html">The tree output</a></li>
				42	<li><a href="interface.html">The SAX interface</a></li>
Daniel Veillard	b8cfbd1	2001-10-25 10:53:28 +0000	[diff] [blame]	43	<li><a href="xmldtd.html">Validation & DTDs</a></li>
				44	<li><a href="xmlmem.html">Memory Management</a></li>
				45	<li><a href="encoding.html">Encodings support</a></li>
				46	<li><a href="xmlio.html">I/O Interfaces</a></li>
				47	<li><a href="catalog.html">Catalog support</a></li>
				48	<li><a href="library.html">The parser interfaces</a></li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	49	<li><a href="entities.html">Entities or no entities</a></li>
				50	<li><a href="namespaces.html">Namespaces</a></li>
Daniel Veillard	b8cfbd1	2001-10-25 10:53:28 +0000	[diff] [blame]	51	<li><a href="upgrade.html">Upgrading 1.x code</a></li>
Daniel Veillard	52dcab3	2001-10-30 12:51:17 +0000	[diff] [blame]	52	<li><a href="threads.html">Thread safety</a></li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	53	<li><a href="DOM.html">DOM Principles</a></li>
				54	<li><a href="example.html">A real example</a></li>
				55	<li><a href="contribs.html">Contributions</a></li>
Daniel Veillard	594cf0b	2001-10-25 08:09:12 +0000	[diff] [blame]	56	<li>
				57	<a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a>
				58	</li>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	59	</ul></td></tr>
Daniel Veillard	594cf0b	2001-10-25 08:09:12 +0000	[diff] [blame]	60	</table>
				61	<table width="100%" border="0" cellspacing="1" cellpadding="3">
				62	<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr>
Daniel Veillard	8acca11	2002-01-21 09:52:27 +0000	[diff] [blame]	63	<tr><td bgcolor="#fffacd"><ul>
Daniel Veillard	594cf0b	2001-10-25 08:09:12 +0000	[diff] [blame]	64	<li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li>
				65	<li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li>
Daniel Veillard	4a85920	2002-01-08 11:49:22 +0000	[diff] [blame]	66	<li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li>
Daniel Veillard	594cf0b	2001-10-25 08:09:12 +0000	[diff] [blame]	67	<li><a href="ftp://xmlsoft.org/">FTP</a></li>
				68	<li><a href="http://www.fh-frankfurt.de/~igor/projects/libxml/">Windows binaries</a></li>
Daniel Veillard	db9dfd9	2001-11-26 17:25:02 +0000	[diff] [blame]	69	<li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
Daniel Veillard	c6271d2	2001-10-27 07:50:58 +0000	[diff] [blame]	70	<li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml">Bug Tracker</a></li>
Daniel Veillard	594cf0b	2001-10-25 08:09:12 +0000	[diff] [blame]	71	</ul></td></tr>
				72	</table>
				73	</td></tr></table></td>
Daniel Veillard	c948420	2001-10-24 12:35:52 +0000	[diff] [blame]	74	<td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd">
				75	<p>The parser returns a tree built during the document analysis. The value
				76	returned is an <strong>xmlDocPtr</strong> (i.e., a pointer to an
				77	<strong>xmlDoc</strong> structure). This structure contains information such
				78	as the file name, the document type, and a <strong>children</strong> pointer
				79	which is the root of the document (or more exactly the first child under the
				80	root which is the document). The tree is made of <strong>xmlNode</strong>s,
				81	chained in double-linked lists of siblings and with a children<->parent
				82	relationship. An xmlNode can also carry properties (a chain of xmlAttr
				83	structures). An attribute may have a value which is a list of TEXT or
				84	ENTITY_REF nodes.</p>
				85	<p>Here is an example (erroneous with respect to the XML spec since there
				86	should be only one ELEMENT under the root):</p>
				87	<p><img src="structure.gif" alt=" structure.gif "></p>
				88	<p>In the source package there is a small program (not installed by default)
				89	called <strong>xmllint</strong> which parses XML files given as argument and
				90	prints them back as parsed. This is useful for detecting errors both in XML
				91	code and in the XML parser itself. It has an option <strong>--debug</strong>
				92	which prints the actual in-memory structure of the document; here is the
				93	result with the <a href="#example">example</a> given before:</p>
				94	<pre>DOCUMENT
				95	version=1.0
				96	standalone=true
				97	ELEMENT EXAMPLE
				98	ATTRIBUTE prop1
				99	TEXT
				100	content=gnome is great
				101	ATTRIBUTE prop2
				102	ENTITY_REF
				103	TEXT
				104	content= linux too
				105	ELEMENT head
				106	ELEMENT title
				107	TEXT
				108	content=Welcome to Gnome
				109	ELEMENT chapter
				110	ELEMENT title
				111	TEXT
				112	content=The Linux adventure
				113	ELEMENT p
				114	TEXT
				115	content=bla bla bla ...
				116	ELEMENT image
				117	ATTRIBUTE href
				118	TEXT
				119	content=linus.gif
				120	ELEMENT p
				121	TEXT
				122	content=...</pre>
				123	<p>This should be useful for learning the internal representation model.</p>
				124	<p><a href="mailto:daniel@veillard.com">Daniel Veillard</a></p>
				125	</td></tr></table></td></tr></table></td></tr></table></td>
				126	</tr></table></td></tr></table>
				127	</body>
				128	</html>