docs/manual/html/chapter-introduction.html

   1 <html>
   2 <head>
   3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   4 <title>Chapter 1. libxml++</title>
   5 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
   6 <link rel="home" href="index.html" title="libxml++ - An XML Parser for C++">
   7 <link rel="up" href="index.html" title="libxml++ - An XML Parser for C++">
   8 <link rel="prev" href="index.html" title="libxml++ - An XML Parser for C++">
   9 <link rel="next" href="ch01s02.html" title="UTF-8 and Glib::ustring">
  10 </head>
  11 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  12 <div class="navheader">
  13 <table width="100%" summary="Navigation header">
  14 <tr><th colspan="3" align="center">Chapter 1. libxml++</th></tr>
  15 <tr>
  16 <td width="20%" align="left">
  17 <a accesskey="p" href="index.html">Prev</a> </td>
  18 <th width="60%" align="center"> </th>
  19 <td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a>
  20 </td>
  21 </tr>
  22 </table>
  23 <hr>
  24 </div>
  25 <div class="chapter">
  26 <div class="titlepage"><div><div><h1 class="title">
  27 <a name="chapter-introduction"></a>Chapter 1. libxml++</h1></div></div></div>
  28 <div class="toc">
  29 <p><b>Table of Contents</b></p>
  30 <ul class="toc">
  31 <li><span class="sect1"><a href="chapter-introduction.html#idp84449760">Installation</a></span></li>
  32 <li><span class="sect1"><a href="ch01s02.html">UTF-8 and Glib::ustring</a></span></li>
  33 <li><span class="sect1"><a href="ch01s03.html">Compilation and Linking</a></span></li>
  34 </ul>
  35 </div>
  36 <p>
  37       libxml++ is a C++ API for the popular <a class="ulink" href="http://www.xmlsoft.org" target="_top">libxml2</a> XML parser, written in C.
  38       libxml2 is famous for its high performance and compliance to standard specifications, but its C API is quite difficult even for common tasks.
  39     </p>
  40 <p>
  41       libxml++ presents a simple C++-like API that can achieve common tasks with less code.
  42       Unlike some other C++ parsers, it does not try to avoid the advantages of standard C++ features
  43       such as namespaces, STL containers or runtime type identification, and it does not try
  44       to conform to standard API specifications meant for Java. Therefore libxml++ requires
  45       a fairly modern C++ compiler such as g++ 4.9 or g++ 5. libxml++ 2.39.1 and later require
  46       a C++11-compliant compiler.
  47     </p>
  48 <p>But libxml++ was created mainly to fill the need for an API-stable and ABI-stable C++ XML parser which could be used as a shared library dependency by C++ applications that are distributed widely in binary form. That means that installed applications will not break when new versions of libxml++ are installed on a user's computer. Gradual improvement of the libxml++ API is still possible via non-breaking API additions, and new independent versions of the ABI that can be installed in parallel with older versions. These are the general techniques and principles followed by the <a class="ulink" href="http://www.gnome.org" target="_top">GNOME</a> project, of which libxml++ is a part.</p>
  49 <div class="sect1">
  50 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  51 <a name="idp84449760"></a>Installation</h2></div></div></div>
  52 <p>libxml++ is packaged by major Linux and *BSD distributions and can be installed from source on Linux and Windows, using any modern compiler, such as g++, SUN Forte, or MSVC++.</p>
  53 <p>For instance, to install libxml++ and its documentation on debian, use apt-get or synaptic like so:
  54     </p>
  55 <pre class="programlisting">
  56     # apt-get install libxml++3.0-dev libxml++3.0-doc
  57     </pre>
  58 <p>
  59     </p>
  60 <p>To check that you have the libxml++ development packages installed, and that your environment is working properly, try <span class="command"><strong>pkg-config libxml++-3.0 --modversion</strong></span>.</p>
  61 <p>Links for downloading and more documentation can be found at <a class="ulink" href="http://libxmlplusplus.sourceforge.net" target="_top">libxmlplusplus.sourceforge.net</a>.
  62     libxml++ is licensed under the LGPL, which allows its use via dynamic linking in both open source and closed-source software. The underlying libxml2 library uses the even more generous MIT licence.</p>
  63 </div>
  64 </div>
  65 <div class="navfooter">
  66 <hr>
  67 <table width="100%" summary="Navigation footer">
  68 <tr>
  69 <td width="40%" align="left">
  70 <a accesskey="p" href="index.html">Prev</a> </td>
  71 <td width="20%" align="center"> </td>
  72 <td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a>
  73 </td>
  74 </tr>
  75 <tr>
  76 <td width="40%" align="left" valign="top">libxml++ - An XML Parser for C++ </td>
  77 <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  78 <td width="40%" align="right" valign="top"> UTF-8 and Glib::ustring</td>
  79 </tr>
  80 </table>
  81 </div>
  82 </body>
  83 </html>