rolled back to 2.9.1 because 2.9.2 doesn't work with connecting net
[platform/upstream/libxml2.git] / doc / index.html
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml">
4   <head>
5     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6     <link rel="SHORTCUT ICON" href="/favicon.ico" />
7     <style type="text/css">
8 TD {font-family: Verdana,Arial,Helvetica}
9 BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
10 H1 {font-family: Verdana,Arial,Helvetica}
11 H2 {font-family: Verdana,Arial,Helvetica}
12 H3 {font-family: Verdana,Arial,Helvetica}
13 A:link, A:visited, A:active { text-decoration: underline }
14 </style>
15     <title>The XML C parser and toolkit of Gnome</title>
16   </head>
17   <body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000">
18     <table border="0" width="100%" cellpadding="5" cellspacing="0" align="center">
19       <tr>
20         <td width="120">
21           <a href="http://swpat.ffii.org/">
22             <img src="epatents.png" alt="Action against software patents" />
23           </a>
24         </td>
25         <td width="180">
26           <a href="http://www.gnome.org/">
27             <img src="gnome2.png" alt="Gnome2 Logo" />
28           </a>
29           <a href="http://www.w3.org/Status">
30             <img src="w3c.png" alt="W3C Logo" />
31           </a>
32           <a href="http://www.redhat.com/">
33             <img src="redhat.gif" alt="Red Hat Logo" />
34           </a>
35           <div align="left">
36             <a href="http://xmlsoft.org/">
37               <img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" />
38             </a>
39           </div>
40         </td>
41         <td>
42           <table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000">
43             <tr>
44               <td>
45                 <table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd">
46                   <tr>
47                     <td align="center">
48                       <h1>The XML C parser and toolkit of Gnome</h1>
49                       <h2>libxml</h2>
50                     </td>
51                   </tr>
52                 </table>
53               </td>
54             </tr>
55           </table>
56         </td>
57       </tr>
58     </table>
59     <table border="0" cellpadding="4" cellspacing="0" width="100%" align="center">
60       <tr>
61         <td bgcolor="#8b7765">
62           <table border="0" cellspacing="0" cellpadding="2" width="100%">
63             <tr>
64               <td valign="top" width="200" bgcolor="#8b7765">
65                 <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
66                   <tr>
67                     <td>
68                       <table width="100%" border="0" cellspacing="1" cellpadding="3">
69                         <tr>
70                           <td colspan="1" bgcolor="#eecfa1" align="center">
71                             <center>
72                               <b>Main Menu</b>
73                             </center>
74                           </td>
75                         </tr>
76                         <tr>
77                           <td bgcolor="#fffacd">
78                             <form action="search.php" enctype="application/x-www-form-urlencoded" method="get">
79                               <input name="query" type="text" size="20" value="" />
80                               <input name="submit" type="submit" value="Search ..." />
81                             </form>
82                             <ul>
83                               <li>
84                                 <a href="index.html">Home</a>
85                               </li>
86                               <li>
87                                 <a href="html/index.html">Reference Manual</a>
88                               </li>
89                               <li>
90                                 <a href="intro.html">Introduction</a>
91                               </li>
92                               <li>
93                                 <a href="FAQ.html">FAQ</a>
94                               </li>
95                               <li>
96                                 <a href="docs.html" style="font-weight:bold">Developer Menu</a>
97                               </li>
98                               <li>
99                                 <a href="bugs.html">Reporting bugs and getting help</a>
100                               </li>
101                               <li>
102                                 <a href="help.html">How to help</a>
103                               </li>
104                               <li>
105                                 <a href="downloads.html">Downloads</a>
106                               </li>
107                               <li>
108                                 <a href="news.html">Releases</a>
109                               </li>
110                               <li>
111                                 <a href="XMLinfo.html">XML</a>
112                               </li>
113                               <li>
114                                 <a href="XSLT.html">XSLT</a>
115                               </li>
116                               <li>
117                                 <a href="xmldtd.html">Validation &amp; DTDs</a>
118                               </li>
119                               <li>
120                                 <a href="encoding.html">Encodings support</a>
121                               </li>
122                               <li>
123                                 <a href="catalog.html">Catalog support</a>
124                               </li>
125                               <li>
126                                 <a href="namespaces.html">Namespaces</a>
127                               </li>
128                               <li>
129                                 <a href="contribs.html">Contributions</a>
130                               </li>
131                               <li>
132                                 <a href="examples/index.html" style="font-weight:bold">Code Examples</a>
133                               </li>
134                               <li>
135                                 <a href="html/index.html" style="font-weight:bold">API Menu</a>
136                               </li>
137                               <li>
138                                 <a href="guidelines.html">XML Guidelines</a>
139                               </li>
140                               <li>
141                                 <a href="ChangeLog.html">Recent Changes</a>
142                               </li>
143                             </ul>
144                           </td>
145                         </tr>
146                       </table>
147                       <table width="100%" border="0" cellspacing="1" cellpadding="3">
148                         <tr>
149                           <td colspan="1" bgcolor="#eecfa1" align="center">
150                             <center>
151                               <b>Related links</b>
152                             </center>
153                           </td>
154                         </tr>
155                         <tr>
156                           <td bgcolor="#fffacd">
157                             <ul>
158                               <li>
159                                 <a href="http://mail.gnome.org/archives/xml/">Mail archive</a>
160                               </li>
161                               <li>
162                                 <a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a>
163                               </li>
164                               <li>
165                                 <a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a>
166                               </li>
167                               <li>
168                                 <a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a>
169                               </li>
170                               <li>
171                                 <a href="ftp://xmlsoft.org/">FTP</a>
172                               </li>
173                               <li>
174                                 <a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a>
175                               </li>
176                               <li>
177                                 <a href="http://opencsw.org/packages/libxml2">Solaris binaries</a>
178                               </li>
179                               <li>
180                                 <a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a>
181                               </li>
182                               <li>
183                                 <a href="http://lxml.de/">lxml Python bindings</a>
184                               </li>
185                               <li>
186                                 <a href="http://cpan.uwinnipeg.ca/dist/XML-LibXML">Perl bindings</a>
187                               </li>
188                               <li>
189                                 <a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a>
190                               </li>
191                               <li>
192                                 <a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a>
193                               </li>
194                               <li>
195                                 <a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a>
196                               </li>
197                               <li>
198                                 <a href="http://libxml.rubyforge.org/">Ruby bindings</a>
199                               </li>
200                               <li>
201                                 <a href="http://tclxml.sourceforge.net/">Tcl bindings</a>
202                               </li>
203                               <li>
204                                 <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a>
205                               </li>
206                             </ul>
207                           </td>
208                         </tr>
209                       </table>
210                     </td>
211                   </tr>
212                 </table>
213               </td>
214               <td valign="top" bgcolor="#8b7765">
215                 <table border="0" cellspacing="0" cellpadding="1" width="100%">
216                   <tr>
217                     <td>
218                       <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
219                         <tr>
220                           <td>
221                             <table border="0" cellpadding="3" cellspacing="1" width="100%">
222                               <tr>
223                                 <td bgcolor="#fffacd">
224                                   <p></p>
225                                   <p style="text-align: right; font-style: italic; font-size: 10pt">"Programming
226 with libxml2 is like the thrilling embrace of an exotic stranger." <a href="http://diveintomark.org/archives/2004/02/18/libxml2">Mark
227 Pilgrim</a></p>
228                                   <p>Libxml2 is the XML C parser and toolkit developed for the Gnome project
229 (but usable outside of the Gnome platform), it is free software available
230 under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
231 License</a>. XML itself is a metalanguage to design markup languages, i.e.
232 text language where semantic and structure are added to the content using
233 extra "markup" information enclosed between angle brackets. HTML is the most
234 well-known markup language. Though the library is written in C <a href="python.html">a variety of language bindings</a> make it available in
235 other environments.</p>
236                                   <p>Libxml2 is known to be very portable, the library should build and work
237 without serious troubles on a variety of systems (Linux, Unix, Windows,
238 CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, VxWorks, ...)</p>
239                                   <p>Libxml2 implements a number of existing standards related to markup
240 languages:</p>
241                                   <ul><li>the XML standard: <a href="http://www.w3.org/TR/REC-xml">http://www.w3.org/TR/REC-xml</a></li>
242   <li>Namespaces in XML: <a href="http://www.w3.org/TR/REC-xml-names/">http://www.w3.org/TR/REC-xml-names/</a></li>
243   <li>XML Base: <a href="http://www.w3.org/TR/xmlbase/">http://www.w3.org/TR/xmlbase/</a></li>
244   <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC 2396</a> :
245     Uniform Resource Identifiers <a href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</a></li>
246   <li>XML Path Language (XPath) 1.0: <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a></li>
247   <li>HTML4 parser: <a href="http://www.w3.org/TR/html401/">http://www.w3.org/TR/html401/</a></li>
248   <li>XML Pointer Language (XPointer) Version 1.0: <a href="http://www.w3.org/TR/xptr">http://www.w3.org/TR/xptr</a></li>
249   <li>XML Inclusions (XInclude) Version 1.0: <a href="http://www.w3.org/TR/xinclude/">http://www.w3.org/TR/xinclude/</a></li>
250   <li>ISO-8859-x encodings, as well as <a href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a> [UTF-8]
251     and <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>
252     [UTF-16] Unicode encodings, and more if using iconv support</li>
253   <li>part of SGML Open Technical Resolution TR9401:1997</li>
254   <li>XML Catalogs Working Draft 06 August 2001: <a href="http://www.oasis-open.org/committees/entity/spec-2001-08-06.html">http://www.oasis-open.org/committees/entity/spec-2001-08-06.html</a></li>
255   <li>Canonical XML Version 1.0: <a href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>
256     and the Exclusive XML Canonicalization CR draft <a href="http://www.w3.org/TR/xml-exc-c14n">http://www.w3.org/TR/xml-exc-c14n</a></li>
257   <li>Relax NG, ISO/IEC 19757-2:2003, <a href="http://www.oasis-open.org/committees/relax-ng/spec-20011203.html">http://www.oasis-open.org/committees/relax-ng/spec-20011203.html</a></li>
258   <li>W3C XML Schemas Part 2: Datatypes <a href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02 May
259     2001</a></li>
260   <li>W3C <a href="http://www.w3.org/TR/xml-id/">xml:id</a> Working Draft 7
261     April 2004</li>
262 </ul>
263                                   <p>In most cases libxml2 tries to implement the specifications in a
264 relatively strictly compliant way. As of release 2.4.16, libxml2 passed all
265 1800+ tests from the <a href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML Tests
266 Suite</a>.</p>
267                                   <p>To some extent libxml2 provides support for the following additional
268 specifications but doesn't claim to implement them completely:</p>
269                                   <ul><li>Document Object Model (DOM) <a href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>
270     the document model, but it doesn't implement the API itself, gdome2 does
271     this on top of libxml2</li>
272   <li><a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC 959</a> :
273     libxml2 implements a basic FTP client code</li>
274   <li><a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC 1945</a> :
275     HTTP/1.0, again a basic HTTP client code</li>
276   <li>SAX: a SAX2 like interface and a minimal SAX1 implementation compatible
277     with early expat versions</li>
278 </ul>
279                                   <p>A partial implementation of <a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part
280 1: Structure</a> is being worked on but it would be far too early to make any
281 conformance statement about it at the moment.</p>
282                                   <p>Separate documents:</p>
283                                   <ul><li><a href="http://xmlsoft.org/XSLT/">the libxslt page</a> providing an
284     implementation of XSLT 1.0 and common extensions like EXSLT for
285   libxml2</li>
286   <li><a href="http://gdome2.cs.unibo.it/">the gdome2 page</a>
287     : a standard DOM2 implementation for libxml2</li>
288   <li><a href="http://www.aleksey.com/xmlsec/">the XMLSec page</a>: an
289     implementation of <a href="http://www.w3.org/TR/xmldsig-core/">W3C XML
290     Digital Signature</a> for libxml2</li>
291   <li>also check the related links section for more related and active
292     projects.</li>
293 </ul>
294                                   <p> Hosting sponsored by <a href="http://www.aoemedia.de/opensource-cms.html">Open Source CMS services</a> from AOE media.</p>
295                                   <p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p>
296                                   <p>
297                                     <a href="bugs.html">Daniel Veillard</a>
298                                   </p>
299                                 </td>
300                               </tr>
301                             </table>
302                           </td>
303                         </tr>
304                       </table>
305                     </td>
306                   </tr>
307                 </table>
308               </td>
309             </tr>
310           </table>
311         </td>
312       </tr>
313     </table>
314   </body>
315 </html>