Home | History | Annotate | Download | only in devhelp
      1 <?xml version="1.0"?>
      2 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
      3 		xmlns:exsl="http://exslt.org/common"
      4 		xmlns:str="http://exslt.org/strings"
      5 		extension-element-prefixes="exsl str"
      6 		exclude-result-prefixes="exsl str">
      7   <xsl:output method="xml" encoding="UTF-8" indent="yes"/>
      8 
      9   <!-- This is convoluted but needed to force the current document to
     10        be the API one and not the result tree from the tokenize() result,
     11        because the keys are only defined on the main document -->
     12   <xsl:template mode="dumptoken" match='*'>
     13     <xsl:param name="token"/>
     14     <xsl:variable name="ref" select="key('symbols', $token)"/>
     15     <xsl:choose>
     16       <xsl:when test="$ref">
     17         <a href="libxml2-{$ref/@file}.html#{$ref/@name}"><xsl:value-of select="$token"/></a>
     18       </xsl:when>
     19       <xsl:otherwise>
     20         <xsl:value-of select="$token"/>
     21       </xsl:otherwise>
     22     </xsl:choose>
     23   </xsl:template>
     24 
     25   <!-- dumps a string, making cross-reference links -->
     26   <xsl:template name="dumptext">
     27     <xsl:param name="text"/>
     28     <xsl:variable name="ctxt" select='.'/>
     29     <!-- <xsl:value-of select="$text"/> -->
     30     <xsl:for-each select="str:tokenize($text, ' &#9;')">
     31       <xsl:apply-templates select="$ctxt" mode='dumptoken'>
     32         <xsl:with-param name="token" select="string(.)"/>
     33       </xsl:apply-templates>
     34       <xsl:if test="position() != last()">
     35         <xsl:text> </xsl:text>
     36       </xsl:if>
     37     </xsl:for-each>
     38   </xsl:template>
     39 
     40 <!--
     41 
     42              The following builds the Synopsis section
     43 
     44 -->
     45   <xsl:template mode="synopsis" match="function">
     46     <xsl:variable name="name" select="string(@name)"/>
     47     <xsl:variable name="nlen" select="string-length($name)"/>
     48     <xsl:variable name="tlen" select="string-length(return/@type)"/>
     49     <xsl:variable name="blen" select="(($nlen + 8) - (($nlen + 8) mod 8)) + (($tlen + 8) - (($tlen + 8) mod 8))"/>
     50     <xsl:call-template name="dumptext">
     51       <xsl:with-param name="text" select="return/@type"/>
     52     </xsl:call-template>
     53     <xsl:text>&#9;</xsl:text>
     54     <a href="#{@name}"><xsl:value-of select="@name"/></a>
     55     <xsl:if test="$blen - 40 &lt; -8">
     56       <xsl:text>&#9;</xsl:text>
     57     </xsl:if>
     58     <xsl:if test="$blen - 40 &lt; 0">
     59       <xsl:text>&#9;</xsl:text>
     60     </xsl:if>
     61     <xsl:text>&#9;(</xsl:text>
     62     <xsl:if test="not(arg)">
     63       <xsl:text>void</xsl:text>
     64     </xsl:if>
     65     <xsl:for-each select="arg">
     66       <xsl:call-template name="dumptext">
     67         <xsl:with-param name="text" select="@type"/>
     68       </xsl:call-template>
     69       <xsl:text> </xsl:text>
     70       <xsl:value-of select="@name"/>
     71       <xsl:if test="position() != last()">
     72         <xsl:text>, </xsl:text><br/>
     73 	<xsl:if test="$blen - 40 &gt; 8">
     74 	  <xsl:text>&#9;</xsl:text>
     75 	</xsl:if>
     76 	<xsl:if test="$blen - 40 &gt; 0">
     77 	  <xsl:text>&#9;</xsl:text>
     78 	</xsl:if>
     79 	<xsl:text>&#9;&#9;&#9;&#9;&#9; </xsl:text>
     80       </xsl:if>
     81     </xsl:for-each>
     82     <xsl:text>);</xsl:text>
     83     <xsl:text>
     84 </xsl:text>
     85   </xsl:template>
     86 
     87   <xsl:template mode="synopsis" match="functype">
     88     <xsl:variable name="name" select="string(@name)"/>
     89     <xsl:variable name="nlen" select="string-length($name)"/>
     90     <xsl:variable name="tlen" select="string-length(return/@type)"/>
     91     <xsl:variable name="blen" select="(($nlen + 8) - (($nlen + 8) mod 8)) + (($tlen + 8) - (($tlen + 8) mod 8))"/>
     92     <xsl:text>typedef </xsl:text>
     93     <xsl:call-template name="dumptext">
     94       <xsl:with-param name="text" select="return/@type"/>
     95     </xsl:call-template>
     96     <xsl:text> </xsl:text>
     97     <a href="#{@name}"><xsl:value-of select="@name"/></a>
     98     <xsl:if test="$blen - 40 &lt; -8">
     99       <xsl:text>&#9;</xsl:text>
    100     </xsl:if>
    101     <xsl:if test="$blen - 40 &lt; 0">
    102       <xsl:text>&#9;</xsl:text>
    103     </xsl:if>
    104     <xsl:text>&#9;(</xsl:text>
    105     <xsl:if test="not(arg)">
    106       <xsl:text>void</xsl:text>
    107     </xsl:if>
    108     <xsl:for-each select="arg">
    109       <xsl:call-template name="dumptext">
    110         <xsl:with-param name="text" select="@type"/>
    111       </xsl:call-template>
    112       <xsl:text> </xsl:text>
    113       <xsl:value-of select="@name"/>
    114       <xsl:if test="position() != last()">
    115         <xsl:text>, </xsl:text><br/>
    116 	<xsl:if test="$blen - 40 &gt; 8">
    117 	  <xsl:text>&#9;</xsl:text>
    118 	</xsl:if>
    119 	<xsl:if test="$blen - 40 &gt; 0">
    120 	  <xsl:text>&#9;</xsl:text>
    121 	</xsl:if>
    122 	<xsl:text>&#9;&#9;&#9;&#9;&#9; </xsl:text>
    123       </xsl:if>
    124     </xsl:for-each>
    125     <xsl:text>);</xsl:text>
    126     <xsl:text>
    127 </xsl:text>
    128   </xsl:template>
    129 
    130   <xsl:template mode="synopsis" match="exports[@type='function']">
    131     <xsl:variable name="def" select="key('symbols',@symbol)"/>
    132     <xsl:apply-templates mode="synopsis" select="$def"/>
    133   </xsl:template>
    134 
    135   <xsl:template mode="synopsis" match="exports[@type='typedef']">
    136     <xsl:text>typedef </xsl:text>
    137     <xsl:call-template name="dumptext">
    138       <xsl:with-param name="text" select="string(key('symbols',@symbol)/@type)"/>
    139     </xsl:call-template>
    140     <xsl:text> </xsl:text>
    141     <a href="#{@symbol}"><xsl:value-of select="@symbol"/></a>
    142     <xsl:text>;
    143 </xsl:text>
    144   </xsl:template>
    145 
    146   <xsl:template mode="synopsis" match="exports[@type='macro']">
    147     <xsl:variable name="def" select="key('symbols',@symbol)"/>
    148     <xsl:text>#define </xsl:text>
    149     <a href="#{@symbol}"><xsl:value-of select="@symbol"/></a>
    150     <xsl:if test="$def/arg">
    151       <xsl:text>(</xsl:text>
    152       <xsl:for-each select="$def/arg">
    153         <xsl:value-of select="@name"/>
    154 	<xsl:if test="position() != last()">
    155 	  <xsl:text>, </xsl:text>
    156 	</xsl:if>
    157       </xsl:for-each>
    158       <xsl:text>)</xsl:text>
    159     </xsl:if>
    160     <xsl:text>;
    161 </xsl:text>
    162   </xsl:template>
    163   <xsl:template mode="synopsis" match="exports[@type='enum']">
    164   </xsl:template>
    165   <xsl:template mode="synopsis" match="exports[@type='struct']">
    166   </xsl:template>
    167 
    168 <!--
    169 
    170              The following builds the Details section
    171 
    172 -->
    173   <xsl:template mode="details" match="struct">
    174     <xsl:variable name="name" select="string(@name)"/>
    175     <div class="refsect2" lang="en">
    176     <h3><a name="{$name}">Structure </a><xsl:value-of select="$name"/></h3>
    177     <pre class="programlisting">
    178     <xsl:value-of select="@type"/><xsl:text> {
    179 </xsl:text>
    180     <xsl:if test="not(field)">
    181       <xsl:text>The content of this structure is not made public by the API.
    182 </xsl:text>
    183     </xsl:if>
    184     <xsl:for-each select="field">
    185         <xsl:text>    </xsl:text>
    186 	<xsl:call-template name="dumptext">
    187 	  <xsl:with-param name="text" select="@type"/>
    188 	</xsl:call-template>
    189 	<xsl:text>&#9;</xsl:text>
    190 	<xsl:value-of select="@name"/>
    191 	<xsl:if test="@info != ''">
    192 	  <xsl:text>&#9;: </xsl:text>
    193 	  <xsl:call-template name="dumptext">
    194 	    <xsl:with-param name="text" select="substring(@info, 1, 70)"/>
    195 	  </xsl:call-template>
    196 	</xsl:if>
    197 	<xsl:text>
    198 </xsl:text>
    199     </xsl:for-each>
    200     <xsl:text>} </xsl:text>
    201     <xsl:value-of select="$name"/>
    202     <xsl:text>;
    203 </xsl:text>
    204     </pre>
    205     <p>
    206     <xsl:call-template name="dumptext">
    207       <xsl:with-param name="text" select="info"/>
    208     </xsl:call-template>
    209     </p><xsl:text>
    210 </xsl:text>
    211     </div><hr/>
    212   </xsl:template>
    213 
    214   <xsl:template mode="details" match="typedef[@type != 'enum']">
    215     <xsl:variable name="name" select="string(@name)"/>
    216     <div class="refsect2" lang="en">
    217     <h3><a name="{$name}">Typedef </a><xsl:value-of select="$name"/></h3>
    218     <pre class="programlisting">
    219     <xsl:call-template name="dumptext">
    220       <xsl:with-param name="text" select="string(@type)"/>
    221     </xsl:call-template>
    222     <xsl:text> </xsl:text>
    223     <xsl:value-of select="$name"/>
    224     <xsl:text>;
    225 </xsl:text>
    226     </pre>
    227     <p>
    228     <xsl:call-template name="dumptext">
    229       <xsl:with-param name="text" select="info"/>
    230     </xsl:call-template>
    231     </p><xsl:text>
    232 </xsl:text>
    233     </div><hr/>
    234   </xsl:template>
    235 
    236   <xsl:template mode="details" match="variable">
    237     <xsl:variable name="name" select="string(@name)"/>
    238     <div class="refsect2" lang="en">
    239     <h3><a name="{$name}">Variable </a><xsl:value-of select="$name"/></h3>
    240     <pre class="programlisting">
    241     <xsl:call-template name="dumptext">
    242       <xsl:with-param name="text" select="string(@type)"/>
    243     </xsl:call-template>
    244     <xsl:text> </xsl:text>
    245     <xsl:value-of select="$name"/>
    246     <xsl:text>;
    247 </xsl:text>
    248     </pre>
    249     <p>
    250     <xsl:call-template name="dumptext">
    251       <xsl:with-param name="text" select="info"/>
    252     </xsl:call-template>
    253     </p><xsl:text>
    254 </xsl:text>
    255     </div><hr/>
    256   </xsl:template>
    257 
    258   <xsl:template mode="details" match="typedef[@type = 'enum']">
    259     <xsl:variable name="name" select="string(@name)"/>
    260     <div class="refsect2" lang="en">
    261     <h3><a name="{$name}">Enum </a><xsl:value-of select="$name"/></h3>
    262     <pre class="programlisting">
    263     <xsl:text>enum </xsl:text>
    264     <a href="#{$name}"><xsl:value-of select="$name"/></a>
    265     <xsl:text> {
    266 </xsl:text>
    267     <xsl:for-each select="/api/symbols/enum[@type=$name]">
    268       <xsl:sort select="@value" data-type="number" order="ascending"/>
    269       <xsl:text>    </xsl:text>
    270       <a name="{@name}"><xsl:value-of select="@name"/></a>
    271       <xsl:if test="@value">
    272         <xsl:text> = </xsl:text>
    273 	<xsl:value-of select="@value"/>
    274       </xsl:if>
    275       <xsl:if test="@info">
    276         <xsl:text> /* </xsl:text>
    277 	<xsl:value-of select="@info"/>
    278         <xsl:text> */</xsl:text>
    279       </xsl:if>
    280       <xsl:text>
    281 </xsl:text>
    282     </xsl:for-each>
    283     <xsl:text>};
    284 </xsl:text>
    285     </pre>
    286     <p>
    287     <xsl:call-template name="dumptext">
    288       <xsl:with-param name="text" select="info"/>
    289     </xsl:call-template>
    290     </p><xsl:text>
    291 </xsl:text>
    292     </div><hr/>
    293   </xsl:template>
    294 
    295   <xsl:template mode="details" match="macro">
    296     <xsl:variable name="name" select="string(@name)"/>
    297     <div class="refsect2" lang="en">
    298     <h3><a name="{$name}">Macro </a><xsl:value-of select="$name"/></h3>
    299     <pre class="programlisting">
    300     <xsl:text>#define </xsl:text>
    301     <a href="#{$name}"><xsl:value-of select="$name"/></a>
    302     <xsl:if test="arg">
    303       <xsl:text>(</xsl:text>
    304       <xsl:for-each select="arg">
    305         <xsl:value-of select="@name"/>
    306 	<xsl:if test="position() != last()">
    307 	  <xsl:text>, </xsl:text>
    308 	</xsl:if>
    309       </xsl:for-each>
    310       <xsl:text>)</xsl:text>
    311     </xsl:if>
    312     <xsl:text>;
    313 </xsl:text>
    314     </pre>
    315     <p>
    316     <xsl:call-template name="dumptext">
    317       <xsl:with-param name="text" select="info"/>
    318     </xsl:call-template>
    319     </p>
    320     <xsl:if test="arg">
    321       <div class="variablelist"><table border="0"><col align="left"/><tbody>
    322       <xsl:for-each select="arg">
    323         <tr>
    324           <td><span class="term"><i><tt><xsl:value-of select="@name"/></tt></i>:</span></td>
    325 	  <td>
    326 	    <xsl:call-template name="dumptext">
    327 	      <xsl:with-param name="text" select="@info"/>
    328 	    </xsl:call-template>
    329 	  </td>
    330         </tr>
    331       </xsl:for-each>
    332       </tbody></table></div>
    333     </xsl:if>
    334     <xsl:text>
    335 </xsl:text>
    336     </div><hr/>
    337   </xsl:template>
    338 
    339   <xsl:template mode="details" match="function">
    340     <xsl:variable name="name" select="string(@name)"/>
    341     <xsl:variable name="nlen" select="string-length($name)"/>
    342     <xsl:variable name="tlen" select="string-length(return/@type)"/>
    343     <xsl:variable name="blen" select="(($nlen + 8) - (($nlen + 8) mod 8)) + (($tlen + 8) - (($tlen + 8) mod 8))"/>
    344     <div class="refsect2" lang="en">
    345     <h3><a name="{$name}"></a><xsl:value-of select="$name"/> ()</h3>
    346     <pre class="programlisting">
    347     <xsl:call-template name="dumptext">
    348       <xsl:with-param name="text" select="return/@type"/>
    349     </xsl:call-template>
    350     <xsl:text>&#9;</xsl:text>
    351     <xsl:value-of select="@name"/>
    352     <xsl:if test="$blen - 40 &lt; -8">
    353       <xsl:text>&#9;</xsl:text>
    354     </xsl:if>
    355     <xsl:if test="$blen - 40 &lt; 0">
    356       <xsl:text>&#9;</xsl:text>
    357     </xsl:if>
    358     <xsl:text>&#9;(</xsl:text>
    359     <xsl:if test="not(arg)">
    360       <xsl:text>void</xsl:text>
    361     </xsl:if>
    362     <xsl:for-each select="arg">
    363       <xsl:call-template name="dumptext">
    364         <xsl:with-param name="text" select="@type"/>
    365       </xsl:call-template>
    366       <xsl:text> </xsl:text>
    367       <xsl:value-of select="@name"/>
    368       <xsl:if test="position() != last()">
    369         <xsl:text>, </xsl:text><br/>
    370 	<xsl:if test="$blen - 40 &gt; 8">
    371 	  <xsl:text>&#9;</xsl:text>
    372 	</xsl:if>
    373 	<xsl:if test="$blen - 40 &gt; 0">
    374 	  <xsl:text>&#9;</xsl:text>
    375 	</xsl:if>
    376 	<xsl:text>&#9;&#9;&#9;&#9;&#9; </xsl:text>
    377       </xsl:if>
    378     </xsl:for-each>
    379     <xsl:text>)</xsl:text><br/>
    380     <xsl:text>
    381 </xsl:text>
    382     </pre>
    383     <p>
    384     <xsl:call-template name="dumptext">
    385       <xsl:with-param name="text" select="info"/>
    386     </xsl:call-template>
    387     </p><xsl:text>
    388 </xsl:text>
    389     <xsl:if test="arg | return/@info">
    390       <div class="variablelist"><table border="0"><col align="left"/><tbody>
    391       <xsl:for-each select="arg">
    392         <tr>
    393           <td><span class="term"><i><tt><xsl:value-of select="@name"/></tt></i>:</span></td>
    394 	  <td>
    395 	    <xsl:call-template name="dumptext">
    396 	      <xsl:with-param name="text" select="@info"/>
    397 	    </xsl:call-template>
    398 	  </td>
    399         </tr>
    400       </xsl:for-each>
    401       <xsl:if test="return/@info">
    402         <tr>
    403           <td><span class="term"><i><tt>Returns</tt></i>:</span></td>
    404 	  <td>
    405 	    <xsl:call-template name="dumptext">
    406 	      <xsl:with-param name="text" select="return/@info"/>
    407 	    </xsl:call-template>
    408 	  </td>
    409         </tr>
    410       </xsl:if>
    411       </tbody></table></div>
    412     </xsl:if>
    413     </div><hr/>
    414   </xsl:template>
    415 
    416   <xsl:template mode="details" match="functype">
    417     <xsl:variable name="name" select="string(@name)"/>
    418     <xsl:variable name="nlen" select="string-length($name)"/>
    419     <xsl:variable name="tlen" select="string-length(return/@type)"/>
    420     <xsl:variable name="blen" select="(($nlen + 8) - (($nlen + 8) mod 8)) + (($tlen + 8) - (($tlen + 8) mod 8))"/>
    421     <div class="refsect2" lang="en">
    422     <h3><a name="{$name}"></a>Function type <xsl:value-of select="$name"/> </h3>
    423     <pre class="programlisting">
    424     <xsl:call-template name="dumptext">
    425       <xsl:with-param name="text" select="return/@type"/>
    426     </xsl:call-template>
    427     <xsl:text>&#9;</xsl:text>
    428     <xsl:value-of select="@name"/>
    429     <xsl:if test="$blen - 40 &lt; -8">
    430       <xsl:text>&#9;</xsl:text>
    431     </xsl:if>
    432     <xsl:if test="$blen - 40 &lt; 0">
    433       <xsl:text>&#9;</xsl:text>
    434     </xsl:if>
    435     <xsl:text>&#9;(</xsl:text>
    436     <xsl:if test="not(arg)">
    437       <xsl:text>void</xsl:text>
    438     </xsl:if>
    439     <xsl:for-each select="arg">
    440       <xsl:call-template name="dumptext">
    441         <xsl:with-param name="text" select="@type"/>
    442       </xsl:call-template>
    443       <xsl:text> </xsl:text>
    444       <xsl:value-of select="@name"/>
    445       <xsl:if test="position() != last()">
    446         <xsl:text>, </xsl:text><br/>
    447 	<xsl:if test="$blen - 40 &gt; 8">
    448 	  <xsl:text>&#9;</xsl:text>
    449 	</xsl:if>
    450 	<xsl:if test="$blen - 40 &gt; 0">
    451 	  <xsl:text>&#9;</xsl:text>
    452 	</xsl:if>
    453 	<xsl:text>&#9;&#9;&#9;&#9;&#9; </xsl:text>
    454       </xsl:if>
    455     </xsl:for-each>
    456     <xsl:text>)</xsl:text><br/>
    457     <xsl:text>
    458 </xsl:text>
    459     </pre>
    460     <p>
    461     <xsl:call-template name="dumptext">
    462       <xsl:with-param name="text" select="info"/>
    463     </xsl:call-template>
    464     </p><xsl:text>
    465 </xsl:text>
    466     <xsl:if test="arg | return/@info">
    467       <div class="variablelist"><table border="0"><col align="left"/><tbody>
    468       <xsl:for-each select="arg">
    469         <tr>
    470           <td><span class="term"><i><tt><xsl:value-of select="@name"/></tt></i>:</span></td>
    471 	  <td>
    472 	    <xsl:call-template name="dumptext">
    473 	      <xsl:with-param name="text" select="@info"/>
    474 	    </xsl:call-template>
    475 	  </td>
    476         </tr>
    477       </xsl:for-each>
    478       <xsl:if test="return/@info">
    479         <tr>
    480           <td><span class="term"><i><tt>Returns</tt></i>:</span></td>
    481 	  <td>
    482 	    <xsl:call-template name="dumptext">
    483 	      <xsl:with-param name="text" select="return/@info"/>
    484 	    </xsl:call-template>
    485 	  </td>
    486         </tr>
    487       </xsl:if>
    488       </tbody></table></div>
    489     </xsl:if>
    490     </div><hr/>
    491   </xsl:template>
    492 
    493 <!--
    494 
    495              The following builds the general.html page
    496 
    497 -->
    498   <xsl:template name="generate_general">
    499     <xsl:variable name="next" select="string(/api/files/file[position()=1]/@name)"/>
    500     <xsl:document xmlns="" href="general.html" method="xml" indent="yes" encoding="UTF-8">
    501       <html>
    502         <head>
    503 	  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    504 	  <title><xsl:value-of select="concat(@name, ': ', summary)"/></title>
    505 	  <meta name="generator" content="Libxml2 devhelp stylesheet"/>
    506 	  <link rel="start" href="index.html" title="libxml2 Reference Manual"/>
    507 	  <link rel="up" href="index.html" title="libxml2 Reference Manual"/>
    508 	  <link rel="stylesheet" href="style.css" type="text/css"/>
    509 	  <link rel="chapter" href="index.html" title="libxml2 Reference Manual"/>
    510         </head>
    511 	<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    512 
    513           <table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
    514 	    <tr valign="middle">
    515               <td><a accesskey="u" href="index.html"><img src="up.png" width="24" height="24" border="0" alt="Up"/></a></td>
    516               <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"/></a></td>
    517 	      <xsl:if test="$next != ''">
    518 		<td><a accesskey="n" href="libxml2-{$next}.html"><img src="right.png" width="24" height="24" border="0" alt="Next"/></a></td>
    519 	      </xsl:if>
    520               <th width="100%" align="center">libxml2 Reference Manual</th>
    521             </tr>
    522 	  </table>
    523 	  <h2><span class="refentrytitle">libxml2 API Modules</span></h2>
    524 	  <p>
    525 	  <xsl:for-each select="/api/files/file">
    526 	    <a href="libxml2-{@name}.html"><xsl:value-of select="@name"/></a> - <xsl:value-of select="summary"/><br/>
    527 	  </xsl:for-each>
    528 	  </p>
    529 	</body>
    530       </html>
    531     </xsl:document>
    532   </xsl:template>
    533 
    534 <!--
    535 
    536              The following builds the index.html page
    537 
    538 -->
    539   <xsl:template name="generate_index">
    540     <xsl:document xmlns="" href="index.html" method="xml" indent="yes" encoding="UTF-8">
    541       <html>
    542         <head>
    543 	  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    544 	  <title>libxml2 Reference Manual</title>
    545 	  <meta name="generator" content="Libxml2 devhelp stylesheet"/>
    546 	  <link rel="stylesheet" href="style.css" type="text/css"/>
    547         </head>
    548 	<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    549 
    550           <table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
    551 	    <tr valign="middle">
    552               <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"/></a></td>
    553 	      <td><a accesskey="n" href="general.html"><img src="right.png" width="24" height="24" border="0" alt="Next"/></a></td>
    554               <th width="100%" align="center">libxml2 Reference Manual</th>
    555             </tr>
    556 	  </table>
    557 	  <h2><span class="refentrytitle">libxml2 Reference Manual</span></h2>
    558 <p>Libxml2 is the XML C parser and toolkit developed for the Gnome project
    559 (but usable outside of the Gnome platform), it is free software available
    560 under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
    561 License</a>. XML itself is a metalanguage to design markup languages, i.e.
    562 text language where semantic and structure are added to the content using
    563 extra "markup" information enclosed between angle brackets. HTML is the most
    564 well-known markup language. Though the library is written in C <a href="http://xmlsoft.org/python.html">a variety of language bindings</a> make it available in
    565 other environments.</p>
    566 <p>Libxml2 implements a number of existing standards related to markup
    567 languages:</p>
    568 <ul><li>the XML standard: <a href="http://www.w3.org/TR/REC-xml">http://www.w3.org/TR/REC-xml</a></li>
    569 <li>Namespaces in XML: <a href="http://www.w3.org/TR/REC-xml-names/">http://www.w3.org/TR/REC-xml-names/</a></li>
    570 <li>XML Base: <a href="http://www.w3.org/TR/xmlbase/">http://www.w3.org/TR/xmlbase/</a></li>
    571 <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC 2396</a> :
    572 Uniform Resource Identifiers <a href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</a></li>
    573 <li>XML Path Language (XPath) 1.0: <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a></li>
    574 <li>HTML4 parser: <a href="http://www.w3.org/TR/html401/">http://www.w3.org/TR/html401/</a></li>
    575 <li>XML Pointer Language (XPointer) Version 1.0: <a href="http://www.w3.org/TR/xptr">http://www.w3.org/TR/xptr</a></li>
    576 <li>XML Inclusions (XInclude) Version 1.0: <a href="http://www.w3.org/TR/xinclude/">http://www.w3.org/TR/xinclude/</a></li>
    577 <li>ISO-8859-x encodings, as well as <a href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a> [UTF-8]
    578 and <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>
    579 [UTF-16] Unicode encodings, and more if using iconv support</li>
    580 <li>part of SGML Open Technical Resolution TR9401:1997</li>
    581 <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>
    582 <li>Canonical XML Version 1.0: <a href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>
    583 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>
    584 <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>
    585 <li>W3C XML Schemas Part 2: Datatypes <a href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02 May
    586 2001</a></li>
    587 <li>W3C <a href="http://www.w3.org/TR/xml-id/">xml:id</a> Working Draft 7
    588 April 2004</li>
    589 </ul>
    590 	  <p> As a result the <a href="general.html">libxml2 API</a> is very
    591 	      large. If you get lost searching for some specific API use
    592 	      <a href="http://xmlsoft.org/search.php">the online search
    593 	      engine</a> hosted on <a href="http://xmlsoft.org/">xmlsoft.org</a>
    594 	      the libxml2 and libxslt project page. </p>
    595 	</body>
    596       </html>
    597     </xsl:document>
    598   </xsl:template>
    599 
    600 </xsl:stylesheet>
    601 
    602 
    603