lib/libxslt
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/libxslt synced 2025-08-07 10:42:55 +03:00
Code Activity

Fixing the screwups introduced by amaya, Daniel

Browse Source
This commit is contained in:
Daniel Veillard
2006-06-09 13:40:33 +00:00
parent d9d50ec150
commit 54f9859bf2
17 changed files with 2116 additions and 2100 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/API.html
View File

@@ -8,19 +8,19 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>The programming API</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>The programming API</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>The programming API</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>The programming API</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>Okay this section is clearly incomplete. But integrating libxslt into <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>Okay this section is clearly incomplete. But integrating libxslt into your
yourapplication should be relatively easy. First check the few steps application should be relatively easy. First check the few steps described
describedbelow, then for more detailed informations, look at the<a href="html/libxslt-lib.html">generated pages</a>for the API and the sourceof below, then for more detailed informations, look at the<a href="html/libxslt-lib.html"> generated pages</a> for the API and the source
libxslt/xsltproc.c and the <a href="tutorial/libxslttutorial.html">tutorial</a>.</p><p>Basically doing an XSLT transformation can be done in a few steps:</p><ol><li>configure the parser for XSLT: of libxslt/xsltproc.c and the <a href="tutorial/libxslttutorial.html">tutorial</a>.</p><p>Basically doing an XSLT transformation can be done in a few steps:</p><ol><li>configure the parser for XSLT:
<p>xmlSubstituteEntitiesDefault(1);</p> <p>xmlSubstituteEntitiesDefault(1);</p>
<p>xmlLoadExtDtdDefaultValue = 1;</p> <p>xmlLoadExtDtdDefaultValue = 1;</p>
</li> </li>
<li>parse the stylesheet with xsltParseStylesheetFile()</li> <li>parse the stylesheet with xsltParseStylesheetFile()</li>
<li>parse the document with xmlParseFile()</li> <li>parse the document with xmlParseFile()</li>
<li>apply the stylesheet using xsltApplyStylesheet()</li> <li>apply the stylesheet using xsltApplyStylesheet()</li>
<li>save the result using xsltSaveResultToFile() if needed <li>save the result using xsltSaveResultToFile() if needed set
setxmlIndentTreeOutput to 1</li> xmlIndentTreeOutput to 1</li>
</ol><p>Steps 2,3, and 5 will probably need to be changed depending on </ol><p>Steps 2,3, and 5 will probably need to be changed depending on you
youprocessing needs and environment for example if reading/saving processing needs and environment for example if reading/saving from/to
from/tomemory, or if you want to apply XInclude processing to the stylesheet memory, or if you want to apply XInclude processing to the stylesheet or
orinput documents.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> input documents.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

28
doc/FAQ.html
View File

@@ -9,31 +9,31 @@ H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>FAQ</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>FAQ</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>FAQ</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>FAQ</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><ol><li><em>Troubles compiling or linking programs using libxslt</em> <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><ol><li><em>Troubles compiling or linking programs using libxslt</em>
<p>Usually the problem comes from the fact that the compiler doesn't <p>Usually the problem comes from the fact that the compiler doesn't get
getthe right compilation or linking flags. There is a small shell the right compilation or linking flags. There is a small shell script
script<code>xslt-config</code>which is installed as part of libxslt <code>xslt-config</code> which is installed as part of libxslt usual
usualinstall process which provides those flags. Use</p> install process which provides those flags. Use</p>
<p><code>xslt-config --cflags</code></p> <p><code>xslt-config --cflags</code></p>
<p>to get the compilation flags and</p> <p>to get the compilation flags and</p>
<p><code>xslt-config --libs</code></p> <p><code>xslt-config --libs</code></p>
<p>to get the linker flags. Usually this is done directly from <p>to get the linker flags. Usually this is done directly from the
theMakefile as:</p> Makefile as:</p>
<p><code>CFLAGS=`xslt-config --cflags`</code></p> <p><code>CFLAGS=`xslt-config --cflags`</code></p>
<p><code>LIBS=`xslt-config --libs`</code></p> <p><code>LIBS=`xslt-config --libs`</code></p>
<p>Note also that if you use the EXSLT extensions from the program <p>Note also that if you use the EXSLT extensions from the program then
thenyou should prepend <code>-lexslt</code>to the LIBS options</p> you should prepend <code>-lexslt</code> to the LIBS options</p>
</li> </li>
<li><em>passing parameters on the xsltproc command line doesn't work</em> <li><em>passing parameters on the xsltproc command line doesn't work</em>
<p><em>xsltproc --param test alpha foo.xsl foo.xml</em></p> <p><em>xsltproc --param test alpha foo.xsl foo.xml</em></p>
<p><em>the param does not get passed and ends up as ""</em></p> <p><em>the param does not get passed and ends up as ""</em></p>
<p>In a nutshell do a double escaping at the shell prompt:</p> <p>In a nutshell do a double escaping at the shell prompt:</p>
<p>xsltproc --param test "'alpha'" foo.xsl foo.xml</p> <p>xsltproc --param test "'alpha'" foo.xsl foo.xml</p>
<p>i.e. the string value is surrounded by " and ' then terminated by 'and <p>i.e. the string value is surrounded by " and ' then terminated by '
". Libxslt interpret the parameter values as XPath expressions, sothe and ". Libxslt interpret the parameter values as XPath expressions, so
string -&gt;<code>alpha</code>&lt;- is intepreted as the node setmatching the string -&gt;<code>alpha</code>&lt;- is intepreted as the node set
this string. You really want -&gt;<code>'alpha'</code>&lt;- tobe passed matching this string. You really want -&gt;<code>'alpha'</code>&lt;- to
to the processor. And to allow this you need to escape thequotes at the be passed to the processor. And to allow this you need to escape the
shell level using -&gt;<code>"'alpha'"</code>&lt;- .</p> quotes at the shell level using -&gt;<code>"'alpha'"</code>&lt;- .</p>
<p>or use</p> <p>or use</p>
<p>xsltproc --stringparam test alpha foo.xsl foo.xml</p> <p>xsltproc --stringparam test alpha foo.xsl foo.xml</p>
</li> </li>

162
doc/bugs.html
View File

@@ -8,84 +8,86 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>Reporting bugs and getting help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Reporting bugs and getting help</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>Reporting bugs and getting help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Reporting bugs and getting help</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>If you need help with the XSLT language itself, here are a number ofuseful <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>If you need help with the XSLT language itself, here are a number of
resources:</p><ul><li>I strongly suggest to subscribe to <a href="http://www.mulberrytech.com/xsl/xsl-list">XSL-list</a>, check <a href="http://www.biglist.com/lists/xsl-list/archives/">the useful resources:</p><ul><li>I strongly suggest to subscribe to <a href="http://www.mulberrytech.com/xsl/xsl-list">XSL-list</a>, check <a href="http://www.biglist.com/lists/xsl-list/archives/">the XSL-list
XSL-listarchives</a></li> archives</a></li>
<li>The <a href="http://www.dpawson.co.uk/xsl/xslfaq.html">XSL FAQ</a>.</li> <li>The <a href="http://www.dpawson.co.uk/xsl/xslfaq.html">XSL FAQ</a>.</li>
<li>The <a href="http://www.nwalsh.com/docs/tutorials/xsl/xsl/slides.html">tutorial</a>written <li>The <a href="http://www.nwalsh.com/docs/tutorials/xsl/xsl/slides.html">tutorial</a>
by Paul Grosso and Norman Walsh is a very good on-lineintrodution to the written by Paul Grosso and Norman Walsh is a very good on-line
language.</li> introdution to the language.</li>
<li>The <a href="http://www.zvon.org/xxl/XSLTutorial/Books/Book1/index.html">onlyZvon <li>The <a href="http://www.zvon.org/xxl/XSLTutorial/Books/Book1/index.html">only
XSLT tutorial</a>details a lot of constructs with examples.</li> Zvon XSLT tutorial</a> details a lot of constructs with examples.</li>
<li><a href="http://www.jenitennison.com/xslt/index.html">Jeni <li><a href="http://www.jenitennison.com/xslt/index.html">Jeni Tennison's
Tennison'sXSLT</a>pages provide links to a lot of answers</li> XSLT</a> pages provide links to a lot of answers</li>
<li>the <a href="http://incrementaldevelopment.com/xsltrick/">Gallery <li>the <a href="http://incrementaldevelopment.com/xsltrick/">Gallery of
ofXSLT Tricks</a>provides non-standard use case of XSLT</li> XSLT Tricks</a> provides non-standard use case of XSLT</li>
<li>And I suggest to buy Michael Kay "XSLT Programmer's Reference" <li>And I suggest to buy Michael Kay "XSLT Programmer's Reference" book
bookpublished by <a href="http://www.wrox.com/">Wrox</a>if you plan to published by <a href="http://www.wrox.com/">Wrox</a> if you plan to work
workseriously with XSLT in the future.</li> seriously with XSLT in the future.</li>
</ul><p>Well, bugs or missing features are always possible, and I will make apoint </ul><p>Well, bugs or missing features are always possible, and I will make a
of fixing them in a timely fashion. The best way to report a bug is touse the point of fixing them in a timely fashion. The best way to report a bug is to
<a href="http://bugzilla.gnome.org/enter_bug.cgi?product=libxslt">Gnome use the <a href="http://bugzilla.gnome.org/enter_bug.cgi?product=libxslt">Gnome bug
bugtracking database</a>(make sure to use the "libxslt" module name). tracking database</a> (make sure to use the "libxslt" module name). Before
Beforefiling a bug, check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">list of filing a bug, check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">list of existing
existinglibxslt bugs</a>to make sure it hasn't already been filed. I look at libxslt bugs</a> to make sure it hasn't already been filed. I look at reports
reportsthere regularly and it's good to have a reminder when a bug is still there regularly and it's good to have a reminder when a bug is still open. Be
open. Besure to specify that the bug is for the package libxslt.</p><p>For small problems you can try to get help on IRC, the #xml channel sure to specify that the bug is for the package libxslt.</p><p>For small problems you can try to get help on IRC, the #xml channel on
onirc.gnome.org (port 6667) usually have a few person subscribed which may irc.gnome.org (port 6667) usually have a few person subscribed which may help
help(but there is no garantee and if a real issue is raised it should go on (but there is no garantee and if a real issue is raised it should go on the
themailing-list for archival).</p><p>There is also a mailing-list <a href="mailto:xslt@gnome.org">xslt@gnome.org</a>for libxslt, with an <a href="http://mail.gnome.org/archives/xslt/">on-line archive</a>. To mailing-list for archival).</p><p>There is also a mailing-list <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> for libxslt, with an <a href="http://mail.gnome.org/archives/xslt/">on-line archive</a>. To subscribe
subscribeto this list, please visit the <a href="http://mail.gnome.org/mailman/listinfo/xslt">associated Web</a>pageand to this list, please visit the <a href="http://mail.gnome.org/mailman/listinfo/xslt">associated Web</a> page
follow the instructions.</p><p>Alternatively, you can just send the bug to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a>list, if it's really and follow the instructions.</p><p>Alternatively, you can just send the bug to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> list, if it's really libxslt
libxsltrelated I will approve it.. Please do not send me mail directly related I will approve it.. Please do not send me mail directly especially
especiallyfor portability problem, it makes things really harder to track and for portability problem, it makes things really harder to track and in some
in somecases I'm not the best person to answer a given question, ask the cases I'm not the best person to answer a given question, ask the list
listinstead. <strong>Do not send code, I won't debug it</strong>(but patches instead. <strong>Do not send code, I won't debug it</strong> (but patches are
arereally appreciated!).</p><p>Please note that with the current amount of virus and SPAM, sending mailto really appreciated!).</p><p>Please note that with the current amount of virus and SPAM, sending mail
the list without being subscribed won't work. There is *far too manybounces* to the list without being subscribed won't work. There is *far too many
(in the order of a thousand a day !) I cannot approve them manuallyanymore. bounces* (in the order of a thousand a day !) I cannot approve them manually
If your mail to the list bounced waiting for administrator approval,it is anymore. If your mail to the list bounced waiting for administrator approval,
LOST ! Repost it and fix the problem triggering the error. Also pleasenote it is LOST ! Repost it and fix the problem triggering the error. Also please
that <span style="color: #FF0000; background-color: #FFFFFF">emails witha note that <span style="color: #FF0000; background-color: #FFFFFF">emails with
legal warning asking to not copy or redistribute freely the informationsthey a legal warning asking to not copy or redistribute freely the informations
contain</span>are <strong>NOT</strong>acceptable for the mailing-list,such they contain</span> are <strong>NOT</strong> acceptable for the mailing-list,
mail will as much as possible be discarded automatically, and are lesslikely such mail will as much as possible be discarded automatically, and are less
to be answered if they made it to the list, <strong>DO NOT</strong>post to likely to be answered if they made it to the list, <strong>DO NOT</strong>
the list from an email address where such legal requirements areautomatically post to the list from an email address where such legal requirements are
added, get private paying support if you can't shareinformations.</p><p>Check the following too <span style="color: #E50000">beforeposting</span>:</p><ul><li><a href="search.php">use the search engine</a>to get automatically added, get private paying support if you can't share
informationsrelated to your problem.</li> informations.</p><p>Check the following too <span style="color: #E50000">before
<li>make sure you are <a href="ftp://xmlsoft.org/libxslt/">using a posting</span>:</p><ul><li><a href="search.php">use the search engine</a> to get informations
recentversion</a>, and that the problem still shows up in those</li> related to your problem.</li>
<li>check the <a href="http://mail.gnome.org/archives/xslt/">listarchives</a>to see if the <li>make sure you are <a href="ftp://xmlsoft.org/libxslt/">using a recent
problem was reported already, in this casethere is probably a fix version</a>, and that the problem still shows up in those</li>
available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">registeredopen <li>check the <a href="http://mail.gnome.org/archives/xslt/">list
bugs</a></li> archives</a> to see if the problem was reported already, in this case
<li>make sure you can reproduce the bug with xsltproc, a very useful there is probably a fix available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">registered
thingto do is run the transformation with -v argument and redirect open bugs</a></li>
thestandard error to a file, then search in this file for the <li>make sure you can reproduce the bug with xsltproc, a very useful thing
transformationlogs just preceding the possible problem</li> to do is run the transformation with -v argument and redirect the
<li>Please send the command showing the error as well as the input standard error to a file, then search in this file for the transformation
andstylesheet (as an attachment)</li> logs just preceding the possible problem</li>
</ul><p>Then send the bug with associated informations to reproduce it to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a>list; if it's really <li>Please send the command showing the error as well as the input and
libxsltrelated I will approve it. Please do not send mail to me directly, it stylesheet (as an attachment)</li>
makesthings really hard to track and in some cases I am not the best person </ul><p>Then send the bug with associated informations to reproduce it to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> list; if it's really libxslt
toanswer a given question, ask on the list.</p><p>To <span style="color: #E50000">be really clear about support</span>:</p><ul><li>Support or help <span style="color: #E50000">request MUST be sent tothe related I will approve it. Please do not send mail to me directly, it makes
list or on bugzilla</span>in case of problems, so that the Questionand things really hard to track and in some cases I am not the best person to
Answers can be shared publicly. Failing to do so carries the answer a given question, ask on the list.</p><p>To <span style="color: #E50000">be really clear about support</span>:</p><ul><li>Support or help <span style="color: #E50000">request MUST be sent to
implicitmessage "I want free support but I don't want to share the the list or on bugzilla</span> in case of problems, so that the Question
benefits withothers" and is not welcome. I will automatically Carbon-Copy and Answers can be shared publicly. Failing to do so carries the implicit
thexslt@gnome.org mailing list for any technical reply made about libxml2 message "I want free support but I don't want to share the benefits with
orlibxslt.</li> others" and is not welcome. I will automatically Carbon-Copy the
<li>There is <span style="color: #E50000">no garantee for support</span>,if xslt@gnome.org mailing list for any technical reply made about libxml2 or
your question remains unanswered after a week, repost it, making sureyou libxslt.</li>
gave all the detail needed and the informations requested.</li> <li>There is <span style="color: #E50000">no garantee for support</span>,
<li>Failing to provide informations as requested or double checking if your question remains unanswered after a week, repost it, making sure
firstfor prior feedback also carries the implicit message "the time of you gave all the detail needed and the informations requested.</li>
thelibrary maintainers is less valuable than my time" and might not <li>Failing to provide informations as requested or double checking first
bewelcome.</li> for prior feedback also carries the implicit message "the time of the
</ul><p>Of course, bugs reports with a suggested patch for fixing them library maintainers is less valuable than my time" and might not be
willprobably be processed faster.</p><p>If you're looking for help, a quick look at <a href="http://mail.gnome.org/archives/xslt/">the list archive</a>may welcome.</li>
actuallyprovide the answer, I usually send source samples when answering </ul><p>Of course, bugs reports with a suggested patch for fixing them will
libxsltusage questions. The <a href="html/libxslt-lib.html#LIBXSLT-LIB">auto-generated probably be processed faster.</p><p>If you're looking for help, a quick look at <a href="http://mail.gnome.org/archives/xslt/">the list archive</a> may actually
documentation</a>isnot as polished as I would like (I need to learn more provide the answer, I usually send source samples when answering libxslt
about Docbook), butit's a good starting point.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> usage questions. The <a href="html/libxslt-lib.html#LIBXSLT-LIB">auto-generated documentation</a> is
not as polished as I would like (I need to learn more about Docbook), but
it's a good starting point.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

59
doc/contribs.html
View File

@@ -8,33 +8,34 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>Contributions</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Contributions</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>Contributions</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Contributions</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><ul><li>Bjorn Reese is the author of the number support and worked on <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><ul><li>Bjorn Reese is the author of the number support and worked on the
theXSLTMark support</li> XSLTMark support</li>
<li>William Brack was an early adopted, contributed a number of patches <li>William Brack was an early adopted, contributed a number of patches and
andspent quite some time debugging non-trivial problems in early versions spent quite some time debugging non-trivial problems in early versions of
oflibxslt</li> libxslt</li>
<li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a>is now <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the
themaintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he maintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
providesbinaries</a></li> binaries</a></li>
<li>Thomas Broyer provided a lot of suggestions, and drafted most of <li>Thomas Broyer provided a lot of suggestions, and drafted most of the
theextension API</li> extension API</li>
<li>John Fleck maintains <a href="tutorial/libxslttutorial.html">a <li>John Fleck maintains <a href="tutorial/libxslttutorial.html">a tutorial
tutorialfor libxslt</a></li> for libxslt</a></li>
<li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">MattSergeant</a>developed <li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
<a href="http://axkit.org/download/">XML::LibXSLT</a>, a perl wrapper Sergeant</a> developed <a href="http://axkit.org/download/">XML::LibXSLT</a>, a perl wrapper for
forlibxml2/libxslt as part of the <a href="http://axkit.com/">AxKit libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML
XMLapplication server</a></li> application server</a></li>
<li>there is a module for <a href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt <li>there is a module for <a href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt support
supportin OpenNSD/AOLServer</a></li> in OpenNSD/AOLServer</a></li>
<li><a href="mailto:dkuhlman@cutter.rexx.com">Dave <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provides
Kuhlman</a>provideslibxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers forPython</a></li> libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for
<li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a>, Python</a></li>
andcontributors maintain <a href="http://tclxml.sourceforge.net/">tclbindings for libxml2 and <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a>, and
libxslt</a>, as well as <a href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a>a GUI forxmllint contributors maintain <a href="http://tclxml.sourceforge.net/">tcl
and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>a GUI bindings for libxml2 and libxslt</a>, as well as <a href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a> a GUI for
for xsltproc.</li> xmllint and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>
<li>If you want to use libxslt in a Mac OS X/Cocoa or Objective-Cframework, a GUI for xsltproc.</li>
Marc Liyanage provides <a href="http://www.entropy.ch/software/macosx/#testxslt">an <li>If you want to use libxslt in a Mac OS X/Cocoa or Objective-C
applicationTestXSLT for XSLT and XML editing</a>including wrapper classes framework, Marc Liyanage provides <a href="http://www.entropy.ch/software/macosx/#testxslt">an application
for theXML parser and XSLT processor.</li> TestXSLT for XSLT and XML editing</a> including wrapper classes for the
XML parser and XSLT processor.</li>
</ul><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

91
doc/docbook.html
View File

@@ -8,53 +8,56 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>DocBook</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>DocBook</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>DocBook</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>DocBook</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p><img src="duck.png" align="right" alt="The duck picture" /></p><p><a href="http://www.oasis-open.org/committees/docbook/">DocBook</a>is <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p><img src="duck.png" align="right" alt="The duck picture" /></p><p><a href="http://www.oasis-open.org/committees/docbook/">DocBook</a> is an
anXML/SGML vocabulary particularly well suited to books and papers XML/SGML vocabulary particularly well suited to books and papers about
aboutcomputer hardware and software.</p><p>xsltproc and libxslt are not specifically dependant on DocBook, but sincea computer hardware and software.</p><p>xsltproc and libxslt are not specifically dependant on DocBook, but since
lot of people use xsltproc and libxml2 for DocBook formatting, here are afew a lot of people use xsltproc and libxml2 for DocBook formatting, here are a
pointers and informations which may be helpful:</p><ul><li>The <a href="http://www.oasis-open.org/committees/docbook/">DocBookhomepage at few pointers and informations which may be helpful:</p><ul><li>The <a href="http://www.oasis-open.org/committees/docbook/">DocBook
Oasis</a>you should find pointers there on all the lastestversions of the homepage at Oasis</a> you should find pointers there on all the lastest
DTDs and XSLT stylesheets</li> versions of the DTDs and XSLT stylesheets</li>
<li><a href="http://www.docbook.org/">DocBook: The Definitive <li><a href="http://www.docbook.org/">DocBook: The Definitive Guide</a> is
Guide</a>isthe official reference documentation for DocBook.</li> the official reference documentation for DocBook.</li>
<li><a href="https://sourceforge.net/docman/index.php?group_id=21935">DocBookOpen <li><a href="https://sourceforge.net/docman/index.php?group_id=21935">DocBook
Repository</a>contains a lot of informations about DocBook</li> Open Repository</a> contains a lot of informations about DocBook</li>
<li>Bob Stayton provides a <a href="http://www.sagehill.net/">lot <li>Bob Stayton provides a <a href="http://www.sagehill.net/">lot of
ofresources</a>and consulting services around DocBook.</li> resources</a> and consulting services around DocBook.</li>
<li>Here is a <a href="/buildDocBookCatalog">shell script</a>to generateXML <li>Here is a <a href="/buildDocBookCatalog">shell script</a> to generate
Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/directory, XML Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/
it will set-up /etc/xml/catalog and /etc/xml/docbook based onthe directory, it will set-up /etc/xml/catalog and /etc/xml/docbook based on
resources found on the system. Otherwise it will just create~/xmlcatalog the resources found on the system. Otherwise it will just create
and ~/dbkxmlcatalog and doing: ~/xmlcatalog and ~/dbkxmlcatalog and doing:
<p><code>export XMLCATALOG=$HOME/xmlcatalog</code></p> <p><code>export XMLCATALOG=$HOME/xmlcatalog</code></p>
<p>should allow to process DocBook documentations without <p>should allow to process DocBook documentations without requiring
requiringnetwork accesses for the DTd or stylesheets</p> network accesses for the DTd or stylesheets</p>
</li> </li>
<li>I have uploaded <a href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">asmall <li>I have uploaded <a href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">a
tarball</a>containing XML Catalogs for DocBook 4.1.2 which seemsto work small tarball</a> containing XML Catalogs for DocBook 4.1.2 which seems
fine for me too</li> to work fine for me too</li>
<li>Informations on installing a <a href="http://ourworld.compuserve.com/homepages/hoenicka_markus/ntsgml.html">WindowsDocBook <li>Informations on installing a <a href="http://ourworld.compuserve.com/homepages/hoenicka_markus/ntsgml.html">Windows
processing setup</a>based on Cygwin (using the binaries from theofficial DocBook processing setup</a> based on Cygwin (using the binaries from the
Windows port should be possible too)</li> official Windows port should be possible too)</li>
<li>Alexander Kirillov's page on <a href="http://www.math.sunysb.edu/~kirillov/dbxml/">Using DocBook <li>Alexander Kirillov's page on <a href="http://www.math.sunysb.edu/~kirillov/dbxml/">Using DocBook XML
XML4.1.2</a>(RPM packages)</li> 4.1.2</a> (RPM packages)</li>
<li>Tim Waugh's <a href="http://cyberelk.net/tim/xmlto/">xmlto <li>Tim Waugh's <a href="http://cyberelk.net/tim/xmlto/">xmlto front-end
front-endconversion script</a></li> conversion script</a></li>
<li>Linux Documentation Project <a href="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/">DocBook-Install-mini-HOWTO</a></li> <li>Linux Documentation Project <a href="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/">
<li>ScrollKeeper the open documentation cataloging project has a <a href="http://scrollkeeper.sourceforge.net/docbook.shtml">DocBooksection</a></li> DocBook-Install-mini-HOWTO</a></li>
<li>Dan York presentation on <a href="http://www.lodestar2.com/people/dyork/talks/2001/xugo/docbook/index.html">Publishingusing <li>ScrollKeeper the open documentation cataloging project has a <a href="http://scrollkeeper.sourceforge.net/docbook.shtml">DocBook
DocBook XML</a></li> section</a></li>
</ul><p>Do not use the --docbook option of xsltproc to process XML <li>Dan York presentation on <a href="http://www.lodestar2.com/people/dyork/talks/2001/xugo/docbook/index.html">Publishing
DocBookdocuments, this option is only intended to provide some (limited) using DocBook XML</a></li>
support ofthe SGML version of DocBook.</p><p>Points which are not DocBook specific but still worth mentionningagain:</p><ul><li>if you think DocBook processing time is too slow, make sure you haveXML </ul><p>Do not use the --docbook option of xsltproc to process XML DocBook
Catalogs pointing to a local installation of the DTD of DocBook.Check the documents, this option is only intended to provide some (limited) support of
<a href="http://xmlsoft.org/catalog.html">XML Catalog page</a>to the SGML version of DocBook.</p><p>Points which are not DocBook specific but still worth mentionning
understand more on this subject.</li> again:</p><ul><li>if you think DocBook processing time is too slow, make sure you have
XML Catalogs pointing to a local installation of the DTD of DocBook.
Check the <a href="http://xmlsoft.org/catalog.html">XML Catalog page</a>
to understand more on this subject.</li>
<li>before processing a new document, use the command <li>before processing a new document, use the command
<p><code>xmllint --valid --noout path_to_document</code></p> <p><code>xmllint --valid --noout path_to_document</code></p>
<p>to make sure that your input is valid DocBook. And fixes the <p>to make sure that your input is valid DocBook. And fixes the errors
errorsbefore processing further. Note that XSLT processing may work before processing further. Note that XSLT processing may work correctly
correctlywith some forms of validity errors left, but in general it can with some forms of validity errors left, but in general it can give
givetroubles on output.</p> troubles on output.</p>
</li> </li>
</ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

15
doc/docs.html
View File

@@ -8,11 +8,12 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>Documentation</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Documentation</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>Documentation</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Documentation</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>There are some on-line resources about using libxslt:</p><ol><li>Check the <a href="html/libxslt-lib.html#LIBXSLT-LIB">APIdocumentation</a>automatically <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>There are some on-line resources about using libxslt:</p><ol><li>Check the <a href="html/libxslt-lib.html#LIBXSLT-LIB">API
extracted from code comments (using theprogram apibuild.py, developed for documentation</a> automatically extracted from code comments (using the
libxml, together with the xsl script'newapi.xsl' and the libxslt xsltproc program apibuild.py, developed for libxml, together with the xsl script
program).</li> 'newapi.xsl' and the libxslt xsltproc program).</li>
<li>Look at the <a href="http://mail.gnome.org/archives/xslt/">mailing-listarchive</a>.</li> <li>Look at the <a href="http://mail.gnome.org/archives/xslt/">mailing-list
<li>Of course since libxslt is based on libxml, it's a good idea to atleast archive</a>.</li>
read <a href="http://xmlsoft.org/">libxml description</a></li> <li>Of course since libxslt is based on libxml, it's a good idea to at
least read <a href="http://xmlsoft.org/">libxml description</a></li>
</ol><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ol><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

34
doc/downloads.html
View File

@@ -8,21 +8,23 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>Downloads</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Downloads</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>Downloads</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Downloads</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>The latest versions of libxslt can be found on the <a href="ftp://xmlsoft.org/libxslt/">xmlsoft.org</a>server and on mirrors (<a href="ftp://fr.rpmfind.net/pub/libxml/">France</a>) or on the <a href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">Gnome FTP server</a>as a<a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxslt/1.1/">sourcearchive</a>, <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>The latest versions of libxslt can be found on the <a href="ftp://xmlsoft.org/libxslt/">xmlsoft.org</a> server and on mirrors (<a href="ftp://fr.rpmfind.net/pub/libxml/">France</a>) or on the <a href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">Gnome FTP server</a> as a
Antonin Sprinzl also provides <a href="ftp://gd.tuwien.ac.at/pub/libxml/">a <a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxslt/1.1/">source
mirror in Austria</a>. (NOTE thatyou need the <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a>,<a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>,<a href="http://rpmfind.net/linux/RPM/libxslt.html">libxslt</a>and <a href="http://rpmfind.net/linux/RPM/libxslt-devel.html">libxslt-devel</a>packages archive</a>, Antonin Sprinzl also provides <a href="ftp://gd.tuwien.ac.at/pub/libxml/">a mirror in Austria</a>. (NOTE that
installed to compile applications using libxslt.) <a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a>is now the maintainer you need the <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a>,
ofthe Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he <a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>,
providesbinaries</a>. <a href="mailto:Gary.Pennington@sun.com">Gary <a href="http://rpmfind.net/linux/RPM/libxslt.html">libxslt</a> and <a href="http://rpmfind.net/linux/RPM/libxslt-devel.html">libxslt-devel</a>
Pennington</a>provides <a href="http://garypennington.net/libxml2/">Solaris packages installed to compile applications using libxslt.) <a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the maintainer of
binaries</a>.<a href="mailto:Steve.Ball@explain.com.au">Steve the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
Ball</a>provides <a href="http://www.explain.com.au/oss/libxml2xslt.html">Mac binaries</a>. <a href="mailto:Gary.Pennington@sun.com">Gary Pennington</a>
Os Xbinaries</a>.</p><p><a name="Contribs" id="Contribs">Contribs:</a></p><p>I do accept external contributions, especially if compiling on provides <a href="http://garypennington.net/libxml2/">Solaris binaries</a>.
anotherplatform, get in touch with me to upload the package. I will keep them <a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> provides <a href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os X
in the<a href="ftp://xmlsoft.org/libxml2/contribs/">contrib directory</a></p><p>Libxslt is also available from CVS:</p><ul><li><p>The <a href="http://cvs.gnome.org/viewcvs/libxslt/">Gnome binaries</a>.</p><p><a name="Contribs" id="Contribs">Contribs:</a></p><p>I do accept external contributions, especially if compiling on another
CVSbase</a>. Check the <a href="http://developer.gnome.org/tools/cvs.html">Gnome CVS Tools</a>page; platform, get in touch with me to upload the package. I will keep them in the
the CVS module is <b>libxslt</b>.</p> <a href="ftp://xmlsoft.org/libxml2/contribs/">contrib directory</a></p><p>Libxslt is also available from CVS:</p><ul><li><p>The <a href="http://cvs.gnome.org/viewcvs/libxslt/">Gnome CVS
base</a>. Check the <a href="http://developer.gnome.org/tools/cvs.html">Gnome CVS Tools</a>
page; the CVS module is <b>libxslt</b>.</p>
</li> </li>
<li><a href="ftp://xmlsoft.org/libxml2/libxslt-cvs-snapshot.tar.gz">snapshots <li><a href="ftp://xmlsoft.org/libxml2/libxslt-cvs-snapshot.tar.gz">snapshots from
fromCVS</a>updated every hour are also provided</li> CVS</a> updated every hour are also provided</li>
</ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

265
doc/extensions.html
View File

@@ -13,53 +13,54 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="extensions.html#Keep">Extension modules</a></li> <li><a href="extensions.html#Keep">Extension modules</a></li>
<li><a href="extensions.html#Registerin">Registering a module</a></li> <li><a href="extensions.html#Registerin">Registering a module</a></li>
<li><a href="extensions.html#module">Loading a module</a></li> <li><a href="extensions.html#module">Loading a module</a></li>
<li><a href="extensions.html#Registerin1">Registering an <li><a href="extensions.html#Registerin1">Registering an extension
extensionfunction</a></li> function</a></li>
<li><a href="extensions.html#Implementi">Implementing an <li><a href="extensions.html#Implementi">Implementing an extension
extensionfunction</a></li> function</a></li>
<li><a href="extensions.html#Examples">Examples for <li><a href="extensions.html#Examples">Examples for extension
extensionfunctions</a></li> functions</a></li>
<li><a href="extensions.html#Registerin2">Registering an <li><a href="extensions.html#Registerin2">Registering an extension
extensionelement</a></li> element</a></li>
<li><a href="extensions.html#Implementi1">Implementing an <li><a href="extensions.html#Implementi1">Implementing an extension
extensionelement</a></li> element</a></li>
<li><a href="extensions.html#Example">Example for extensionelements</a></li> <li><a href="extensions.html#Example">Example for extension
elements</a></li>
<li><a href="extensions.html#shutdown">The shutdown of a module</a></li> <li><a href="extensions.html#shutdown">The shutdown of a module</a></li>
<li><a href="extensions.html#Future">Future work</a></li> <li><a href="extensions.html#Future">Future work</a></li>
</ul><h3><a name="Introducti1" id="Introducti1">Introduction</a></h3><p>This document describes the work needed to write extensions to thestandard </ul><h3><a name="Introducti1" id="Introducti1">Introduction</a></h3><p>This document describes the work needed to write extensions to the
XSLT library for use with <a href="http://xmlsoft.org/XSLT/">libxslt</a>, the standard XSLT library for use with <a href="http://xmlsoft.org/XSLT/">libxslt</a>, the <a href="http://www.w3.org/TR/xslt">XSLT</a> C library developed for the <a href="http://www.gnome.org/">Gnome</a> project.</p><p>Before starting reading this document it is highly recommended to get
<a href="http://www.w3.org/TR/xslt">XSLT</a>C library developed for the <a href="http://www.gnome.org/">Gnome</a>project.</p><p>Before starting reading this document it is highly recommended to familiar with <a href="internals.html">the libxslt internals</a>.</p><p>Note: this documentation is by definition incomplete and I am not good at
getfamiliar with <a href="internals.html">the libxslt internals</a>.</p><p>Note: this documentation is by definition incomplete and I am not good spelling, grammar, so patches and suggestions are <a href="mailto:veillard@redhat.com">really welcome</a>.</p><h3><a name="Basics" id="Basics">Basics</a></h3><p>The <a href="http://www.w3.org/TR/xslt">XSLT specification</a> provides
atspelling, grammar, so patches and suggestions are <a href="mailto:veillard@redhat.com">really welcome</a>.</p><h3><a name="Basics" id="Basics">Basics</a></h3><p>The <a href="http://www.w3.org/TR/xslt">XSLT specification</a>providestwo two <a href="http://www.w3.org/TR/xslt">ways to extend an XSLT engine</a>:</p><ul><li>providing <a href="http://www.w3.org/TR/xslt">new extension
<a href="http://www.w3.org/TR/xslt">ways to extend an XSLT engine</a>:</p><ul><li>providing <a href="http://www.w3.org/TR/xslt">new functions</a> which can be called from XPath expressions</li>
extensionfunctions</a>which can be called from XPath expressions</li> <li>providing <a href="http://www.w3.org/TR/xslt">new extension
<li>providing <a href="http://www.w3.org/TR/xslt">new elements</a> which can be inserted in stylesheets</li>
extensionelements</a>which can be inserted in stylesheets</li> </ul><p>In both cases the extensions need to be associated to a new namespace,
</ul><p>In both cases the extensions need to be associated to a new namespace,i.e. i.e. an URI used as the name for the extension's namespace (there is no need
an URI used as the name for the extension's namespace (there is no needto to have a resource there for this to work).</p><p>libxslt provides a few extensions itself, either in the libxslt namespace
have a resource there for this to work).</p><p>libxslt provides a few extensions itself, either in the libxslt "http://xmlsoft.org/XSLT/namespace" or in namespaces for other well known
namespace"http://xmlsoft.org/XSLT/namespace" or in namespaces for other well extensions provided by other XSLT processors like Saxon, Xalan or XT.</p><h3><a name="Keep" id="Keep">Extension modules</a></h3><p>Since extensions are bound to a namespace name, usually sets of extensions
knownextensions provided by other XSLT processors like Saxon, Xalan or XT.</p><h3><a name="Keep" id="Keep">Extension modules</a></h3><p>Since extensions are bound to a namespace name, usually sets of coming from a given source are using the same namespace name defining in
extensionscoming from a given source are using the same namespace name practice a group of extensions providing elements, functions or both. From
defining inpractice a group of extensions providing elements, functions or the libxslt point of view those are considered as an "extension module", and
both. Fromthe libxslt point of view those are considered as an "extension most of the APIs work at a module point of view.</p><p>Registration of new functions or elements are bound to the activation of
module", andmost of the APIs work at a module point of view.</p><p>Registration of new functions or elements are bound to the activation the module. This is currently done by declaring the namespace as an extension
ofthe module. This is currently done by declaring the namespace as an by using the attribute <code>extension-element-prefixes</code> on the
extensionby using the attribute <code>extension-element-prefixes</code>on <code><a href="http://www.w3.org/TR/xslt">xsl:stylesheet</a></code>
the<code><a href="http://www.w3.org/TR/xslt">xsl:stylesheet</a></code>element.</p><p>An extension module is defined by 3 objects:</p><ul><li>the namespace name associated</li> element.</p><p>An extension module is defined by 3 objects:</p><ul><li>the namespace name associated</li>
<li>an initialization function</li> <li>an initialization function</li>
<li>a shutdown function</li> <li>a shutdown function</li>
</ul><h3><a name="Registerin" id="Registerin">Registering a module</a></h3><p>Currently a libxslt module has to be compiled within the application </ul><h3><a name="Registerin" id="Registerin">Registering a module</a></h3><p>Currently a libxslt module has to be compiled within the application using
usinglibxslt. There is no code to load dynamically shared libraries libxslt. There is no code to load dynamically shared libraries associated to
associated toa namespace (this may be added but is likely to become a a namespace (this may be added but is likely to become a portability
portabilitynightmare).</p><p>The current way to register a module is to link the code implementing nightmare).</p><p>The current way to register a module is to link the code implementing it
itwith the application and to call a registration function:</p><pre>int xsltRegisterExtModule(const xmlChar *URI, with the application and to call a registration function:</p><pre>int xsltRegisterExtModule(const xmlChar *URI,
xsltExtInitFunction initFunc, xsltExtInitFunction initFunc,
xsltExtShutdownFunction shutdownFunc);</pre><p>The associated header is read by:</p><pre>#include&lt;libxslt/extensions.h&gt;</pre><p>which also defines the type for the initialization and xsltExtShutdownFunction shutdownFunc);</pre><p>The associated header is read by:</p><pre>#include&lt;libxslt/extensions.h&gt;</pre><p>which also defines the type for the initialization and shutdown
shutdownfunctions</p><h3><a name="module" id="module">Loading a module</a></h3><p>Once the module URI has been registered and if the XSLT processor functions</p><h3><a name="module" id="module">Loading a module</a></h3><p>Once the module URI has been registered and if the XSLT processor detects
detectsthat a given stylesheet needs the functionalities of an extended that a given stylesheet needs the functionalities of an extended module, this
module, thisone is initialized.</p><p>The xsltExtInitFunction type defines the interface for an one is initialized.</p><p>The xsltExtInitFunction type defines the interface for an initialization
initializationfunction:</p><pre>/** function:</p><pre>/**
* xsltExtInitFunction: * xsltExtInitFunction:
* @ctxt: an XSLT transformation context * @ctxt: an XSLT transformation context
* @URI: the namespace URI for the extension * @URI: the namespace URI for the extension
@@ -71,30 +72,30 @@ initializationfunction:</p><pre>/**
* transformation * transformation
*/ */
typedef void *(*xsltExtInitFunction)(xsltTransformContextPtr ctxt, typedef void *(*xsltExtInitFunction)(xsltTransformContextPtr ctxt,
const xmlChar *URI);</pre><p>There are 3 things to notice:</p><ul><li>The function gets passed the namespace name URI as an argument. const xmlChar *URI);</pre><p>There are 3 things to notice:</p><ul><li>The function gets passed the namespace name URI as an argument. This
Thisallows a single function to provide the initialization for allows a single function to provide the initialization for multiple
multiplelogical modules.</li> logical modules.</li>
<li>It also gets passed a transformation context. The initialization isdone <li>It also gets passed a transformation context. The initialization is
at run time before any processing occurs on the stylesheet but itwill be done at run time before any processing occurs on the stylesheet but it
invoked separately each time for each transformation.</li> will be invoked separately each time for each transformation.</li>
<li>It returns a pointer. This can be used to store module <li>It returns a pointer. This can be used to store module specific
specificinformation which can be retrieved later when a function or an information which can be retrieved later when a function or an element
elementfrom the extension is used. An obvious example is a connection to from the extension is used. An obvious example is a connection to a
adatabase which should be kept and reused along with the database which should be kept and reused along with the transformation.
transformation.NULL is a perfectly valid return; there is no way to NULL is a perfectly valid return; there is no way to indicate a failure
indicate a failureat this level</li> at this level</li>
</ul><p>What this function is expected to do is:</p><ul><li>prepare the context for this module (like opening the </ul><p>What this function is expected to do is:</p><ul><li>prepare the context for this module (like opening the database
databaseconnection)</li> connection)</li>
<li>register the extensions specific to this module</li> <li>register the extensions specific to this module</li>
</ul><h3><a name="Registerin1" id="Registerin1">Registering an extension function</a></h3><p>There is a single call to do this registration:</p><pre>int xsltRegisterExtFunction(xsltTransformContextPtr ctxt, </ul><h3><a name="Registerin1" id="Registerin1">Registering an extension function</a></h3><p>There is a single call to do this registration:</p><pre>int xsltRegisterExtFunction(xsltTransformContextPtr ctxt,
const xmlChar *name, const xmlChar *name,
const xmlChar *URI, const xmlChar *URI,
xmlXPathEvalFunc function);</pre><p>The registration is bound to a single transformation instance referred xmlXPathEvalFunc function);</pre><p>The registration is bound to a single transformation instance referred by
byctxt, name is the UTF8 encoded name for the NCName of the function, and ctxt, name is the UTF8 encoded name for the NCName of the function, and URI
URIis the namespace name for the extension (no checking is done, a module is the namespace name for the extension (no checking is done, a module could
couldregister functions or elements from a different namespace, but it is register functions or elements from a different namespace, but it is not
notrecommended).</p><h3><a name="Implementi" id="Implementi">Implementing an extension function</a></h3><p>The implementation of the function must have the signature of a recommended).</p><h3><a name="Implementi" id="Implementi">Implementing an extension function</a></h3><p>The implementation of the function must have the signature of a libxml
libxmlXPath function:</p><pre>/** XPath function:</p><pre>/**
* xmlXPathEvalFunc: * xmlXPathEvalFunc:
* @ctxt: an XPath parser context * @ctxt: an XPath parser context
* @nargs: the number of arguments passed to the function * @nargs: the number of arguments passed to the function
@@ -104,43 +105,43 @@ libxmlXPath function:</p><pre>/**
*/ */
typedef void (*xmlXPathEvalFunc)(xmlXPathParserContextPtr ctxt, typedef void (*xmlXPathEvalFunc)(xmlXPathParserContextPtr ctxt,
int nargs);</pre><p>The context passed to an XPath function is not an XSLT context but an <a href="internals.html#XPath1">XPath context</a>. However it is possible tofind int nargs);</pre><p>The context passed to an XPath function is not an XSLT context but an <a href="internals.html#XPath1">XPath context</a>. However it is possible to
one from the other:</p><ul><li>The function xsltXPathGetTransformContext provides this lookup facility: find one from the other:</p><ul><li>The function xsltXPathGetTransformContext provides this lookup facility:
<pre>xsltTransformContextPtr <pre>xsltTransformContextPtr
xsltXPathGetTransformContext xsltXPathGetTransformContext
(xmlXPathParserContextPtr ctxt);</pre> (xmlXPathParserContextPtr ctxt);</pre>
</li> </li>
<li>The <code>xmlXPathContextPtr</code>associated to <li>The <code>xmlXPathContextPtr</code> associated to an
an<code>xsltTransformContext</code>is stored in the <code>xsltTransformContext</code> is stored in the <code>xpathCtxt</code>
<code>xpathCtxt</code>field.</li> field.</li>
</ul><p>The first thing an extension function may want to do is to check </ul><p>The first thing an extension function may want to do is to check the
thearguments passed on the stack, the <code>nargs</code>parameter will tell arguments passed on the stack, the <code>nargs</code> parameter will tell how
howmany of them were provided on the XPath expression. The macro valuePop many of them were provided on the XPath expression. The macro valuePop will
willextract them from the XPath stack:</p><pre>#include &lt;libxml/xpath.h&gt; extract them from the XPath stack:</p><pre>#include &lt;libxml/xpath.h&gt;
#include &lt;libxml/xpathInternals.h&gt; #include &lt;libxml/xpathInternals.h&gt;
xmlXPathObjectPtr obj = valuePop(ctxt); </pre><p>Note that <code>ctxt</code>is the XPath context not the XSLT one. It xmlXPathObjectPtr obj = valuePop(ctxt); </pre><p>Note that <code>ctxt</code> is the XPath context not the XSLT one. It is
isthen possible to examine the content of the value. Check <a href="internals.html#Descriptio">the description of XPath then possible to examine the content of the value. Check <a href="internals.html#Descriptio">the description of XPath objects</a> if
objects</a>ifnecessary. The following is a common sequence checking whether necessary. The following is a common sequence checking whether the argument
the argumentpassed is a string and converting it using the built-in passed is a string and converting it using the built-in XPath
XPath<code>string()</code>function if this is not the case:</p><pre>if (obj-&gt;type != XPATH_STRING) { <code>string()</code> function if this is not the case:</p><pre>if (obj-&gt;type != XPATH_STRING) {
valuePush(ctxt, obj); valuePush(ctxt, obj);
xmlXPathStringFunction(ctxt, 1); xmlXPathStringFunction(ctxt, 1);
obj = valuePop(ctxt); obj = valuePop(ctxt);
}</pre><p>Most common XPath functions are available directly at the C level and }</pre><p>Most common XPath functions are available directly at the C level and are
areexported either in <code>&lt;libxml/xpath.h&gt;</code>or exported either in <code>&lt;libxml/xpath.h&gt;</code> or in
in<code>&lt;libxml/xpathInternals.h&gt;</code>.</p><p>The extension function may also need to retrieve the data associated <code>&lt;libxml/xpathInternals.h&gt;</code>.</p><p>The extension function may also need to retrieve the data associated to
tothis module instance (the database connection in the previous example) this module instance (the database connection in the previous example) this
thiscan be done using the xsltGetExtData:</p><pre>void * xsltGetExtData(xsltTransformContextPtr ctxt, can be done using the xsltGetExtData:</p><pre>void * xsltGetExtData(xsltTransformContextPtr ctxt,
const xmlChar *URI);</pre><p>Again the URI to be provided is the one which was used when registeringthe const xmlChar *URI);</pre><p>Again the URI to be provided is the one which was used when registering
module.</p><p>Once the function finishes, don't forget to:</p><ul><li>push the return value on the stack using the module.</p><p>Once the function finishes, don't forget to:</p><ul><li>push the return value on the stack using <code>valuePush(ctxt,
<code>valuePush(ctxt,obj)</code></li> obj)</code></li>
<li>deallocate the parameters passed to the function <li>deallocate the parameters passed to the function using
using<code>xmlXPathFreeObject(obj)</code></li> <code>xmlXPathFreeObject(obj)</code></li>
</ul><h3><a name="Examples" id="Examples">Examples for extension functions</a></h3><p>The module libxslt/functions.c contains the sources of the XSLT </ul><h3><a name="Examples" id="Examples">Examples for extension functions</a></h3><p>The module libxslt/functions.c contains the sources of the XSLT built-in
built-infunctions, including document(), key(), generate-id(), etc. as well functions, including document(), key(), generate-id(), etc. as well as a full
as a fullexample module at the end. Here is the test function implementation example module at the end. Here is the test function implementation for the
for thelibxslt:test function:</p><pre>/** libxslt:test function:</p><pre>/**
* xsltExtFunctionTest: * xsltExtFunctionTest:
* @ctxt: the XPath Parser context * @ctxt: the XPath Parser context
* @nargs: the number of arguments * @nargs: the number of arguments
@@ -172,14 +173,13 @@ xsltExtFunctionTest(xmlXPathParserContextPtr ctxt, int nargs)
}</pre><h3><a name="Registerin2" id="Registerin2">Registering an extension element</a></h3><p>There is a single call to do this registration:</p><pre>int xsltRegisterExtElement(xsltTransformContextPtr ctxt, }</pre><h3><a name="Registerin2" id="Registerin2">Registering an extension element</a></h3><p>There is a single call to do this registration:</p><pre>int xsltRegisterExtElement(xsltTransformContextPtr ctxt,
const xmlChar *name, const xmlChar *name,
const xmlChar *URI, const xmlChar *URI,
xsltTransformFunction function);</pre><p>It is similar to the mechanism used to register an extension xsltTransformFunction function);</pre><p>It is similar to the mechanism used to register an extension function,
function,except that the signature of an extension element implementation except that the signature of an extension element implementation is
isdifferent.</p><p>The registration is bound to a single transformation instance referred different.</p><p>The registration is bound to a single transformation instance referred to
toby ctxt, name is the UTF8 encoded name for the NCName of the element, and by ctxt, name is the UTF8 encoded name for the NCName of the element, and URI
URIis the namespace name for the extension (no checking is done, a module is the namespace name for the extension (no checking is done, a module could
couldregister elements for a different namespace, but it is not register elements for a different namespace, but it is not recommended).</p><h3><a name="Implementi1" id="Implementi1">Implementing an extension element</a></h3><p>The implementation of the element must have the signature of an XSLT
recommended).</p><h3><a name="Implementi1" id="Implementi1">Implementing an extension element</a></h3><p>The implementation of the element must have the signature of an transformation function:</p><pre>/**
XSLTtransformation function:</p><pre>/**
* xsltTransformFunction: * xsltTransformFunction:
* @ctxt: the XSLT transformation context * @ctxt: the XSLT transformation context
* @node: the input node * @node: the input node
@@ -193,27 +193,27 @@ typedef void (*xsltTransformFunction)
(xsltTransformContextPtr ctxt, (xsltTransformContextPtr ctxt,
xmlNodePtr node, xmlNodePtr node,
xmlNodePtr inst, xmlNodePtr inst,
xsltStylePreCompPtr comp);</pre><p>The first argument is the XSLT transformation context. The second andthird xsltStylePreCompPtr comp);</pre><p>The first argument is the XSLT transformation context. The second and
arguments are xmlNodePtr i.e. internal memory <a href="internals.html#libxml">representation of XML nodes</a>. They third arguments are xmlNodePtr i.e. internal memory <a href="internals.html#libxml">representation of XML nodes</a>. They are
arerespectively <code>node</code>from the the input document being respectively <code>node</code> from the the input document being transformed
transformedby the stylesheet and <code>inst</code>the extension element in by the stylesheet and <code>inst</code> the extension element in the
thestylesheet. The last argument is <code>comp</code>a pointer to a stylesheet. The last argument is <code>comp</code> a pointer to a precompiled
precompiledrepresentation of <code>inst</code>but usually for an extension representation of <code>inst</code> but usually for an extension function
functionthis value is <code>NULL</code>by default (it could be added and this value is <code>NULL</code> by default (it could be added and associated
associatedto the instruction in <code>inst-&gt;_private</code>).</p><p>The same functions are available from a function implementing an to the instruction in <code>inst-&gt;_private</code>).</p><p>The same functions are available from a function implementing an extension
extensionelement as in an extension function, element as in an extension function, including
including<code>xsltGetExtData()</code>.</p><p>The goal of an extension element being usually to enrich the <code>xsltGetExtData()</code>.</p><p>The goal of an extension element being usually to enrich the generated
generatedoutput, it is expected that they will grow the currently generated output, it is expected that they will grow the currently generated output
outputtree. This can be done by grabbing ctxt-&gt;insert which is the tree. This can be done by grabbing ctxt-&gt;insert which is the current
currentlibxml node being generated (Note this can also be the intermediate libxml node being generated (Note this can also be the intermediate value
valuetree being built for example to initialize a variable, the processing tree being built for example to initialize a variable, the processing should
shouldbe similar). The functions for libxml tree manipulation from <a href="http://xmlsoft.org/html/libxml-tree.html">&lt;libxml/tree.h&gt;</a>canbe be similar). The functions for libxml tree manipulation from <a href="http://xmlsoft.org/html/libxml-tree.html">&lt;libxml/tree.h&gt;</a> can
employed to extend or modify the tree, but it is required to preserve be employed to extend or modify the tree, but it is required to preserve the
theinsertion node and its ancestors since there are existing pointers to insertion node and its ancestors since there are existing pointers to those
thoseelements still in use in the XSLT template execution stack.</p><h3><a name="Example" id="Example">Example for extension elements</a></h3><p>The module libxslt/transform.c contains the sources of the XSLT elements still in use in the XSLT template execution stack.</p><h3><a name="Example" id="Example">Example for extension elements</a></h3><p>The module libxslt/transform.c contains the sources of the XSLT built-in
built-inelements, including xsl:element, xsl:attribute, xsl:if, etc. There is elements, including xsl:element, xsl:attribute, xsl:if, etc. There is a small
a smallbut full example in functions.c providing the implementation for but full example in functions.c providing the implementation for the
thelibxslt:test element, it will output a comment in the result tree:</p><pre>/** libxslt:test element, it will output a comment in the result tree:</p><pre>/**
* xsltExtElementTest: * xsltExtElementTest:
* @ctxt: an XSLT processing context * @ctxt: an XSLT processing context
* @node: The current node * @node: The current node
@@ -253,10 +253,10 @@ xsltExtElementTest(xsltTransformContextPtr ctxt, xmlNodePtr node,
xmlNewComment((const xmlChar *) xmlNewComment((const xmlChar *)
"libxslt:test element test worked"); "libxslt:test element test worked");
xmlAddChild(ctxt-&gt;insert, comment); xmlAddChild(ctxt-&gt;insert, comment);
}</pre><h3><a name="shutdown" id="shutdown">The shutdown of a module</a></h3><p>When the XSLT processor ends a transformation, the shutdown function (ifit }</pre><h3><a name="shutdown" id="shutdown">The shutdown of a module</a></h3><p>When the XSLT processor ends a transformation, the shutdown function (if
exists) for each of the modules initialized is called. it exists) for each of the modules initialized is called. The
ThexsltExtShutdownFunction type defines the interface for a xsltExtShutdownFunction type defines the interface for a shutdown
shutdownfunction:</p><pre>/** function:</p><pre>/**
* xsltExtShutdownFunction: * xsltExtShutdownFunction:
* @ctxt: an XSLT transformation context * @ctxt: an XSLT transformation context
* @URI: the namespace URI for the extension * @URI: the namespace URI for the extension
@@ -266,15 +266,14 @@ shutdownfunction:</p><pre>/**
*/ */
typedef void (*xsltExtShutdownFunction) (xsltTransformContextPtr ctxt, typedef void (*xsltExtShutdownFunction) (xsltTransformContextPtr ctxt,
const xmlChar *URI, const xmlChar *URI,
void *data);</pre><p>This is really similar to a module initialization function except a void *data);</pre><p>This is really similar to a module initialization function except a third
thirdargument is passed, it's the value that was returned by the argument is passed, it's the value that was returned by the initialization
initializationfunction. This allows the routine to deallocate resources from function. This allows the routine to deallocate resources from the module for
the module forexample close the connection to the database to keep the same example close the connection to the database to keep the same example.</p><h3><a name="Future" id="Future">Future work</a></h3><p>Well, some of the pieces missing:</p><ul><li>a way to load shared libraries to instantiate new modules</li>
example.</p><h3><a name="Future" id="Future">Future work</a></h3><p>Well, some of the pieces missing:</p><ul><li>a way to load shared libraries to instantiate new modules</li> <li>a better detection of extension functions usage and their registration
<li>a better detection of extension functions usage and their without having to use the extension prefix which ought to be reserved to
registrationwithout having to use the extension prefix which ought to be element extensions.</li>
reserved toelement extensions.</li>
<li>more examples</li> <li>more examples</li>
<li>implementations of the <a href="http://www.exslt.org/">EXSLT</a>commonextension libraries, Thomas <li>implementations of the <a href="http://www.exslt.org/">EXSLT</a> common
Broyer nearly finished implementing them.</li> extension libraries, Thomas Broyer nearly finished implementing them.</li>
</ul><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

24
doc/help.html
View File

@@ -8,18 +8,18 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>How to help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>How to help</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>How to help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>How to help</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>You can help the project in various ways, the best thing to do first is <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>You can help the project in various ways, the best thing to do first is to
tosubscribe to the mailing-list as explained before, check the <a href="http://mail.gnome.org/archives/xslt/">archives </a>and the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Gnome subscribe to the mailing-list as explained before, check the <a href="http://mail.gnome.org/archives/xslt/">archives </a>and the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Gnome bug
bugdatabase:</a>:</p><ol><li>provide patches when you find problems</li> database:</a>:</p><ol><li>provide patches when you find problems</li>
<li>provide the diffs when you port libxslt to a new platform. They may <li>provide the diffs when you port libxslt to a new platform. They may not
notbe integrated in all cases but help pinpointing portability be integrated in all cases but help pinpointing portability problems
problemsand</li> and</li>
<li>provide documentation fixes (either as patches to the code comments <li>provide documentation fixes (either as patches to the code comments or
oras HTML diffs).</li> as HTML diffs).</li>
<li>provide new documentations pieces (translations, examples, etc ...)</li> <li>provide new documentations pieces (translations, examples, etc ...)</li>
<li>Check the TODO file and try to close one of the items</li> <li>Check the TODO file and try to close one of the items</li>
<li>take one of the points raised in the archive or the bug database <li>take one of the points raised in the archive or the bug database and
andprovide a fix. <a href="mailto:daniel@veillard.com">Get in touch with provide a fix. <a href="mailto:daniel@veillard.com">Get in touch with me
me</a>before to avoid synchronization problems and check that the </a>before to avoid synchronization problems and check that the suggested
suggestedfix will fit in nicely :-)</li> fix will fit in nicely :-)</li>
</ol><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ol><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

17
doc/index.html
View File

@@ -8,15 +8,14 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>libxslt</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>libxslt</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>libxslt</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>libxslt</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>Libxslt is the <a href="http://www.w3.org/TR/xslt">XSLT</a>C <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>Libxslt is the <a href="http://www.w3.org/TR/xslt">XSLT</a> C library
librarydeveloped for the Gnome project. XSLT itself is a an XML language to developed for the Gnome project. XSLT itself is a an XML language to define
definetransformation for XML. Libxslt is based on <a href="http://xmlsoft.org/">libxml2</a>the XML C library developed for transformation for XML. Libxslt is based on <a href="http://xmlsoft.org/">libxml2</a> the XML C library developed for the
theGnome project. It also implements most of the <a href="http://www.exslt.org/">EXSLT</a>set of processor-portable Gnome project. It also implements most of the <a href="http://www.exslt.org/">EXSLT</a> set of processor-portable extensions
extensionsfunctions and some of Saxon's evaluate and expressions functions and some of Saxon's evaluate and expressions extensions.</p><p>People can either embed the library in their application or use xsltproc
extensions.</p><p>People can either embed the library in their application or use the command line processing tool. This library is free software and can be
xsltprocthe command line processing tool. This library is free software and reused in commercial applications (see the <a href="intro.html">intro</a>)</p><p>External documents:</p><ul><li>John Fleck wrote <a href="tutorial/libxslttutorial.html">a tutorial for
can bereused in commercial applications (see the <a href="intro.html">intro</a>)</p><p>External documents:</p><ul><li>John Fleck wrote <a href="tutorial/libxslttutorial.html">a tutorial libxslt</a></li>
forlibxslt</a></li>
<li><a href="xsltproc.html">xsltproc user manual</a></li> <li><a href="xsltproc.html">xsltproc user manual</a></li>
<li><a href="http://xmlsoft.org/">the libxml documentation</a></li> <li><a href="http://xmlsoft.org/">the libxml documentation</a></li>
</ul><p></p><p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p></p><p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

449
doc/internals.html
View File

@@ -18,152 +18,152 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="internals.html#processing">The processing itself</a></li> <li><a href="internals.html#processing">The processing itself</a></li>
<li><a href="internals.html#XPath">XPath expressions compilation</a></li> <li><a href="internals.html#XPath">XPath expressions compilation</a></li>
<li><a href="internals.html#XPath1">XPath interpretation</a></li> <li><a href="internals.html#XPath1">XPath interpretation</a></li>
<li><a href="internals.html#Descriptio">Description of XPathObjects</a></li> <li><a href="internals.html#Descriptio">Description of XPath
Objects</a></li>
<li><a href="internals.html#XPath3">XPath functions</a></li> <li><a href="internals.html#XPath3">XPath functions</a></li>
<li><a href="internals.html#stack">The variables stack frame</a></li> <li><a href="internals.html#stack">The variables stack frame</a></li>
<li><a href="internals.html#Extension">Extension support</a></li> <li><a href="internals.html#Extension">Extension support</a></li>
<li><a href="internals.html#Futher">Further reading</a></li> <li><a href="internals.html#Futher">Further reading</a></li>
<li><a href="internals.html#TODOs">TODOs</a></li> <li><a href="internals.html#TODOs">TODOs</a></li>
</ul><h3><a name="Introducti2" id="Introducti2">Introduction</a></h3><p>This document describes the processing of <a href="http://xmlsoft.org/XSLT/">libxslt</a>, the <a href="http://www.w3.org/TR/xslt">XSLT</a>C library developed for the <a href="http://www.gnome.org/">Gnome</a>project.</p><p>Note: this documentation is by definition incomplete and I am not good </ul><h3><a name="Introducti2" id="Introducti2">Introduction</a></h3><p>This document describes the processing of <a href="http://xmlsoft.org/XSLT/">libxslt</a>, the <a href="http://www.w3.org/TR/xslt">XSLT</a> C library developed for the <a href="http://www.gnome.org/">Gnome</a> project.</p><p>Note: this documentation is by definition incomplete and I am not good at
atspelling, grammar, so patches and suggestions are <a href="mailto:veillard@redhat.com">really welcome</a>.</p><h3><a name="Basics1" id="Basics1">Basics</a></h3><p>XSLT is a transformation language. It takes an input document and spelling, grammar, so patches and suggestions are <a href="mailto:veillard@redhat.com">really welcome</a>.</p><h3><a name="Basics1" id="Basics1">Basics</a></h3><p>XSLT is a transformation language. It takes an input document and a
astylesheet document and generates an output document:</p><p align="center"><img src="processing.gif" alt="the XSLT processing model" /></p><p>Libxslt is written in C. It relies on <a href="http://www.xmlsoft.org/">libxml</a>, the XML C library for Gnome, stylesheet document and generates an output document:</p><p align="center"><img src="processing.gif" alt="the XSLT processing model" /></p><p>Libxslt is written in C. It relies on <a href="http://www.xmlsoft.org/">libxml</a>, the XML C library for Gnome, for
forthe following operations:</p><ul><li>parsing files</li> the following operations:</p><ul><li>parsing files</li>
<li>building the in-memory DOM structure associated with the <li>building the in-memory DOM structure associated with the documents
documentshandled</li> handled</li>
<li>the XPath implementation</li> <li>the XPath implementation</li>
<li>serializing back the result document to XML and HTML. (Text is <li>serializing back the result document to XML and HTML. (Text is handled
handleddirectly.)</li> directly.)</li>
</ul><h3><a name="Keep1" id="Keep1">Keep it simple stupid</a></h3><p>Libxslt is not very specialized. It is built under the assumption that </ul><h3><a name="Keep1" id="Keep1">Keep it simple stupid</a></h3><p>Libxslt is not very specialized. It is built under the assumption that all
allnodes from the source and output document can fit in the virtual memory nodes from the source and output document can fit in the virtual memory of
ofthe system. There is a big trade-off there. It is fine for reasonably the system. There is a big trade-off there. It is fine for reasonably sized
sizeddocuments but may not be suitable for large sets of data. The gain is documents but may not be suitable for large sets of data. The gain is that it
that itcan be used in a relatively versatile way. The input or output may can be used in a relatively versatile way. The input or output may never be
never beserialized, but the size of documents it can handle are limited by serialized, but the size of documents it can handle are limited by the size
the sizeof the memory available.</p><p>More specialized memory handling approaches are possible, like buildingthe of the memory available.</p><p>More specialized memory handling approaches are possible, like building
input tree from a serialization progressively as it is consumed,factoring the input tree from a serialization progressively as it is consumed,
repetitive patterns, or even on-the-fly generation of the output asthe input factoring repetitive patterns, or even on-the-fly generation of the output as
is parsed but it is possible only for a limited subset of thestylesheets. In the input is parsed but it is possible only for a limited subset of the
general the implementation of libxslt follows the followingpattern:</p><ul><li>KISS (keep it simple stupid)</li> stylesheets. In general the implementation of libxslt follows the following
<li>when there is a clear bottleneck optimize on top of this pattern:</p><ul><li>KISS (keep it simple stupid)</li>
simpleframework and refine only as much as is needed to reach the <li>when there is a clear bottleneck optimize on top of this simple
expectedresult</li> framework and refine only as much as is needed to reach the expected
</ul><p>The result is not that bad, clearly one can do a better job but result</li>
morespecialized too. Most optimization like building the tree on-demand </ul><p>The result is not that bad, clearly one can do a better job but more
wouldneed serious changes to the libxml XPath framework. An easy step would specialized too. Most optimization like building the tree on-demand would
be toserialize the output directly (or call a set of SAX-like output handler need serious changes to the libxml XPath framework. An easy step would be to
tokeep this a flexible interface) and hence avoid the memory consumption of serialize the output directly (or call a set of SAX-like output handler to
theresult.</p><h3><a name="libxml" id="libxml">The libxml nodes</a></h3><p>DOM-like trees, as used and generated by libxml and libxslt, arerelatively keep this a flexible interface) and hence avoid the memory consumption of the
complex. Most node types follow the given structure except a fewvariations result.</p><h3><a name="libxml" id="libxml">The libxml nodes</a></h3><p>DOM-like trees, as used and generated by libxml and libxslt, are
depending on the node type:</p><p align="center"><img src="node.gif" alt="description of a libxml node" /></p><p>Nodes carry a <strong>name</strong>and the node relatively complex. Most node types follow the given structure except a few
<strong>type</strong>indicates the kind of node it represents, the most variations depending on the node type:</p><p align="center"><img src="node.gif" alt="description of a libxml node" /></p><p>Nodes carry a <strong>name</strong> and the node <strong>type</strong>
common ones are:</p><ul><li>document nodes</li> indicates the kind of node it represents, the most common ones are:</p><ul><li>document nodes</li>
<li>element nodes</li> <li>element nodes</li>
<li>text nodes</li> <li>text nodes</li>
</ul><p>For the XSLT processing, entity nodes should not be generated (i.e. </ul><p>For the XSLT processing, entity nodes should not be generated (i.e. they
theyshould be replaced by their content). Most nodes also contains the should be replaced by their content). Most nodes also contains the following
following"navigation" informations:</p><ul><li>the containing <strong>doc</strong>ument</li> "navigation" informations:</p><ul><li>the containing <strong>doc</strong>ument</li>
<li>the <strong>parent</strong> node</li> <li>the <strong>parent</strong> node</li>
<li>the first <strong>children</strong> node</li> <li>the first <strong>children</strong> node</li>
<li>the <strong>last</strong> children node</li> <li>the <strong>last</strong> children node</li>
<li>the <strong>prev</strong>ious sibling</li> <li>the <strong>prev</strong>ious sibling</li>
<li>the following sibling (<strong>next</strong>)</li> <li>the following sibling (<strong>next</strong>)</li>
</ul><p>Elements nodes carries the list of attributes in the properties, </ul><p>Elements nodes carries the list of attributes in the properties, an
anattribute itself holds the navigation pointers and the children list attribute itself holds the navigation pointers and the children list (the
(theattribute value is not represented as a simple string to allow usage attribute value is not represented as a simple string to allow usage of
ofentities references).</p><p>The <strong>ns</strong>points to the namespace declaration for entities references).</p><p>The <strong>ns</strong> points to the namespace declaration for the
thenamespace associated to the node, <strong>nsDef</strong>is the linked namespace associated to the node, <strong>nsDef</strong> is the linked list
listof namespace declaration present on element nodes.</p><p>Most nodes also carry an <strong>_private</strong>pointer which can beused of namespace declaration present on element nodes.</p><p>Most nodes also carry an <strong>_private</strong> pointer which can be
by the application to hold specific data on this node.</p><h3><a name="XSLT" id="XSLT">The XSLT processing steps</a></h3><p>There are a few steps which are clearly decoupled at the used by the application to hold specific data on this node.</p><h3><a name="XSLT" id="XSLT">The XSLT processing steps</a></h3><p>There are a few steps which are clearly decoupled at the interface
interfacelevel:</p><ol><li>parse the stylesheet and generate a DOM tree</li> level:</p><ol><li>parse the stylesheet and generate a DOM tree</li>
<li>take the stylesheet tree and build a compiled version of it <li>take the stylesheet tree and build a compiled version of it (the
(thecompilation phase)</li> compilation phase)</li>
<li>take the input and generate a DOM tree</li> <li>take the input and generate a DOM tree</li>
<li>process the stylesheet against the input tree and generate an <li>process the stylesheet against the input tree and generate an output
outputtree</li> tree</li>
<li>serialize the output tree</li> <li>serialize the output tree</li>
</ol><p>A few things should be noted here:</p><ul><li>the steps 1/ 3/ and 5/ are optional</li> </ol><p>A few things should be noted here:</p><ul><li>the steps 1/ 3/ and 5/ are optional</li>
<li>the stylesheet obtained at 2/ can be reused by multiple processing <li>the stylesheet obtained at 2/ can be reused by multiple processing 4/
4/(and this should also work in threaded programs)</li> (and this should also work in threaded programs)</li>
<li>the tree provided in 2/ should never be freed using xmlFreeDoc, but <li>the tree provided in 2/ should never be freed using xmlFreeDoc, but by
byfreeing the stylesheet.</li> freeing the stylesheet.</li>
<li>the input tree 4/ is not modified except the _private field which maybe <li>the input tree 4/ is not modified except the _private field which may
used for labelling keys if used by the stylesheet</li> be used for labelling keys if used by the stylesheet</li>
</ul><h3><a name="XSLT1" id="XSLT1">The XSLT stylesheet compilation</a></h3><p>This is the second step described. It takes a stylesheet tree, </ul><h3><a name="XSLT1" id="XSLT1">The XSLT stylesheet compilation</a></h3><p>This is the second step described. It takes a stylesheet tree, and
and"compiles" it. This associates to each node a structure stored in "compiles" it. This associates to each node a structure stored in the
the_private field and containing information computed in the stylesheet:</p><p align="center"><img src="stylesheet.gif" alt="a compiled XSLT stylesheet" /></p><p>One xsltStylesheet structure is generated per document parsed for _private field and containing information computed in the stylesheet:</p><p align="center"><img src="stylesheet.gif" alt="a compiled XSLT stylesheet" /></p><p>One xsltStylesheet structure is generated per document parsed for the
thestylesheet. XSLT documents allow includes and imports of other stylesheet. XSLT documents allow includes and imports of other documents,
documents,imports are stored in the <strong>imports</strong>list (hence imports are stored in the <strong>imports</strong> list (hence keeping the
keeping thetree hierarchy of includes which is very important for a proper tree hierarchy of includes which is very important for a proper XSLT
XSLTprocessing model) and includes are stored in the processing model) and includes are stored in the <strong>doclist</strong>
<strong>doclist</strong>list. An imported stylesheet has a parent link to list. An imported stylesheet has a parent link to allow browsing of the
allow browsing of thetree.</p><p>The DOM tree associated to the document is stored in tree.</p><p>The DOM tree associated to the document is stored in <strong>doc</strong>.
<strong>doc</strong>.It is preprocessed to remove ignorable empty nodes and It is preprocessed to remove ignorable empty nodes and all the nodes in the
all the nodes in theXSLT namespace are subject to precomputing. This usually XSLT namespace are subject to precomputing. This usually consist of
consist ofextracting all the context information from the context tree extracting all the context information from the context tree (attributes,
(attributes,namespaces, XPath expressions), and storing them in an namespaces, XPath expressions), and storing them in an xsltStylePreComp
xsltStylePreCompstructure associated to the <strong>_private</strong>field of structure associated to the <strong>_private</strong> field of the node.</p><p>A couple of notable exceptions to this are XSLT template nodes (more on
the node.</p><p>A couple of notable exceptions to this are XSLT template nodes (more this later) and attribute value templates. If they are actually templates,
onthis later) and attribute value templates. If they are actually the value cannot be computed at compilation time. (Some preprocessing could
templates,the value cannot be computed at compilation time. (Some be done like isolation and preparsing of the XPath subexpressions but it's
preprocessing couldbe done like isolation and preparsing of the XPath not done, yet.)</p><p>The xsltStylePreComp structure also allows storing of the precompiled form
subexpressions but it'snot done, yet.)</p><p>The xsltStylePreComp structure also allows storing of the precompiled of an XPath expression that can be associated to an XSLT element (more on
formof an XPath expression that can be associated to an XSLT element (more this later).</p><h3><a name="XSLT2" id="XSLT2">The XSLT template compilation</a></h3><p>A proper handling of templates lookup is one of the keys of fast XSLT
onthis later).</p><h3><a name="XSLT2" id="XSLT2">The XSLT template compilation</a></h3><p>A proper handling of templates lookup is one of the keys of fast processing. (Given a node in the source document this is the process of
XSLTprocessing. (Given a node in the source document this is the process finding which templates should be applied to this node.) Libxslt follows the
offinding which templates should be applied to this node.) Libxslt follows hint suggested in the <a href="http://www.w3.org/TR/xslt#patterns">5.2
thehint suggested in the <a href="http://www.w3.org/TR/xslt#patterns">5.2Patterns</a>section of the XSLT Patterns</a> section of the XSLT Recommendation, i.e. it doesn't evaluate it
Recommendation, i.e. it doesn't evaluate itas an XPath expression but as an XPath expression but tokenizes it and compiles it as a set of rules to
tokenizes it and compiles it as a set of rules tobe evaluated on a candidate be evaluated on a candidate node. There usually is an indication of the node
node. There usually is an indication of the nodename in the last step of this name in the last step of this evaluation and this is used as a key check for
evaluation and this is used as a key check forthe match. As a result libxslt the match. As a result libxslt builds a relatively more complex set of
builds a relatively more complex set ofstructures for the templates:</p><p align="center"><img src="templates.gif" alt="The templates related structure" /></p><p>Let's describe a bit more closely what is built. First the structures for the templates:</p><p align="center"><img src="templates.gif" alt="The templates related structure" /></p><p>Let's describe a bit more closely what is built. First the xsltStylesheet
xsltStylesheetstructure holds a pointer to the template hash table. All the structure holds a pointer to the template hash table. All the XSLT patterns
XSLT patternscompiled in this stylesheet are indexed by the value of the the compiled in this stylesheet are indexed by the value of the the target
targetelement (or attribute, pi ...) name, so when a element or an attribute element (or attribute, pi ...) name, so when a element or an attribute "foo"
"foo"needs to be processed the lookup is done using the name as a key.</p><p>Each of the patterns is compiled into an xsltCompMatch structure. It needs to be processed the lookup is done using the name as a key.</p><p>Each of the patterns is compiled into an xsltCompMatch structure. It holds
holdsthe set of rules based on the tokenization of the pattern stored in the set of rules based on the tokenization of the pattern stored in reverse
reverseorder (matching is easier this way). It also holds some information order (matching is easier this way). It also holds some information about the
about theprevious matches used to speed up the process when one iterates over previous matches used to speed up the process when one iterates over a set of
a set ofsiblings. (This optimization may be defeated by trashing when siblings. (This optimization may be defeated by trashing when running
runningthreaded computation, it's unclear that this is a big deal in threaded computation, it's unclear that this is a big deal in practice.)
practice.)Predicate expressions are not compiled at this stage, they may be Predicate expressions are not compiled at this stage, they may be at run-time
at run-timeif needed, but in this case they are compiled as full XPath if needed, but in this case they are compiled as full XPath expressions (the
expressions (theuse of some fixed predicate can probably be optimized, they use of some fixed predicate can probably be optimized, they are not yet).</p><p>The xsltCompMatch are then stored in the hash table, the clash list is
are not yet).</p><p>The xsltCompMatch are then stored in the hash table, the clash list itself sorted by priority of the template to implement "naturally" the XSLT
isitself sorted by priority of the template to implement "naturally" the priority rules.</p><p>Associated to the compiled pattern is the xsltTemplate itself containing
XSLTpriority rules.</p><p>Associated to the compiled pattern is the xsltTemplate itself the information required for the processing of the pattern including, of
containingthe information required for the processing of the pattern course, a pointer to the list of elements used for building the pattern
including, ofcourse, a pointer to the list of elements used for building the result.</p><p>Last but not least a number of patterns do not fit in the hash table
patternresult.</p><p>Last but not least a number of patterns do not fit in the hash because they are not associated to a name, this is the case for patterns
tablebecause they are not associated to a name, this is the case for applying to the root, any element, any attributes, text nodes, pi nodes, keys
patternsapplying to the root, any element, any attributes, text nodes, pi etc. Those are stored independently in the stylesheet structure as separate
nodes, keysetc. Those are stored independently in the stylesheet structure as linked lists of xsltCompMatch.</p><h3><a name="processing" id="processing">The processing itself</a></h3><p>The processing is defined by the XSLT specification (the basis of the
separatelinked lists of xsltCompMatch.</p><h3><a name="processing" id="processing">The processing itself</a></h3><p>The processing is defined by the XSLT specification (the basis of algorithm is explained in <a href="http://www.w3.org/TR/xslt#section-Introduction">the Introduction</a>
thealgorithm is explained in <a href="http://www.w3.org/TR/xslt#section-Introduction">the section). Basically it works by taking the root of the input document and
Introduction</a>section). Basically it works by taking the root of the input applying the following algorithm:</p><ol><li>Finding the template applying to it. This is a lookup in the template
document andapplying the following algorithm:</p><ol><li>Finding the template applying to it. This is a lookup in the hash table, walking the hash list until the node satisfies all the steps
templatehash table, walking the hash list until the node satisfies all of the pattern, then checking the appropriate(s) global templates to see
the stepsof the pattern, then checking the appropriate(s) global if there isn't a higher priority rule to apply</li>
templates to seeif there isn't a higher priority rule to apply</li> <li>If there is no template, apply the default rule (recurse on the
<li>If there is no template, apply the default rule (recurse on children)</li>
thechildren)</li>
<li>else walk the content list of the selected templates, for each of them: <li>else walk the content list of the selected templates, for each of them:
<ul><li>if the node is in the XSLT namespace then the node has a <ul><li>if the node is in the XSLT namespace then the node has a _private
_privatefield pointing to the preprocessed values, jump to the field pointing to the preprocessed values, jump to the specific
specificcode</li> code</li>
<li>if the node is in an extension namespace, look up the <li>if the node is in an extension namespace, look up the associated
associatedbehavior</li> behavior</li>
<li>otherwise copy the node.</li> <li>otherwise copy the node.</li>
</ul><p>The closure is usually done through the </ul><p>The closure is usually done through the XSLT
XSLT<strong>apply-templates</strong>construct recursing by applying <strong>apply-templates</strong> construct recursing by applying the
theadequate template on the input node children or on the result of adequate template on the input node children or on the result of an
anassociated XPath selection lookup.</p> associated XPath selection lookup.</p>
</li> </li>
</ol><p>Note that large parts of the input tree may not be processed by a </ol><p>Note that large parts of the input tree may not be processed by a given
givenstylesheet and that on the opposite some may be processed multiple stylesheet and that on the opposite some may be processed multiple times.
times.(This often is the case when a Table of Contents is built).</p><p>The module <code>transform.c</code>is the one implementing most of (This often is the case when a Table of Contents is built).</p><p>The module <code>transform.c</code> is the one implementing most of this
thislogic. <strong>xsltApplyStylesheet()</strong>is the entry point, logic. <strong>xsltApplyStylesheet()</strong> is the entry point, it
itallocates an xsltTransformContext containing the following:</p><ul><li>a pointer to the stylesheet being processed</li> allocates an xsltTransformContext containing the following:</p><ul><li>a pointer to the stylesheet being processed</li>
<li>a stack of templates</li> <li>a stack of templates</li>
<li>a stack of variables and parameters</li> <li>a stack of variables and parameters</li>
<li>an XPath context</li> <li>an XPath context</li>
@@ -173,18 +173,18 @@ itallocates an xsltTransformContext containing the following:</p><ul><li>a point
<li>current selected node list</li> <li>current selected node list</li>
<li>the current insertion points in the output document</li> <li>the current insertion points in the output document</li>
<li>a couple of hash tables for extension elements and functions</li> <li>a couple of hash tables for extension elements and functions</li>
</ul><p>Then a new document gets allocated (HTML or XML depending on the type </ul><p>Then a new document gets allocated (HTML or XML depending on the type of
ofoutput), the user parameters and global variables and parameters output), the user parameters and global variables and parameters are
areevaluated. Then <strong>xsltProcessOneNode()</strong>which implements evaluated. Then <strong>xsltProcessOneNode()</strong> which implements the
the1-2-3 algorithm is called on the root element of the input. Step 1/ 1-2-3 algorithm is called on the root element of the input. Step 1/ is
isimplemented by calling <strong>xsltGetTemplate()</strong>, step 2/ implemented by calling <strong>xsltGetTemplate()</strong>, step 2/ is
isimplemented by <strong>xsltDefaultProcessOneNode()</strong>and step 3/ implemented by <strong>xsltDefaultProcessOneNode()</strong> and step 3/ is
isimplemented by <strong>xsltApplyOneTemplate()</strong>.</p><h3><a name="XPath" id="XPath">XPath expression compilation</a></h3><p>The XPath support is actually implemented in the libxml module (where itis implemented by <strong>xsltApplyOneTemplate()</strong>.</p><h3><a name="XPath" id="XPath">XPath expression compilation</a></h3><p>The XPath support is actually implemented in the libxml module (where it
reused by the XPointer implementation). XPath is a relatively is reused by the XPointer implementation). XPath is a relatively classic
classicexpression language. The only uncommon feature is that it is working expression language. The only uncommon feature is that it is working on XML
on XMLtrees and hence has specific syntax and types to handle them.</p><p>XPath expressions are compiled using <strong>xmlXPathCompile()</strong>.It trees and hence has specific syntax and types to handle them.</p><p>XPath expressions are compiled using <strong>xmlXPathCompile()</strong>.
will take an expression string in input and generate a structurecontaining It will take an expression string in input and generate a structure
the parsed expression tree, for example the expression:</p><pre>/doc/chapter[title='Introduction']</pre><p>will be compiled as</p><pre>Compiled Expression : 10 elements containing the parsed expression tree, for example the expression:</p><pre>/doc/chapter[title='Introduction']</pre><p>will be compiled as</p><pre>Compiled Expression : 10 elements
SORT SORT
COLLECT 'child' 'name' 'node' chapter COLLECT 'child' 'name' 'node' chapter
COLLECT 'child' 'name' 'node' doc COLLECT 'child' 'name' 'node' doc
@@ -196,96 +196,97 @@ the parsed expression tree, for example the expression:</p><pre>/doc/chapter[tit
NODE NODE
ELEM Object is a string : Introduction ELEM Object is a string : Introduction
COLLECT 'child' 'name' 'node' title COLLECT 'child' 'name' 'node' title
NODE</pre><p>This can be tested using the <code>testXPath</code>command (in thelibxml NODE</pre><p>This can be tested using the <code>testXPath</code> command (in the
codebase) using the <code>--tree</code>option.</p><p>Again, the KISS approach is used. No optimization is done. This could bean libxml codebase) using the <code>--tree</code> option.</p><p>Again, the KISS approach is used. No optimization is done. This could be
interesting thing to add. <a href="http://www-106.ibm.com/developerworks/library/x-xslt2/?dwzone=x?open&amp;l=132%2ct=gr%2c+p=saxon">MichaelKay an interesting thing to add. <a href="http://www-106.ibm.com/developerworks/library/x-xslt2/?dwzone=x?open&amp;l=132%2ct=gr%2c+p=saxon">Michael
describes</a>a lot of possible and interesting optimizations done inSaxon Kay describes</a> a lot of possible and interesting optimizations done in
which would be possible at this level. I'm unsure they would providemuch gain Saxon which would be possible at this level. I'm unsure they would provide
since the expressions tends to be relatively simple in general andstylesheets much gain since the expressions tends to be relatively simple in general and
are still hand generated. Optimizations at the interpretationsounds likely to stylesheets are still hand generated. Optimizations at the interpretation
be more efficient.</p><h3><a name="XPath1" id="XPath1">XPath interpretation</a></h3><p>The interpreter is implemented by sounds likely to be more efficient.</p><h3><a name="XPath1" id="XPath1">XPath interpretation</a></h3><p>The interpreter is implemented by <strong>xmlXPathCompiledEval()</strong>
<strong>xmlXPathCompiledEval()</strong>which is the front-end to which is the front-end to <strong>xmlXPathCompOpEval()</strong> the function
<strong>xmlXPathCompOpEval()</strong>the functionimplementing the evaluation implementing the evaluation of the expression tree. This evaluation follows
of the expression tree. This evaluation followsthe KISS approach again. It's the KISS approach again. It's recursive and calls
recursive and calls<strong>xmlXPathNodeCollectAndTest()</strong>to collect <strong>xmlXPathNodeCollectAndTest()</strong> to collect nodes set when
nodes set whenevaluating a <code>COLLECT</code>node.</p><p>An evaluation is done within the framework of an XPath context stored inan evaluating a <code>COLLECT</code> node.</p><p>An evaluation is done within the framework of an XPath context stored in
<strong>xmlXPathContext</strong>structure, in the framework of an <strong>xmlXPathContext</strong> structure, in the framework of a
atransformation the context is maintained within the XSLT context. Its transformation the context is maintained within the XSLT context. Its content
contentfollows the requirements from the XPath specification:</p><ul><li>the current document</li> follows the requirements from the XPath specification:</p><ul><li>the current document</li>
<li>the current node</li> <li>the current node</li>
<li>a hash table of defined variables (but not used by XSLT)</li> <li>a hash table of defined variables (but not used by XSLT)</li>
<li>a hash table of defined functions</li> <li>a hash table of defined functions</li>
<li>the proximity position (the place of the node in the current <li>the proximity position (the place of the node in the current node
nodelist)</li> list)</li>
<li>the context size (the size of the current node list)</li> <li>the context size (the size of the current node list)</li>
<li>the array of namespace declarations in scope (there also is a <li>the array of namespace declarations in scope (there also is a namespace
namespacehash table but it is not used in the XSLT transformation).</li> hash table but it is not used in the XSLT transformation).</li>
</ul><p>For the purpose of XSLT an <strong>extra</strong>pointer has been </ul><p>For the purpose of XSLT an <strong>extra</strong> pointer has been added
addedallowing to retrieve the XSLT transformation context. When an allowing to retrieve the XSLT transformation context. When an XPath
XPathevaluation is about to be performed, an XPath parser context is evaluation is about to be performed, an XPath parser context is allocated
allocatedcontaining and XPath object stack (this is actually an XPath containing and XPath object stack (this is actually an XPath evaluation
evaluationcontext, this is a remain of the time where there was no separate context, this is a remain of the time where there was no separate parsing and
parsing andevaluation phase in the XPath implementation). Here is an overview evaluation phase in the XPath implementation). Here is an overview of the set
of the setof contexts associated to an XPath evaluation within an of contexts associated to an XPath evaluation within an XSLT
XSLTtransformation:</p><p align="center"><img src="contexts.gif" alt="The set of contexts associated " /></p><p>Clearly this is a bit too complex and confusing and should be refactoredat transformation:</p><p align="center"><img src="contexts.gif" alt="The set of contexts associated " /></p><p>Clearly this is a bit too complex and confusing and should be refactored
the next set of binary incompatible releases of libxml. For example at the next set of binary incompatible releases of libxml. For example the
thexmlXPathCtxt has a lot of unused parts and should probably be merged xmlXPathCtxt has a lot of unused parts and should probably be merged with
withxmlXPathParserCtxt.</p><h3><a name="Descriptio" id="Descriptio">Description of XPath Objects</a></h3><p>An XPath expression manipulates XPath objects. XPath defines the xmlXPathParserCtxt.</p><h3><a name="Descriptio" id="Descriptio">Description of XPath Objects</a></h3><p>An XPath expression manipulates XPath objects. XPath defines the default
defaulttypes boolean, numbers, strings and node sets. XSLT adds the result types boolean, numbers, strings and node sets. XSLT adds the result tree
treefragment type which is basically an unmodifiable node set.</p><p>Implementation-wise, libxml follows again a KISS approach, fragment type which is basically an unmodifiable node set.</p><p>Implementation-wise, libxml follows again a KISS approach, the
thexmlXPathObject is a structure containing a type description and the xmlXPathObject is a structure containing a type description and the various
variouspossibilities. (Using an enum could have gained some bytes.) In the possibilities. (Using an enum could have gained some bytes.) In the case of
case ofnode sets (or result tree fragments), it points to a separate node sets (or result tree fragments), it points to a separate xmlNodeSet
xmlNodeSetobject which contains the list of pointers to the document object which contains the list of pointers to the document nodes:</p><p align="center"><img src="object.gif" alt="An Node set object pointing to " /></p><p>The <a href="http://xmlsoft.org/html/libxml-xpath.html">XPath API</a> (and
nodes:</p><p align="center"><img src="object.gif" alt="An Node set object pointing to " /></p><p>The <a href="http://xmlsoft.org/html/libxml-xpath.html">XPath its <a href="http://xmlsoft.org/html/libxml-xpathinternals.html">'internal'
API</a>(andits <a href="http://xmlsoft.org/html/libxml-xpathinternals.html">'internal'part</a>) part</a>) includes a number of functions to create, copy, compare, convert or
includes a number of functions to create, copy, compare, convert orfree XPath free XPath objects.</p><h3><a name="XPath3" id="XPath3">XPath functions</a></h3><p>All the XPath functions available to the interpreter are registered in the
objects.</p><h3><a name="XPath3" id="XPath3">XPath functions</a></h3><p>All the XPath functions available to the interpreter are registered in function hash table linked from the XPath context. They all share the same
thefunction hash table linked from the XPath context. They all share the signature:</p><pre>void xmlXPathFunc (xmlXPathParserContextPtr ctxt, int nargs);</pre><p>The first argument is the XPath interpretation context, holding the
samesignature:</p><pre>void xmlXPathFunc (xmlXPathParserContextPtr ctxt, int nargs);</pre><p>The first argument is the XPath interpretation context, holding interpretation stack. The second argument defines the number of objects
theinterpretation stack. The second argument defines the number of passed on the stack for the function to consume (last argument is on top of
objectspassed on the stack for the function to consume (last argument is on the stack).</p><p>Basically an XPath function does the following:</p><ul><li>check <code>nargs</code> for proper handling of errors or functions
top ofthe stack).</p><p>Basically an XPath function does the following:</p><ul><li>check <code>nargs</code>for proper handling of errors or functionswith with variable numbers of parameters</li>
variable numbers of parameters</li> <li>pop the parameters from the stack using <code>obj =
<li>pop the parameters from the stack using <code>obj valuePop(ctxt);</code></li>
=valuePop(ctxt);</code></li>
<li>do the function specific computation</li> <li>do the function specific computation</li>
<li>push the result parameter on the stack using <li>push the result parameter on the stack using <code>valuePush(ctxt,
<code>valuePush(ctxt,res);</code></li> res);</code></li>
<li>free up the input parameters <li>free up the input parameters with
with<code>xmlXPathFreeObject(obj);</code></li> <code>xmlXPathFreeObject(obj);</code></li>
<li>return</li> <li>return</li>
</ul><p>Sometime the work can be done directly by modifying in-situ the top </ul><p>Sometime the work can be done directly by modifying in-situ the top object
objecton the stack <code>ctxt-&gt;value</code>.</p><h3><a name="stack" id="stack">The XSLT variables stack frame</a></h3><p>Not to be confused with XPath object stack, this stack holds the on the stack <code>ctxt-&gt;value</code>.</p><h3><a name="stack" id="stack">The XSLT variables stack frame</a></h3><p>Not to be confused with XPath object stack, this stack holds the XSLT
XSLTvariables and parameters as they are defined through the recursive calls variables and parameters as they are defined through the recursive calls of
ofcall-template, apply-templates and default templates. This is used to call-template, apply-templates and default templates. This is used to define
definethe scope of variables being called.</p><p>This part seems to be the most urgent attention right now, first it isdone the scope of variables being called.</p><p>This part seems to be the most urgent attention right now, first it is
in a very inefficient way since the location of the variables andparameters done in a very inefficient way since the location of the variables and
within the stylesheet tree is still done at run time (it reallyshould be done parameters within the stylesheet tree is still done at run time (it really
statically at compile time), and I am still unsure that myunderstanding of should be done statically at compile time), and I am still unsure that my
the template variables and parameter scope is actuallyright.</p><p>This part of the documentation is still to be written once this part ofthe understanding of the template variables and parameter scope is actually
code will be stable. <span style="background-color: #FF0000">TODO</span></p><h3><a name="Extension" id="Extension">Extension support</a></h3><p>There is a separate document explaining <a href="extensions.html">how right.</p><p>This part of the documentation is still to be written once this part of
theextension support works</a>.</p><h3><a name="Futher" id="Futher">Further reading</a></h3><p>Michael Kay wrote <a href="http://www-106.ibm.com/developerworks/library/x-xslt2/?dwzone=x?open&amp;l=132%2ct=gr%2c+p=saxon">areally the code will be stable. <span style="background-color: #FF0000">TODO</span></p><h3><a name="Extension" id="Extension">Extension support</a></h3><p>There is a separate document explaining <a href="extensions.html">how the
interesting article on Saxon internals</a>and the work he did onperformance extension support works</a>.</p><h3><a name="Futher" id="Futher">Further reading</a></h3><p>Michael Kay wrote <a href="http://www-106.ibm.com/developerworks/library/x-xslt2/?dwzone=x?open&amp;l=132%2ct=gr%2c+p=saxon">a
issues. I wishes I had read it before starting libxslt design (Iwould really interesting article on Saxon internals</a> and the work he did on
probably have avoided a few mistakes and progressed faster). A lot ofthe performance issues. I wishes I had read it before starting libxslt design (I
ideas in his papers should be implemented or at least tried inlibxslt.</p><p>The <a href="http://xmlsoft.org/">libxml documentation</a>, especially <a href="http://xmlsoft.org/xmlio.html">the I/O interfaces</a>and the <a href="http://xmlsoft.org/xmlmem.html">memory management</a>.</p><h3><a name="TODOs" id="TODOs">TODOs</a></h3><p>redesign the XSLT stack frame handling. Far too much work is done would probably have avoided a few mistakes and progressed faster). A lot of
atexecution time. Similarly for the attribute value templates handling, the ideas in his papers should be implemented or at least tried in
atleast the embedded subexpressions ought to be precompiled.</p><p>Allow output to be saved to a SAX like output (this notion of SAX like libxslt.</p><p>The <a href="http://xmlsoft.org/">libxml documentation</a>, especially <a href="http://xmlsoft.org/xmlio.html">the I/O interfaces</a> and the <a href="http://xmlsoft.org/xmlmem.html">memory management</a>.</p><h3><a name="TODOs" id="TODOs">TODOs</a></h3><p>redesign the XSLT stack frame handling. Far too much work is done at
APIfor output should be added directly to libxml).</p><p>Implement and test some of the optimization explained by Michael execution time. Similarly for the attribute value templates handling, at
Kayespecially:</p><ul><li>static slot allocation on the stack frame</li> least the embedded subexpressions ought to be precompiled.</p><p>Allow output to be saved to a SAX like output (this notion of SAX like API
for output should be added directly to libxml).</p><p>Implement and test some of the optimization explained by Michael Kay
especially:</p><ul><li>static slot allocation on the stack frame</li>
<li>specific boolean interpretation of an XPath expression</li> <li>specific boolean interpretation of an XPath expression</li>
<li>some of the sorting optimization</li> <li>some of the sorting optimization</li>
<li>Lazy evaluation of location path. (this may require more changes <li>Lazy evaluation of location path. (this may require more changes but
butsounds really interesting. XT does this too.)</li> sounds really interesting. XT does this too.)</li>
<li>Optimization of an expression tree (This could be done as a <li>Optimization of an expression tree (This could be done as a completely
completelyindependent module.)</li> independent module.)</li>
</ul><p></p><p>Error reporting, there is a lot of case where the XSLT </ul><p></p><p>Error reporting, there is a lot of case where the XSLT specification
specificationspecify that a given construct is an error are not checked specify that a given construct is an error are not checked adequately by
adequately bylibxslt. Basically one should do a complete pass on the XSLT libxslt. Basically one should do a complete pass on the XSLT spec again and
spec again andadd all tests to the stylesheet compilation. Using the DTD add all tests to the stylesheet compilation. Using the DTD provided in the
provided in theappendix and making direct checks using the libxml validation appendix and making direct checks using the libxml validation API sounds a
API sounds agood idea too (though one should take care of not raising errors good idea too (though one should take care of not raising errors for
forelements/attributes in different namespaces).</p><p>Double check all the places where the stylesheet compiled form might elements/attributes in different namespaces).</p><p>Double check all the places where the stylesheet compiled form might be
bemodified at run time (extra removal of blanks nodes, hint on modified at run time (extra removal of blanks nodes, hint on the
thexsltCompMatch).</p><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> xsltCompMatch).</p><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

22
doc/intro.html
View File

@@ -8,14 +8,16 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>Introduction</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Introduction</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>Introduction</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Introduction</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>This document describes <a href="http://xmlsoft.org/XSLT/">libxslt</a>,the <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>This document describes <a href="http://xmlsoft.org/XSLT/">libxslt</a>,
<a href="http://www.w3.org/TR/xslt">XSLT</a>C library developed for the<a href="http://www.gnome.org/">Gnome</a>project.</p><p>Here are some key points about libxslt:</p><ul><li>Libxslt is a C implementation</li> the <a href="http://www.w3.org/TR/xslt">XSLT</a> C library developed for the
<li>Libxslt is based on libxml for XML parsing, tree manipulation and <a href="http://www.gnome.org/">Gnome</a> project.</p><p>Here are some key points about libxslt:</p><ul><li>Libxslt is a C implementation</li>
XPathsupport</li> <li>Libxslt is based on libxml for XML parsing, tree manipulation and XPath
<li>It is written in plain C, making as few assumptions as possible, support</li>
andsticking closely to ANSI C/POSIX for easy embedding. Should works <li>It is written in plain C, making as few assumptions as possible, and
onLinux/Unix/Windows.</li> sticking closely to ANSI C/POSIX for easy embedding. Should works on
<li>This library is released under the <a href="http://www.opensource.org/licenses/mit-license.html">MITLicence</a></li> Linux/Unix/Windows.</li>
<li>Though not designed primarily with performances in mind, libxslt <li>This library is released under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
seemsto be a relatively fast processor.</li> Licence</a></li>
<li>Though not designed primarily with performances in mind, libxslt seems
to be a relatively fast processor.</li>
</ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

26
doc/libxslt.xsa
View File

@@ -11,20 +11,22 @@
<version>1.1.16</version> <version>1.1.16</version>
<last-release> May 01 2006</last-release> <last-release> May 01 2006</last-release>
<info-url>http://xmlsoft.org/XSLT/</info-url> <info-url>http://xmlsoft.org/XSLT/</info-url>
<changes> - portability fixes: EXSLT date/time on Solaris and IRIX (Albert <changes> - portability fixes: EXSLT date/time on Solaris and IRIX (Albert Chin),
Chin),HP-UX build (Albert Chin), HP-UX build (Albert Chin),
- build fixes: Python detection(Joseph Sacco), plugin configurei(Joel
Reed) - build fixes: Python detection(Joseph Sacco), plugin configurei
- bug fixes: pattern compilation fix(William Brack), EXSLT date/timefix (Joel Reed)
(Thomas Broyer), EXSLT function bug, potential loop on variableeval, - bug fixes: pattern compilation fix(William Brack), EXSLT date/time
startup race (Christopher Palmer), debug statement left in python(Nic fix (Thomas Broyer), EXSLT function bug, potential loop on variable
Ferrier), various cleanup based on Coverity reports), error onOut of eval, startup race (Christopher Palmer), debug statement left in python
memory condition (Charles Hardin), various namespace prefixesfixes (Nic Ferrier), various cleanup based on Coverity reports), error on
(Kasimier Buchcik), Out of memory condition (Charles Hardin), various namespace prefixes
- improvement: speed up sortingi, start of internals refactoring fixes (Kasimier Buchcik),
(KasimierBuchcik) - improvement: speed up sortingi, start of internals refactoring (Kasimier
Buchcik)
- documentation: man page fixes and updates (Daniel Leidert) - documentation: man page fixes and updates (Daniel Leidert)
</changes> </changes>
</product> </product>
</xsa> </xsa>

551
doc/news.html
View File

@@ -8,162 +8,160 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>News</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>News</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>News</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>News</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>The <a href="ChangeLog.html">change log</a>describes the recents commitsto <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>The <a href="ChangeLog.html">change log</a> describes the recents commits
the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Those are the public releases made:</p><h3>1.1.17: Jun 6 2006</h3><ul><li>portability fixes: python detection</li> to the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a> code base.</p><p>Those are the public releases made:</p><h3>1.1.17: Jun 6 2006</h3><ul><li>portability fixes: python detection</li>
<li>bug fixes: some regression tests, attribute/namespaces output (Kasimier <li>bug fixes: some regression tests, attribute/namespaces output (Kasimier
Buchcik), problem in mixed xsl:value-of and xsl:text uses (Kasimier)</li> Buchcik), problem in mixed xsl:value-of and xsl:text uses (Kasimier)</li>
<li>improvements: internal refactoring (Kasimier Buchcik), use of the XPath <li>improvements: internal refactoring (Kasimier Buchcik), use of the XPath
object cache in libxml2-2.6.25 (Kasimier)</li> object cache in libxml2-2.6.25 (Kasimier)</li>
</ul><h3>1.1.16: May 01 2006</h3><ul><li>portability fixes: EXSLT date/time on Solaris and IRIX (Albert </ul><h3>1.1.16: May 01 2006</h3><ul><li>portability fixes: EXSLT date/time on Solaris and IRIX (Albert Chin),
Chin),HP-UX build (Albert Chin),</li> HP-UX build (Albert Chin),
<li>build fixes: Python detection(Joseph Sacco), plugin configurei(Joel </li><li>build fixes: Python detection(Joseph Sacco), plugin configurei
Reed)</li> (Joel Reed)</li>
<li>bug fixes: pattern compilation fix(William Brack), EXSLT date/timefix <li>bug fixes: pattern compilation fix(William Brack), EXSLT date/time
(Thomas Broyer), EXSLT function bug, potential loop on variableeval, fix (Thomas Broyer), EXSLT function bug, potential loop on variable
startup race (Christopher Palmer), debug statement left in python(Nic eval, startup race (Christopher Palmer), debug statement left in python
Ferrier), various cleanup based on Coverity reports), error onOut of (Nic Ferrier), various cleanup based on Coverity reports), error on
memory condition (Charles Hardin), various namespace prefixesfixes Out of memory condition (Charles Hardin), various namespace prefixes
(Kasimier Buchcik),</li> fixes (Kasimier Buchcik), </li>
<li>improvement: speed up sortingi, start of internals refactoring <li>improvement: speed up sortingi, start of internals refactoring (Kasimier
(KasimierBuchcik)</li> Buchcik)</li>
<li>documentation: man page fixes and updates (Daniel Leidert)</li> <li>documentation: man page fixes and updates (Daniel Leidert)
</ul><h3>1.1.15: Sep 04 2005</h3><ul><li>build fixes: Windows build cleanups and updates (Igor Zlatkovic),remove </li></ul><h3>1.1.15: Sep 04 2005</h3><ul><li>build fixes: Windows build cleanups and updates (Igor Zlatkovic),
jhbuild warnings</li> remove jhbuild warnings</li>
<li>bug fixes: negative number formatting (William Brack), numberformatting <li>bug fixes: negative number formatting (William Brack), number
per mille definition (William Brack), XInclude default values(William), formatting per mille definition (William Brack), XInclude default values
text copy bugs (William), bug related to xmlXPathContext size,reuse (William), text copy bugs (William), bug related to xmlXPathContext size,
libxml2 memory management for text nodes, dictionnary text bug,forbid reuse libxml2 memory management for text nodes, dictionnary text bug,
variables in match (needs libxml2-2.6.21)</li> forbid variables in match (needs libxml2-2.6.21)</li>
<li>improvements: EXSLT dyn:map (Mark Vakoc),</li> <li>improvements: EXSLT dyn:map (Mark Vakoc),</li>
<li>documentation: EXSLT date and time functions namespace in man <li>documentation: EXSLT date and time functions namespace in man (Jonathan
(JonathanWakely)</li> Wakely)</li>
</ul><h3>1.1.14: Apr 02 2005</h3><ul><li>bug fixes: text node on stylesheet document without a </ul><h3>1.1.14: Apr 02 2005</h3><ul><li>bug fixes: text node on stylesheet document without a dictionary
dictionary(William Brack), more checking of XSLT syntax, calling (William Brack), more checking of XSLT syntax, calling xsltInit()
xsltInit()multiple times, mode values interning raised by Mark Vakoc, bug multiple times, mode values interning raised by Mark Vakoc, bug in
inpattern matching with ancestors, bug in patterna matching with pattern matching with ancestors, bug in patterna matching with cascading
cascadingselect, xinclude and document() problem, build outside of source select, xinclude and document() problem, build outside of source tree
tree(Mike Castle)</li> (Mike Castle)</li>
<li>improvement: added a --nodict mode to xsltproc to check problems <li>improvement: added a --nodict mode to xsltproc to check problems for
fordocuemtns without dictionnaries</li> docuemtns without dictionnaries</li>
</ul><h3>1.1.13: Mar 13 2005</h3><ul><li>build fixes: 64bits cleanup (William Brack), python 2.4 test </ul><h3>1.1.13: Mar 13 2005</h3><ul><li>build fixes: 64bits cleanup (William Brack), python 2.4 test (William),
(William),LIBXSLT_VERSION_EXTRA on Windows (William), Windows makefiles LIBXSLT_VERSION_EXTRA on Windows (William), Windows makefiles fixes (Joel
fixes (JoelReed), libgcrypt-devel requires for RPM spec.</li> Reed), libgcrypt-devel requires for RPM spec.</li>
<li>bug fixes: exslt day-of-week-in-month (Sal Paradise), <li>bug fixes: exslt day-of-week-in-month (Sal Paradise), xsl:call-template
xsl:call-templateshould not change the current template rule (William should not change the current template rule (William Brack), evaluation
Brack), evaluationof global variables (William Brack), RVT's in XPath of global variables (William Brack), RVT's in XPath predicates (William),
predicates (William),namespace URI on template names (Mark Vakoc), stat() namespace URI on template names (Mark Vakoc), stat() for Windows patch
for Windows patch(Aleksey Gurtovoy), pattern expression fixes (William (Aleksey Gurtovoy), pattern expression fixes (William Brack), out of
Brack), out ofmemory detection misses (William), parserOptions memory detection misses (William), parserOptions propagation (William),
propagation (William),exclude-result-prefixes fix (William), // patten exclude-result-prefixes fix (William), // patten fix (William).</li>
fix (William).</li> <li>extensions: module support (Joel Reed), dictionnary based speedups
<li>extensions: module support (Joel Reed), dictionnary based trying to get rid of xmlStrEqual as much as possible.</li>
speedupstrying to get rid of xmlStrEqual as much as possible.</li>
<li>documentation: added Wiki (Joel Reed)</li> <li>documentation: added Wiki (Joel Reed)</li>
</ul><h3>1.1.12: Oct 29 2004</h3><ul><li>build fixes: warnings removal (William).</li> </ul><h3>1.1.12: Oct 29 2004</h3><ul><li>build fixes: warnings removal (William).</li>
<li>bug fixes: attribute document pointer fix (Mark Vakoc), exslt <li>bug fixes: attribute document pointer fix (Mark Vakoc), exslt date
datenegative periods (William Brack), generated tree structure negative periods (William Brack), generated tree structure fixes,
fixes,namespace lookup fix, use reentrant gmtime_r (William namespace lookup fix, use reentrant gmtime_r (William Brack),
Brack),exslt:funtion namespace fix (William), potential NULL pointer exslt:funtion namespace fix (William), potential NULL pointer reference
reference(Dennis Dams, William), force string interning on (Dennis Dams, William), force string interning on generated
generateddocuments.</li> documents.</li>
<li>documentation: update of the second tutorial (Panagiotis Louridas), <li>documentation: update of the second tutorial (Panagiotis Louridas), add
addexslt doc in rpm packages, fix the xsltproc man page.</li> exslt doc in rpm packages, fix the xsltproc man page.</li>
</ul><h3>1.1.11: Sep 29 2004</h3><ul><li>bug fixes: xsl:include problems (William Brack), UTF8 number </ul><h3>1.1.11: Sep 29 2004</h3><ul><li>bug fixes: xsl:include problems (William Brack), UTF8 number pattern
pattern(William), date-time validation (William), namespace fix (William), date-time validation (William), namespace fix (William),
(William),various Exslt date fixes (William), error callback fixes, leak various Exslt date fixes (William), error callback fixes, leak with
withnamespaced global variable, attempt to fix a weird problem namespaced global variable, attempt to fix a weird problem #153137</li>
#153137</li>
<li>improvements: exslt:date-sum tests (Derek Poon)</li> <li>improvements: exslt:date-sum tests (Derek Poon)</li>
<li>documentation: second tutorial by Panagiotis Lourida</li> <li>documentation: second tutorial by Panagiotis Lourida</li>
</ul><h3>1.1.10: Aug 31 2004</h3><ul><li>build fix: NUL in c file blocking compilation on Solaris, Windows </ul><h3>1.1.10: Aug 31 2004</h3><ul><li>build fix: NUL in c file blocking compilation on Solaris, Windows build
build(Igor Zlatkovic)</li> (Igor Zlatkovic)</li>
<li>fix: key initialization problem (William Brack)</li> <li>fix: key initialization problem (William Brack)</li>
<li>documentation: fixed missing man page description for --path</li> <li>documentation: fixed missing man page description for --path</li>
</ul><h3>1.1.9: Aug 22 2004</h3><ul><li>build fixes: missing tests (William Brack), Python dependancies, </ul><h3>1.1.9: Aug 22 2004</h3><ul><li>build fixes: missing tests (William Brack), Python dependancies, Python
Pythonon 64bits boxes, --with-crypto flag (Rob Richards),</li> on 64bits boxes, --with-crypto flag (Rob Richards),</li>
<li>fixes: RVT key handling (William), Python binding (William and <li>fixes: RVT key handling (William), Python binding (William and Sitsofe
SitsofeWheeler), key and XPath troubles (William), template priority on Wheeler), key and XPath troubles (William), template priority on imports
imports(William), str:tokenize with empty strings (William), #default (William), str:tokenize with empty strings (William), #default namespace
namespacealias behaviour (William), doc ordering missing for main alias behaviour (William), doc ordering missing for main document
document(William), 64bit bug (Andreas Schwab)</li> (William), 64bit bug (Andreas Schwab)</li>
<li>improvements: EXSLT date:sum added (Joel Reed), hook for <li>improvements: EXSLT date:sum added (Joel Reed), hook for document
documentloading for David Hyatt, xsltproc --nodtdattr to avoid defaulting loading for David Hyatt, xsltproc --nodtdattr to avoid defaulting DTD
DTDattributes, extend xsltproc --version with CVS stamp (William).</li> attributes, extend xsltproc --version with CVS stamp (William).</li>
<li>Documentation: web page problem reported by Oliver Stoeneberg</li> <li>Documentation: web page problem reported by Oliver Stoeneberg</li>
</ul><h3>1.1.8: July 5 2004</h3><ul><li>build fixes: Windows runtime options (Oliver Stoeneberg), Windowsbinary </ul><h3>1.1.8: July 5 2004</h3><ul><li>build fixes: Windows runtime options (Oliver Stoeneberg), Windows
package layout (Igor Zlatkovic), libgcrypt version test and binary package layout (Igor Zlatkovic), libgcrypt version test and link
link(William)</li> (William)</li>
<li>documentation: fix libxslt namespace name in doc (William)</li> <li>documentation: fix libxslt namespace name in doc (William)</li>
<li>bug fixes: undefined namespace message (William Brack), search <li>bug fixes: undefined namespace message (William Brack), search engine
engine(William), multiple namespace fixups (William), namespace fix for (William), multiple namespace fixups (William), namespace fix for key
keyevaluation (William), Python memory debug bindings,</li> evaluation (William), Python memory debug bindings,</li>
<li>improvements: crypto extensions for exslt (Joel Reed, William)</li> <li>improvements: crypto extensions for exslt (Joel Reed, William)</li>
</ul><h3>1.1.7: May 17 2004</h3><ul><li>build fix: warning about localtime_r on Solaris</li> </ul><h3>1.1.7: May 17 2004</h3><ul><li>build fix: warning about localtime_r on Solaris</li>
<li>bug fix: UTF8 string tokenize (William Brack), subtle memorycorruption, <li>bug fix: UTF8 string tokenize (William Brack), subtle memory
linefeed after comment at document level corruption, linefeed after comment at document level (William),
(William),disable-output-escaping problem (William), pattern compilation disable-output-escaping problem (William), pattern compilation in deep
in deepimported stylesheets (William), namespace extension prefix imported stylesheets (William), namespace extension prefix bug,
bug,libxslt.m4 bug (Edward Rudd), namespace lookup for attribute, libxslt.m4 bug (Edward Rudd), namespace lookup for attribute, namespaced
namespacedDOCTYPE name</li> DOCTYPE name</li>
</ul><h3>1.1.6: Apr 18 2004</h3><ul><li>2 bug fixes about keys fixed one by Mark Vakoc</li> </ul><h3>1.1.6: Apr 18 2004</h3><ul><li>2 bug fixes about keys fixed one by Mark Vakoc</li>
</ul><h3>1.1.5: Mar 23 2004</h3><ul><li>performance: use dictionnary lookup for variables</li> </ul><h3>1.1.5: Mar 23 2004</h3><ul><li>performance: use dictionnary lookup for variables</li>
<li>remove use of _private from source documents</li> <li>remove use of _private from source documents</li>
<li>cleanup of "make tests" output</li> <li>cleanup of "make tests" output</li>
<li>bugfixes: AVT in local variables, use localtime_r to avoid <li>bugfixes: AVT in local variables, use localtime_r to avoid thread
threadtroubles (William), dictionary handling bug (William), limited troubles (William), dictionary handling bug (William), limited number of
number ofstubstitutions in AVT (William), tokenize fix for UTF-8 stubstitutions in AVT (William), tokenize fix for UTF-8 (William),
(William),superfluous namespace (William), xsltproc error code superfluous namespace (William), xsltproc error code on
on&lt;xsl:message&gt; halt, OpenVMS fix, dictionnary reference &lt;xsl:message&gt; halt, OpenVMS fix, dictionnary reference counting
countingchange.</li> change.</li>
</ul><h3>1.1.4: Feb 23 2004</h3><ul><li>bugfixes: attributes without doc (Mariano Su<53>rez-Alvarez), problem </ul><h3>1.1.4: Feb 23 2004</h3><ul><li>bugfixes: attributes without doc (Mariano Su<53>rez-Alvarez), problem with
withYelp, extension problem</li> Yelp, extension problem</li>
<li>display extension modules (Steve Little)</li> <li>display extension modules (Steve Little)</li>
<li>Windows compilation patch (Mark Vadoc), Mingw (Mikhail Grushinskiy)</li> <li>Windows compilation patch (Mark Vadoc), Mingw (Mikhail Grushinskiy)</li>
</ul><h3>1.1.3: Feb 16 2004</h3><ul><li>Rewrote the Attribute Value Template code, new XPath </ul><h3>1.1.3: Feb 16 2004</h3><ul><li>Rewrote the Attribute Value Template code, new XPath compilation
compilationinterfaces, dictionnary reuses for XSLT with potential for interfaces, dictionnary reuses for XSLT with potential for serious
seriousperformance improvements.</li> performance improvements.</li>
<li>bug fixes: portability (William Brack), key() in node-set() <li>bug fixes: portability (William Brack), key() in node-set() results
results(William), comment before doctype (William), math and node-set() (William), comment before doctype (William), math and node-set() problems
problems(William), cdata element and default namespace (William), (William), cdata element and default namespace (William), behaviour on
behaviour onunknown XSLT elements (Stefan Kost), priority of "//foo" unknown XSLT elements (Stefan Kost), priority of "//foo" patterns
patterns(William), xsl:element and xsl:attribute QName check (William), (William), xsl:element and xsl:attribute QName check (William), comments
commentswith -- (William), attribute namespace (William), check for ?&gt; with -- (William), attribute namespace (William), check for ?&gt; in PI
in PI(William)</li> (William)</li>
<li>Documentations: cleanup (John Fleck and William)</li> <li>Documentations: cleanup (John Fleck and William)</li>
<li>Python: patch for OS-X (Gianni Ceccarelli), enums export <li>Python: patch for OS-X (Gianni Ceccarelli), enums export (Stephane
(Stephanebidoul)</li> bidoul)</li>
</ul><h3>1.1.2: Dec 24 2003</h3><ul><li>Documentation fixes (John Fleck, William Brack), EXSLT </ul><h3>1.1.2: Dec 24 2003</h3><ul><li>Documentation fixes (John Fleck, William Brack), EXSLT documentation
documentation(William Brack)</li>
<li>Windows compilation fixes for MSVC and Mingw (Igor Zlatkovic)</li>
<li>Bug fixes: exslt:date returning NULL strings (William Brack),namespaces
output (William Brack), key and namespace definition problem,passing
options down to the document() parser, xsl:number fixes
(William Brack)</li> (William Brack)</li>
<li>Windows compilation fixes for MSVC and Mingw (Igor Zlatkovic)</li>
<li>Bug fixes: exslt:date returning NULL strings (William Brack),
namespaces output (William Brack), key and namespace definition problem,
passing options down to the document() parser, xsl:number fixes (William
Brack)</li>
</ul><h3>1.1.1: Dec 10 2003</h3><ul><li>code cleanup (William Brack)</li> </ul><h3>1.1.1: Dec 10 2003</h3><ul><li>code cleanup (William Brack)</li>
<li>Windows: Makefile improvements (Igor Zlatkovic)</li> <li>Windows: Makefile improvements (Igor Zlatkovic)</li>
<li>documentation improvements: William Brack, libexslt man page <li>documentation improvements: William Brack, libexslt man page (Jonathan
(JonathanWakely)</li> Wakely)</li>
<li>param in EXSLT functions (Shaun McCance)</li> <li>param in EXSLT functions (Shaun McCance)</li>
<li>XSLT debugging improvements (Mark Vakoc)</li> <li>XSLT debugging improvements (Mark Vakoc)</li>
<li>bug fixes: number formatting (Bjorn Reese), exslt:tokenize <li>bug fixes: number formatting (Bjorn Reese), exslt:tokenize (William
(WilliamBrack), key selector parsing with | reported by Oleg Brack), key selector parsing with | reported by Oleg Paraschenko,
Paraschenko,xsl:element with computed namespaces (William Brack), xsl:element with computed namespaces (William Brack), xslt:import/include
xslt:import/includerecursion detection (William Brack), exslt:function recursion detection (William Brack), exslt:function used in keys (William
used in keys (WilliamBrack), bug when CDATA_SECTION are foun in the tree Brack), bug when CDATA_SECTION are foun in the tree (William Brack),
(William Brack),entities handling when using XInclude.</li> entities handling when using XInclude.</li>
</ul><h3>1.1.0: Nov 4 2003</h3><ul><li>Removed DocBook SGML broken support</li> </ul><h3>1.1.0: Nov 4 2003</h3><ul><li>Removed DocBook SGML broken support</li>
<li>fix xsl:key to work with PIs</li> <li>fix xsl:key to work with PIs</li>
<li>Makefile and build improvement (Graham Wilson), build cleanup <li>Makefile and build improvement (Graham Wilson), build cleanup (William
(WilliamBrack), macro fix (Justin Fletcher), build outside of source tree Brack), macro fix (Justin Fletcher), build outside of source tree (Roumen
(RoumenPetrov)</li> Petrov)</li>
<li>xsltproc option display fix (Alexey Efimov), --load-trace <li>xsltproc option display fix (Alexey Efimov), --load-trace (Crutcher
(CrutcherDunnavant)</li> Dunnavant)</li>
<li>Python: never use stdout for error</li> <li>Python: never use stdout for error</li>
<li>extension memory error fix (Karl Eichwalder)</li> <li>extension memory error fix (Karl Eichwalder)</li>
<li>header path fixes (Steve Ball)</li> <li>header path fixes (Steve Ball)</li>
<li>added saxon:line-number() to libexslt (Brett Kail)</li> <li>added saxon:line-number() to libexslt (Brett Kail)</li>
<li>Fix some tortuous template problems when using predicates <li>Fix some tortuous template problems when using predicates (William
(WilliamBrack)</li> Brack)</li>
<li>Debugger status patch (Kasimier Buchcik)</li> <li>Debugger status patch (Kasimier Buchcik)</li>
<li>Use new libxml2-2.6.x APIs for faster processing</li> <li>Use new libxml2-2.6.x APIs for faster processing</li>
<li>Make sure xsl:sort is empty</li> <li>Make sure xsl:sort is empty</li>
@@ -182,67 +180,66 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>apply-templates crash (William Brack)</li> <li>apply-templates crash (William Brack)</li>
<li>bug with imported templates (William Brack)</li> <li>bug with imported templates (William Brack)</li>
<li>imported attribute-sets merging bug (DocBook) (William Brack)</li> <li>imported attribute-sets merging bug (DocBook) (William Brack)</li>
</ul><h3>1.0.32: Aug 9 2003</h3><ul><li>bugfixes: xsltSaveResultToFile() python binding (Chris Jaeger), </ul><h3>1.0.32: Aug 9 2003</h3><ul><li>bugfixes: xsltSaveResultToFile() python binding (Chris Jaeger), EXSLT
EXSLTfunction (William Brack), RVT for globals (William Brack), EXSLT function (William Brack), RVT for globals (William Brack), EXSLT date
date(William Brack), (William Brack),
<p>speed of large text output, xsl:copy with attributes, strip-space <p>speed of large text output, xsl:copy with attributes, strip-space and
andnamespaces prefix, fix for --path xsltproc option, EXST:tokenize namespaces prefix, fix for --path xsltproc option, EXST:tokenize (Shaun
(ShaunMcCance), EXSLT:seconds (William Brack), sort with multiple keys McCance), EXSLT:seconds (William Brack), sort with multiple keys (William
(WilliamBrack), checking of { and } for attribute value templates Brack), checking of { and } for attribute value templates (William
(WilliamBrack)</p> Brack)</p>
</li> </li>
<li>Python bindings for extension elements (Sean Treadway)</li> <li>Python bindings for extension elements (Sean Treadway)</li>
<li>EXSLT:split added (Shaun McCance)</li> <li>EXSLT:split added (Shaun McCance)</li>
<li>portability fixes for HP-UX/Solaris/IRIX (William Brack)</li> <li>portability fixes for HP-UX/Solaris/IRIX (William Brack)</li>
<li>doc cleanup</li> <li>doc cleanup</li>
</ul><h3>1.0.31: Jul 6 2003</h3><ul><li>bugfixes: xsl:copy on namespace nodes, AVT for xsl:sort order, fix </ul><h3>1.0.31: Jul 6 2003</h3><ul><li>bugfixes: xsl:copy on namespace nodes, AVT for xsl:sort order, fix for
forthe debugger (Keith Isdale), output filename limitation, trio.h the debugger (Keith Isdale), output filename limitation, trio.h and
andtriodef.h added (Albert Chin), EXSLT node-set (Peter triodef.h added (Albert Chin), EXSLT node-set (Peter Breitenlohner),
Breitenlohner),xsltChoose and whitespace (Igor Zlatkovic), xsltChoose and whitespace (Igor Zlatkovic),
<p>stylesheet compilation (Igor Zlatkovic), NaN and sort (William <p>stylesheet compilation (Igor Zlatkovic), NaN and sort (William Brack),
Brack),RVT bug introduced in 1.0.30</p> RVT bug introduced in 1.0.30</p>
</li> </li>
<li>avoid generating &amp;quot; (fix in libxml2-2.5.8)</li> <li>avoid generating &amp;quot; (fix in libxml2-2.5.8)</li>
<li>fix 64bit cleaness problem and compilation troubles introduced <li>fix 64bit cleaness problem and compilation troubles introduced in
in1.0.30</li> 1.0.30</li>
<li>Windows makefile generation (Igor Zlatkovic)</li> <li>Windows makefile generation (Igor Zlatkovic)</li>
<li>HP-UX portability fix</li> <li>HP-UX portability fix</li>
</ul><h3>1.0.30: May 4 2003</h3><ul><li>Fixes and new APIs to handle Result Value Trees and avoid leaks</li> </ul><h3>1.0.30: May 4 2003</h3><ul><li>Fixes and new APIs to handle Result Value Trees and avoid leaks</li>
<li>Fixes for: EXSLT math pow() function (Charles Bozeman), globalparameter <li>Fixes for: EXSLT math pow() function (Charles Bozeman), global
and global variables mismatch, a segfault on patterncompilation errors, parameter and global variables mismatch, a segfault on pattern
namespace copy in xsl:copy-of, python generatorproblem, OpenVMS trio compilation errors, namespace copy in xsl:copy-of, python generator
update, premature call to xsltFreeStackElem (Igor),current node when problem, OpenVMS trio update, premature call to xsltFreeStackElem (Igor),
templates applies to attributes</li> current node when templates applies to attributes</li>
</ul><h3>1.0.29: Apr 1 2003</h3><ul><li>performance improvements especially for large flat documents</li> </ul><h3>1.0.29: Apr 1 2003</h3><ul><li>performance improvements especially for large flat documents</li>
<li>bug fixes: Result Value Tree handling, XML IDs, keys(), extra <li>bug fixes: Result Value Tree handling, XML IDs, keys(), extra namespace
namespacedeclarations with xsl:elements.</li> declarations with xsl:elements.</li>
<li>portability: python and trio fixes (Albert Chin), python on Solaris(Ben <li>portability: python and trio fixes (Albert Chin), python on Solaris
Phillips)</li> (Ben Phillips)</li>
</ul><h3>1.0.28: Mar 24 2003</h3><ul><li>fixed node() in patterns semantic.</li> </ul><h3>1.0.28: Mar 24 2003</h3><ul><li>fixed node() in patterns semantic.</li>
<li>fixed a memory access problem in format-number()</li> <li>fixed a memory access problem in format-number()</li>
<li>fixed stack overflow in recursive global variable or params</li> <li>fixed stack overflow in recursive global variable or params</li>
<li>cleaned up Result Value Tree handling, and fixed a couple of old bugsin <li>cleaned up Result Value Tree handling, and fixed a couple of old bugs
the process</li> in the process</li>
</ul><h3>1.0.27: Feb 24 2003</h3><ul><li>bug fixes: spurious xmlns:nsX="" generation, serialization bug </ul><h3>1.0.27: Feb 24 2003</h3><ul><li>bug fixes: spurious xmlns:nsX="" generation, serialization bug (in
(inlibxml2), a namespace copy problem, errors in the RPM spec prereqs</li> libxml2), a namespace copy problem, errors in the RPM spec prereqs</li>
<li>Windows path canonicalization and document cache fix (Igor)</li> <li>Windows path canonicalization and document cache fix (Igor)</li>
</ul><h3>1.0.26: Feb 10 2003</h3><ul><li>Fixed 3 serious bugs in document() and stylesheet compilation </ul><h3>1.0.26: Feb 10 2003</h3><ul><li>Fixed 3 serious bugs in document() and stylesheet compilation which
whichcould lead to a crash</li> could lead to a crash</li>
</ul><h3>1.0.25: Feb 5 2003</h3><ul><li>Bug fix: double-free for standalone stylesheets introduced in 1.0.24, </ul><h3>1.0.25: Feb 5 2003</h3><ul><li>Bug fix: double-free for standalone stylesheets introduced in 1.0.24, C
Csyntax pbm, 3 bugs reported by Eric van der Vlist</li> syntax pbm, 3 bugs reported by Eric van der Vlist</li>
<li>Some XPath and XInclude related problems were actually fixed <li>Some XPath and XInclude related problems were actually fixed in
inlibxml2-2.5.2</li> libxml2-2.5.2</li>
<li>Documentation: emphasize taht --docbook is not for XML docs.</li> <li>Documentation: emphasize taht --docbook is not for XML docs.</li>
</ul><h3>1.0.24: Jan 14 2003</h3><ul><li>bug fixes: imported global varables, python bindings (St<53>phane </ul><h3>1.0.24: Jan 14 2003</h3><ul><li>bug fixes: imported global varables, python bindings (St<53>phane Bidoul),
Bidoul),EXSLT memory leak (Charles Bozeman), namespace generation EXSLT memory leak (Charles Bozeman), namespace generation on
onxsl:attribute, space handling with imports (Daniel xsl:attribute, space handling with imports (Daniel Stodden),
Stodden),extension-element-prefixes (Josh Parsons), comments within extension-element-prefixes (Josh Parsons), comments within xsl:text (Matt
xsl:text (MattSergeant), superfluous xmlns generation, XInclude related Sergeant), superfluous xmlns generation, XInclude related bug for
bug fornumbering, EXSLT strings (Alexey Efimov), attribute-sets numbering, EXSLT strings (Alexey Efimov), attribute-sets computation on
computation onimports, extension module init and shutdown callbacks not imports, extension module init and shutdown callbacks not called</li>
called</li> <li>HP-UX portability (Alexey Efimov), Windows makefiles (Igor and Stephane
<li>HP-UX portability (Alexey Efimov), Windows makefiles (Igor and Bidoul), VMS makefile updates (Craig A. Berry)</li>
StephaneBidoul), VMS makefile updates (Craig A. Berry)</li>
<li>adds xsltGetProfileInformation() (Michael Rothwell)</li> <li>adds xsltGetProfileInformation() (Michael Rothwell)</li>
<li>fix the API generation scripts</li> <li>fix the API generation scripts</li>
<li>API to provide the sorting routines (Richard Jinks)</li> <li>API to provide the sorting routines (Richard Jinks)</li>
@@ -252,31 +249,31 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>document() now support fragment identifiers in URIs</li> <li>document() now support fragment identifiers in URIs</li>
</ul><h3>1.0.23: Nov 17 2002</h3><ul><li>Windows build cleanup (Igor)</li> </ul><h3>1.0.23: Nov 17 2002</h3><ul><li>Windows build cleanup (Igor)</li>
<li>Unix build and RPM packaging cleanup</li> <li>Unix build and RPM packaging cleanup</li>
<li>Improvement of the python bindings: extension functions and <li>Improvement of the python bindings: extension functions and activating
activatingEXSLT</li> EXSLT</li>
<li>various bug fixes: number formatting, portability for bounded <li>various bug fixes: number formatting, portability for bounded string
stringfunctions, CData nodes, key(), @*[...] patterns</li> functions, CData nodes, key(), @*[...] patterns</li>
<li>Documentation improvements (John Fleck)</li> <li>Documentation improvements (John Fleck)</li>
<li>added libxslt.m4 (Thomas Schraitle)</li> <li>added libxslt.m4 (Thomas Schraitle)</li>
</ul><h3>1.0.22: Oct 18 2002</h3><ul><li>Updates on the Windows Makefiles</li> </ul><h3>1.0.22: Oct 18 2002</h3><ul><li>Updates on the Windows Makefiles</li>
<li>Added a security module, and a related set of new options <li>Added a security module, and a related set of new options to
toxsltproc</li> xsltproc</li>
<li>Allowed per transformation error handler.</li> <li>Allowed per transformation error handler.</li>
<li>Fixed a few bugs: node() semantic, URI escaping, media-type, <li>Fixed a few bugs: node() semantic, URI escaping, media-type, attribute
attributelists</li> lists</li>
</ul><h3>1.0.21: Sep 26 2002</h3><ul><li>Bug fixes: match="node()", date:difference() (Igor and CharlieBozeman), </ul><h3>1.0.21: Sep 26 2002</h3><ul><li>Bug fixes: match="node()", date:difference() (Igor and Charlie
disable-output-escaping</li> Bozeman), disable-output-escaping</li>
<li>Python bindings: style.saveResultToString() from Ralf Mattes</li> <li>Python bindings: style.saveResultToString() from Ralf Mattes</li>
<li>Logos from Marc Liyanage</li> <li>Logos from Marc Liyanage</li>
<li>Mem leak fix from Nathan Myers</li> <li>Mem leak fix from Nathan Myers</li>
<li>Makefile: DESTDIR fix from Christophe Merlet, AMD x86_64 <li>Makefile: DESTDIR fix from Christophe Merlet, AMD x86_64 (Mandrake),
(Mandrake),Windows (Igor), Python detection</li> Windows (Igor), Python detection</li>
<li>Documentation improvements: John Fleck</li> <li>Documentation improvements: John Fleck</li>
</ul><h3>1.0.20: Aug 23 2002</h3><ul><li>Windows makefile updates (Igor) and x86-64 (Frederic Crozat)</li> </ul><h3>1.0.20: Aug 23 2002</h3><ul><li>Windows makefile updates (Igor) and x86-64 (Frederic Crozat)</li>
<li>fixed HTML meta tag saving for Mac/IE users</li> <li>fixed HTML meta tag saving for Mac/IE users</li>
<li>possible leak patches from Nathan Myers</li> <li>possible leak patches from Nathan Myers</li>
<li>try to handle document('') as best as possible depending in <li>try to handle document('') as best as possible depending in the
thecases</li> cases</li>
<li>Fixed the DocBook stylesheets handling problem</li> <li>Fixed the DocBook stylesheets handling problem</li>
<li>Fixed a few XSLT reported errors</li> <li>Fixed a few XSLT reported errors</li>
</ul><h3>1.0.19: July 6 2002</h3><ul><li>EXSLT: dynamic functions and date support bug fixes (Mark Vakoc)</li> </ul><h3>1.0.19: July 6 2002</h3><ul><li>EXSLT: dynamic functions and date support bug fixes (Mark Vakoc)</li>
@@ -285,84 +282,89 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>document('') fix: bug pointed by Eric van der Vlist</li> <li>document('') fix: bug pointed by Eric van der Vlist</li>
<li>xsl:message with terminate="yes" fixes: William Brack</li> <li>xsl:message with terminate="yes" fixes: William Brack</li>
<li>xsl:sort order support added: Ken Neighbors</li> <li>xsl:sort order support added: Ken Neighbors</li>
<li>a few other bug fixes, some of them requiring the latest version <li>a few other bug fixes, some of them requiring the latest version of
oflibxml2</li> libxml2</li>
</ul><h3>1.0.18: May 27 2002</h3><ul><li>a number of bug fixes: attributes, extra namespace </ul><h3>1.0.18: May 27 2002</h3><ul><li>a number of bug fixes: attributes, extra namespace declarations
declarations(DocBook), xsl:include crash (Igor), documentation (Christian (DocBook), xsl:include crash (Igor), documentation (Christian Cornelssen,
Cornelssen,Charles Bozeman and Geert Kloosterman), element-available Charles Bozeman and Geert Kloosterman), element-available (Richard
(RichardJinks)</li> Jinks)</li>
<li>xsltproc can now list teh registered extensions thanks to MarkVakoc</li> <li>xsltproc can now list teh registered extensions thanks to Mark
<li>there is a new API to save directly to a stringxsltSaveResultToString() Vakoc</li>
by Morus Walter</li> <li>there is a new API to save directly to a string
xsltSaveResultToString() by Morus Walter</li>
<li>specific error registration function for the python API</li> <li>specific error registration function for the python API</li>
</ul><h3>1.0.17: April 29 2002</h3><ul><li>cleanup in code, XSLT debugger support and Makefiles for Windows </ul><h3>1.0.17: April 29 2002</h3><ul><li>cleanup in code, XSLT debugger support and Makefiles for Windows by
byIgor</li> Igor</li>
<li>a C++ portability fix by Mark Vakoc</li> <li>a C++ portability fix by Mark Vakoc</li>
<li>EXSLT date improvement and regression tests by Charles Bozeman</li> <li>EXSLT date improvement and regression tests by Charles Bozeman</li>
<li>attempt to fix a bug in xsltProcessUserParamInternal</li> <li>attempt to fix a bug in xsltProcessUserParamInternal</li>
</ul><h3>1.0.16: April 15 2002</h3><ul><li>Bug fixes: strip-space, URL in HTML output, error when xsltproc </ul><h3>1.0.16: April 15 2002</h3><ul><li>Bug fixes: strip-space, URL in HTML output, error when xsltproc can't
can'tsave</li> save</li>
<li>portability fixes: OSF/1, IEEE on alphas, Windows, Python bindings</li> <li>portability fixes: OSF/1, IEEE on alphas, Windows, Python bindings</li>
</ul><h3>1.0.15: Mar 25 2002</h3><ul><li>Bugfixes: XPath, python Makefile, recursive attribute sets, </ul><h3>1.0.15: Mar 25 2002</h3><ul><li>Bugfixes: XPath, python Makefile, recursive attribute sets, @foo[..]
@foo[..]templates</li> templates</li>
<li>Debug of memory alocation with valgind</li> <li>Debug of memory alocation with valgind</li>
<li>serious profiling leading to significant improvement for <li>serious profiling leading to significant improvement for DocBook
DocBookprocessing</li> processing</li>
<li>revamp of the Windows build</li> <li>revamp of the Windows build</li>
</ul><h3>1.0.14: Mar 18 2002</h3><ul><li>Improvement in the XPath engine (libxml2-2.4.18)</li> </ul><h3>1.0.14: Mar 18 2002</h3><ul><li>Improvement in the XPath engine (libxml2-2.4.18)</li>
<li>Nasty bug fix related to exslt:node-set</li> <li>Nasty bug fix related to exslt:node-set</li>
<li>Fixed the python Makefiles, cleanup of doc comments, Windowsportability <li>Fixed the python Makefiles, cleanup of doc comments, Windows
fixes</li> portability fixes</li>
</ul><h3>1.0.13: Mar 8 2002</h3><ul><li>a number of bug fixes including "namespace node have no parents"</li> </ul><h3>1.0.13: Mar 8 2002</h3><ul><li>a number of bug fixes including "namespace node have no parents"</li>
<li>Improvement of the Python bindings</li> <li>Improvement of the Python bindings</li>
<li>Charles Bozeman provided fixes and regression tests for exslt <li>Charles Bozeman provided fixes and regression tests for exslt date
datefunctions.</li> functions.</li>
</ul><h3>1.0.12: Feb 11 2002</h3><ul><li>Fixed the makefiles especially the python module ones</li> </ul><h3>1.0.12: Feb 11 2002</h3><ul><li>Fixed the makefiles especially the python module ones</li>
<li>half a dozen bugs fixes including 2 old ones</li> <li>half a dozen bugs fixes including 2 old ones</li>
</ul><h3>1.0.11: Feb 8 2002</h3><ul><li>Change of Licence to the <a href="http://www.opensource.org/licenses/mit-license.html">MITLicence</a></li> </ul><h3>1.0.11: Feb 8 2002</h3><ul><li>Change of Licence to the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
<li>Added a beta version of the Python bindings, including support toextend Licence</a></li>
the engine with functions written in Python</li> <li>Added a beta version of the Python bindings, including support to
extend the engine with functions written in Python</li>
<li>A number of bug fixes</li> <li>A number of bug fixes</li>
<li>Charlie Bozeman provided more EXSLT functions</li> <li>Charlie Bozeman provided more EXSLT functions</li>
<li>Portability fixes</li> <li>Portability fixes</li>
</ul><h3>1.0.10: Jan 14 2002</h3><ul><li>Windows fixes for Win32 from Igor</li> </ul><h3>1.0.10: Jan 14 2002</h3><ul><li>Windows fixes for Win32 from Igor</li>
<li>Fixed the Solaris compilation trouble (Albert)</li> <li>Fixed the Solaris compilation trouble (Albert)</li>
<li>Documentation changes and updates: John Fleck</li> <li>Documentation changes and updates: John Fleck</li>
<li>Added a stringparam option to avoid escaping hell at the shelllevel</li> <li>Added a stringparam option to avoid escaping hell at the shell
level</li>
<li>A few bug fixes</li> <li>A few bug fixes</li>
</ul><h3>1.0.9: Dec 7 2001</h3><ul><li>Makefile patches from Peter Williams</li> </ul><h3>1.0.9: Dec 7 2001</h3><ul><li>Makefile patches from Peter Williams</li>
<li>attempt to fix the compilation problem associated to prelinking</li> <li>attempt to fix the compilation problem associated to prelinking</li>
<li>obsoleted libxsltbreakpoint now deprecated and frozen to 1.0.8 API</li> <li>obsoleted libxsltbreakpoint now deprecated and frozen to 1.0.8 API</li>
<li>xsltproc return codes are now significant, John Fleck updated <li>xsltproc return codes are now significant, John Fleck updated the
thedocumentation</li> documentation</li>
<li>patch to allow as much as 40 steps in patterns (Marc Tardif), should <li>patch to allow as much as 40 steps in patterns (Marc Tardif), should be
bemade dynamic really</li> made dynamic really</li>
<li>fixed a bug raised by Nik Clayton when using doctypes with <li>fixed a bug raised by Nik Clayton when using doctypes with HTML
HTMLoutput</li> output</li>
<li>patches from Keith Isdale to interface with xsltdebugger</li> <li>patches from Keith Isdale to interface with xsltdebugger</li>
</ul><h3>1.0.8: Nov 26 2001</h3><ul><li>fixed an annoying header problem, removed a few bugs and some </ul><h3>1.0.8: Nov 26 2001</h3><ul><li>fixed an annoying header problem, removed a few bugs and some code
codecleanup</li> cleanup</li>
<li>patches for Windows and update of Windows Makefiles by Igor</li> <li>patches for Windows and update of Windows Makefiles by Igor</li>
<li>OpenVMS port instructions from John A Fotheringham</li> <li>OpenVMS port instructions from John A Fotheringham</li>
<li>fixed some Makefiles annoyance and libraries prelinkinginformations</li> <li>fixed some Makefiles annoyance and libraries prelinking
informations</li>
</ul><h3>1.0.7: Nov 10 2001</h3><ul><li>remove a compilation problem with LIBXSLT_PUBLIC</li> </ul><h3>1.0.7: Nov 10 2001</h3><ul><li>remove a compilation problem with LIBXSLT_PUBLIC</li>
<li>Finishing the integration steps for Keith Isdale debugger</li> <li>Finishing the integration steps for Keith Isdale debugger</li>
<li>fixes the handling of indent="no" on HTML output</li> <li>fixes the handling of indent="no" on HTML output</li>
<li>fixes on the configure script and RPM spec file</li> <li>fixes on the configure script and RPM spec file</li>
</ul><h3>1.0.6: Oct 30 2001</h3><ul><li>bug fixes on number formatting (Thomas), date/time functions </ul><h3>1.0.6: Oct 30 2001</h3><ul><li>bug fixes on number formatting (Thomas), date/time functions (Bruce
(BruceMiller)</li> Miller)</li>
<li>update of the Windows Makefiles (Igor)</li> <li>update of the Windows Makefiles (Igor)</li>
<li>fixed DOCTYPE generation rules for HTML output (me)</li> <li>fixed DOCTYPE generation rules for HTML output (me)</li>
</ul><h3>1.0.5: Oct 10 2001</h3><ul><li>some portability fixes, including Windows makefile updates fromIgor</li> </ul><h3>1.0.5: Oct 10 2001</h3><ul><li>some portability fixes, including Windows makefile updates from
Igor</li>
<li>fixed a dozen bugs on XSLT and EXSLT (me and Thomas Broyer)</li> <li>fixed a dozen bugs on XSLT and EXSLT (me and Thomas Broyer)</li>
<li>support for Saxon's evaluate and expressions extensions added <li>support for Saxon's evaluate and expressions extensions added (initial
(initialcontribution from Darren Graves)</li> contribution from Darren Graves)</li>
<li>better handling of XPath evaluation errors</li> <li>better handling of XPath evaluation errors</li>
</ul><h3>1.0.4: Sep 12 2001</h3><ul><li>Documentation updates from John fleck</li> </ul><h3>1.0.4: Sep 12 2001</h3><ul><li>Documentation updates from John fleck</li>
<li>bug fixes (DocBook FO generation should be fixed) and <li>bug fixes (DocBook FO generation should be fixed) and portability
portabilityimprovements</li> improvements</li>
<li>Thomas Broyer improved the existing EXSLT support and added String,Time <li>Thomas Broyer improved the existing EXSLT support and added String,
and Date core functions support</li> Time and Date core functions support</li>
</ul><h3>1.0.3: Aug 23 2001</h3><ul><li>XML Catalog support see the doc</li> </ul><h3>1.0.3: Aug 23 2001</h3><ul><li>XML Catalog support see the doc</li>
<li>New NaN/Infinity floating point code</li> <li>New NaN/Infinity floating point code</li>
<li>A few bug fixes</li> <li>A few bug fixes</li>
@@ -377,44 +379,45 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>fixed the profiler on Windows</li> <li>fixed the profiler on Windows</li>
<li>bug fixes</li> <li>bug fixes</li>
</ul><h3>1.0.0: July 10 2001</h3><ul><li>a lot of cleanup, a lot of regression tests added or fixed</li> </ul><h3>1.0.0: July 10 2001</h3><ul><li>a lot of cleanup, a lot of regression tests added or fixed</li>
<li>added a documentation for <a href="extensions.html">writingextensions</a></li> <li>added a documentation for <a href="extensions.html">writing
extensions</a></li>
<li>fixed some variable evaluation problems (with William)</li> <li>fixed some variable evaluation problems (with William)</li>
<li>added profiling of stylesheet execution accessible as the <li>added profiling of stylesheet execution accessible as the xsltproc
xsltproc--profile option</li> --profile option</li>
<li>fixed element-available() and the implementation of the variouschunking <li>fixed element-available() and the implementation of the various
methods present, Norm Walsh provided a lot of feedback</li> chunking methods present, Norm Walsh provided a lot of feedback</li>
<li>exclude-result-prefixes and namespaces output should now work <li>exclude-result-prefixes and namespaces output should now work as
asexpected</li> expected</li>
<li>added support of embedded stylesheet as described in section 2.7 of <li>added support of embedded stylesheet as described in section 2.7 of the
thespec</li> spec</li>
</ul><h3>0.14.0: July 5 2001</h3><ul><li>lot of bug fixes, and code cleanup</li> </ul><h3>0.14.0: July 5 2001</h3><ul><li>lot of bug fixes, and code cleanup</li>
<li>completion of the little XSLT-1.0 features left unimplemented</li> <li>completion of the little XSLT-1.0 features left unimplemented</li>
<li>Added and implemented the extension API suggested by Thomas Broyer</li> <li>Added and implemented the extension API suggested by Thomas Broyer</li>
<li>the Windows MSC environment should be complete</li> <li>the Windows MSC environment should be complete</li>
<li>tested and optimized with a really large document (DocBook <li>tested and optimized with a really large document (DocBook Definitive
DefinitiveGuide) libxml/libxslt should really be faster on serious Guide) libxml/libxslt should really be faster on serious workloads</li>
workloads</li>
</ul><h3>0.13.0: June 26 2001</h3><ul><li>lots of cleanups</li> </ul><h3>0.13.0: June 26 2001</h3><ul><li>lots of cleanups</li>
<li>fixed a C++ compilation problem</li> <li>fixed a C++ compilation problem</li>
<li>couple of fixes to xsltSaveTo()</li> <li>couple of fixes to xsltSaveTo()</li>
<li>try to fix Docbook-xslt-1.4 and chunking, updated the regression <li>try to fix Docbook-xslt-1.4 and chunking, updated the regression test
testwith them</li> with them</li>
<li>fixed pattern compilation and priorities problems</li> <li>fixed pattern compilation and priorities problems</li>
<li>Patches for Windows and MSC project mostly contributed by Yon Derek</li> <li>Patches for Windows and MSC project mostly contributed by Yon Derek</li>
<li>update to the Tutorial by John Fleck</li> <li>update to the Tutorial by John Fleck</li>
<li>William fixed bugs in templates and for-each functions</li> <li>William fixed bugs in templates and for-each functions</li>
<li>added a new interface xsltRunStylesheet() for a more flexible <li>added a new interface xsltRunStylesheet() for a more flexible output
output(incomplete), added -o option to xsltproc</li> (incomplete), added -o option to xsltproc</li>
</ul><h3>0.12.0: June 18 2001</h3><ul><li>fixed a dozen of bugs reported</li> </ul><h3>0.12.0: June 18 2001</h3><ul><li>fixed a dozen of bugs reported</li>
<li>HTML generation should be quite better (requires libxml-2.3.11 <li>HTML generation should be quite better (requires libxml-2.3.11 upgrade
upgradetoo)</li> too)</li>
<li>William fixed some problems with document()</li> <li>William fixed some problems with document()</li>
<li>Fix namespace nodes selection and copy (requires libxml-2.3.11 <li>Fix namespace nodes selection and copy (requires libxml-2.3.11 upgrade
upgradetoo)</li> too)</li>
<li>John Fleck added a<a href="tutorial/libxslttutorial.html">tutorial</a></li> <li>John Fleck added a<a href="tutorial/libxslttutorial.html">
tutorial</a></li>
<li>Fixes for namespace handling when evaluating variables</li> <li>Fixes for namespace handling when evaluating variables</li>
<li>XInclude global flag added to process XInclude on document() <li>XInclude global flag added to process XInclude on document() if
ifrequested</li> requested</li>
<li>made xsltproc --version more detailed</li> <li>made xsltproc --version more detailed</li>
</ul><h3>0.11.0: June 1 2001</h3><p>Mostly a bug fix release.</p><ul><li>integration of catalogs from xsltproc</li> </ul><h3>0.11.0: June 1 2001</h3><p>Mostly a bug fix release.</p><ul><li>integration of catalogs from xsltproc</li>
<li>added --version to xsltproc for bug reporting</li> <li>added --version to xsltproc for bug reporting</li>
@@ -424,8 +427,8 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>William fixed the XPath string functions when using unicode</li> <li>William fixed the XPath string functions when using unicode</li>
</ul><h3>0.10.0: May 19 2001</h3><ul><li>cleanups to make stylesheet read-only (not 100% complete)</li> </ul><h3>0.10.0: May 19 2001</h3><ul><li>cleanups to make stylesheet read-only (not 100% complete)</li>
<li>fixed URI resolution in document()</li> <li>fixed URI resolution in document()</li>
<li>force all XPath expression to be compiled at stylesheet parsing <li>force all XPath expression to be compiled at stylesheet parsing time,
time,even if unused ...</li> even if unused ...</li>
<li>Fixed HTML default output detection</li> <li>Fixed HTML default output detection</li>
<li>Fixed double attribute generation #54446</li> <li>Fixed double attribute generation #54446</li>
<li>Fixed {{ handling in attributes #54451</li> <li>Fixed {{ handling in attributes #54451</li>
@@ -435,25 +438,25 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>William Brack and Bjorn Reese improved format-number()</li> <li>William Brack and Bjorn Reese improved format-number()</li>
<li>Fixed multiple sort, it should really work now</li> <li>Fixed multiple sort, it should really work now</li>
<li>added a --docbook option for SGML DocBook input (hackish)</li> <li>added a --docbook option for SGML DocBook input (hackish)</li>
<li>a number of other bug fixes and regression test added as people <li>a number of other bug fixes and regression test added as people were
weresubmitting them</li> submitting them</li>
</ul><h3>0.9.0: May 3 2001</h3><ul><li>lot of various bugfixes, extended the regression suite</li> </ul><h3>0.9.0: May 3 2001</h3><ul><li>lot of various bugfixes, extended the regression suite</li>
<li>xsltproc should work with multiple params</li> <li>xsltproc should work with multiple params</li>
<li>added an option to use xsltproc with HTML input</li> <li>added an option to use xsltproc with HTML input</li>
<li>improved the stylesheet compilation, processing of complex <li>improved the stylesheet compilation, processing of complex stylesheets
stylesheetsshould be faster</li> should be faster</li>
<li>using the same stylesheet for concurrent processing on <li>using the same stylesheet for concurrent processing on multithreaded
multithreadedprograms should work now</li> programs should work now</li>
<li>fixed another batch of namespace handling problems</li> <li>fixed another batch of namespace handling problems</li>
<li>Implemented multiple level of sorting</li> <li>Implemented multiple level of sorting</li>
</ul><h3>0.8.0: Apr 22 2001</h3><ul><li>fixed ansidecl.h problem</li> </ul><h3>0.8.0: Apr 22 2001</h3><ul><li>fixed ansidecl.h problem</li>
<li>fixed unparsed-entity-uri() and generate-id()</li> <li>fixed unparsed-entity-uri() and generate-id()</li>
<li>sort semantic fixes and priority prob from William M. Brack</li> <li>sort semantic fixes and priority prob from William M. Brack</li>
<li>fixed namespace handling problems in XPath expression <li>fixed namespace handling problems in XPath expression computations
computations(requires libxml-2.3.7)</li> (requires libxml-2.3.7)</li>
<li>fixes to current() and key()</li> <li>fixes to current() and key()</li>
<li>other, smaller fixes, lots of testing with N Walsh DocBook <li>other, smaller fixes, lots of testing with N Walsh DocBook HTML
HTMLstylesheets</li> stylesheets</li>
</ul><h3>0.7.0: Apr 10 2001</h3><ul><li>cleanup using stricter compiler flags</li> </ul><h3>0.7.0: Apr 10 2001</h3><ul><li>cleanup using stricter compiler flags</li>
<li>command line parameter passing</li> <li>command line parameter passing</li>
<li>fix to xsltApplyTemplates from William M. Brack</li> <li>fix to xsltApplyTemplates from William M. Brack</li>
@@ -463,13 +466,13 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>document() extension should function properly</li> <li>document() extension should function properly</li>
<li>fixed a number or reported bugs</li> <li>fixed a number or reported bugs</li>
</ul><h3>0.5.0: Mar 10 2001</h3><ul><li>fifth beta</li> </ul><h3>0.5.0: Mar 10 2001</h3><ul><li>fifth beta</li>
<li>some optimization work, for the moment 2 XSLT transform cannot use <li>some optimization work, for the moment 2 XSLT transform cannot use the
thesame stylesheet at the same time (to be fixed)</li> same stylesheet at the same time (to be fixed)</li>
<li>fixed problems with handling of tree results</li> <li>fixed problems with handling of tree results</li>
<li>fixed a reported strip-spaces problem</li> <li>fixed a reported strip-spaces problem</li>
<li>added more reported/fixed bugs to the test suite</li> <li>added more reported/fixed bugs to the test suite</li>
<li>incorporated William M. Brack fix for imports and global variables <li>incorporated William M. Brack fix for imports and global variables as
aswell as patch for with-param support in apply-templates</li> well as patch for with-param support in apply-templates</li>
<li>a bug fix on for-each</li> <li>a bug fix on for-each</li>
</ul><h3>0.4.0: Mar 1 2001</h3><ul><li>fourth beta test, released at the same time of libxml2-2.3.3</li> </ul><h3>0.4.0: Mar 1 2001</h3><ul><li>fourth beta test, released at the same time of libxml2-2.3.3</li>
<li>bug fixes</li> <li>bug fixes</li>
@@ -481,17 +484,17 @@ the <a href="http://cvs.gnome.org/viewcvs/libxslt/">CVS</a>code base.</p><p>Thos
<li>some optimization</li> <li>some optimization</li>
<li>added DocBook XSL based testsuite</li> <li>added DocBook XSL based testsuite</li>
</ul><h3>0.2.0: Feb 15 2001</h3><ul><li>second beta version, released at the same time as libxml2-2.3.1</li> </ul><h3>0.2.0: Feb 15 2001</h3><ul><li>second beta version, released at the same time as libxml2-2.3.1</li>
<li>getting close to feature completion, lot of bug fixes, some in the <li>getting close to feature completion, lot of bug fixes, some in the HTML
HTMLand XPath support of libxml</li> and XPath support of libxml</li>
<li>start becoming usable for real work. This version can now regeneratethe <li>start becoming usable for real work. This version can now regenerate
XML 2e HTML from the original XML sources and the associatedstylesheets the XML 2e HTML from the original XML sources and the associated
(in <a href="http://www.w3.org/TR/REC-xml#b4d250b6c21">section I of the stylesheets (in <a href="http://www.w3.org/TR/REC-xml#b4d250b6c21">section I of the XML
XMLREC</a>)</li> REC</a>)</li>
<li>Still misses extension element/function/prefixes support. Support <li>Still misses extension element/function/prefixes support. Support of
ofkey() and document() is not complete</li> key() and document() is not complete</li>
</ul><h3>0.1.0: Feb 8 2001</h3><ul><li>first beta version, released at the same time as libxml2-2.3.0</li> </ul><h3>0.1.0: Feb 8 2001</h3><ul><li>first beta version, released at the same time as libxml2-2.3.0</li>
<li>lots of bug fixes, first "testing" version, but incomplete</li> <li>lots of bug fixes, first "testing" version, but incomplete</li>
</ul><h3>0.0.1: Jan 25 2001</h3><ul><li>first alpha version released at the same time as libxml2-2.2.12</li> </ul><h3>0.0.1: Jan 25 2001</h3><ul><li>first alpha version released at the same time as libxml2-2.2.12</li>
<li>Framework in place, should work on simple examples, but far from <li>Framework in place, should work on simple examples, but far from being
beingfeature complete</li> feature complete</li>
</ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> </ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

204
doc/python.html
View File

@@ -8,52 +8,56 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>Python and bindings</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Python and bindings</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>Python and bindings</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>Python and bindings</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>There is a number of language bindings and wrappers available for <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>There is a number of language bindings and wrappers available for libxml2,
libxml2,the list below is not exhaustive. Please contact the <a href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>(<a href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) inorder to the list below is not exhaustive. Please contact the <a href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>
get updates to this list or to discuss the specific topic of libxml2or (<a href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) in
libxslt wrappers or bindings:</p><ul><li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">MattSergeant</a>developped order to get updates to this list or to discuss the specific topic of libxml2
<a href="http://axkit.org/download/">XML::LibXMLand XML::LibXSLT</a>, or libxslt wrappers or bindings:</p><ul><li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
Perl wrappers for libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML application server</a></li> Sergeant</a> developped <a href="http://axkit.org/download/">XML::LibXML
<li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a>provides and XML::LibXSLT</a>, Perl wrappers for libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML application server</a></li>
andearlier version of the libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for Python</a></li> <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provides and
<li>Petr Kozelka provides <a href="http://sourceforge.net/projects/libxml2-pas">Pascal units to earlier version of the libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for Python</a></li>
gluelibxml2</a>with Kylix, Delphi and other Pascal compilers</li> <li>Petr Kozelka provides <a href="http://sourceforge.net/projects/libxml2-pas">Pascal units to glue
<li>Wai-Sun "Squidster" Chia provides <a href="http://www.rubycolor.org/arc/redist/">bindings for libxml2</a> with Kylix, Delphi and other Pascal compilers</li>
Ruby</a>andlibxml2 bindings are also available in Ruby through the <a href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a>modulemaintained <li>Wai-Sun "Squidster" Chia provides <a href="http://www.rubycolor.org/arc/redist/">bindings for Ruby</a> and
by Tobias Peters.</li> libxml2 bindings are also available in Ruby through the <a href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a> module
<li>Steve Ball and contributors maintains <a href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings maintained by Tobias Peters.</li>
forTcl</a></li> <li>Steve Ball and contributors maintains <a href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings for
<li><a href="mailto:xmlwrapp@pmade.org">Peter Jones</a>maintains Tcl</a></li>
C++bindings for libxslt within <a href="http://pmade.org/pjones/software/xmlwrapp/">xmlwrapp</a></li> <li><a href="mailto:xmlwrapp@pmade.org">Peter Jones</a> maintains C++
<li><a href="phillim2@comcast.net">Mike Phillips</a>provides a moduleusing bindings for libxslt within <a href="http://pmade.org/pjones/software/xmlwrapp/">xmlwrapp</a></li>
<a href="http://siasl.dyndns.org/projects/projects.html">libxsltfor <li><a href="phillim2@comcast.net">Mike Phillips</a> provides a module
PHP</a>.</li> using <a href="http://siasl.dyndns.org/projects/projects.html">libxslt
<li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a>isan for PHP</a>.</li>
effort to create a 100% JAXP-compatible Java wrapper for libxml2 <li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a> is
andlibxslt as part of GNU ClasspathX project.</li> an effort to create a 100% JAXP-compatible Java wrapper for libxml2 and
<li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look libxslt as part of GNU ClasspathX project.</li>
for<a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li> <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look for
<li><a href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>provides <a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li>
<a href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLibosax</a>. <li><a href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>
This is an osax for Mac OS X with a set of commands toimplement in provides <a href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLib
AppleScript the XML DOM, XPATH and XSLT.</li> osax</a>. This is an osax for Mac OS X with a set of commands to
</ul><p>The libxslt Python module depends on the <a href="http://xmlsoft.org/python.html">libxml2 Python</a>module.</p><p>The distribution includes a set of Python bindings, which are garanteed implement in AppleScript the XML DOM, XPATH and XSLT.</li>
tobe maintained as part of the library in the future, though the </ul><p>The libxslt Python module depends on the <a href="http://xmlsoft.org/python.html">libxml2 Python</a> module.</p><p>The distribution includes a set of Python bindings, which are garanteed to
Pythoninterface have not yet reached the completeness of the C API.</p><p><a href="mailto:stephane.bidoul@softwareag.com">St<EFBFBD>phane be maintained as part of the library in the future, though the Python
Bidoul</a>maintains <a href="http://users.skynet.be/sbi/libxml-python/">a interface have not yet reached the completeness of the C API.</p><p><a href="mailto:stephane.bidoul@softwareag.com">St<EFBFBD>phane Bidoul</a>
Windows portof the Python bindings</a>.</p><p>Note to people interested in building bindings, the API is formalized as<a href="libxslt-api.xml">an XML API description file</a>which allows toautomate maintains <a href="http://users.skynet.be/sbi/libxml-python/">a Windows port
a large part of the Python bindings, this includes functiondescriptions, of the Python bindings</a>.</p><p>Note to people interested in building bindings, the API is formalized as
enums, structures, typedefs, etc... The Python script used tobuild the <a href="libxslt-api.xml">an XML API description file</a> which allows to
bindings is python/generator.py in the source distribution.</p><p>To install the Python bindings there are 2 options:</p><ul><li>If you use an RPM based distribution, simply install the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-pythonRPM</a>and automate a large part of the Python bindings, this includes function
the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-pythonRPM</a>.</li> descriptions, enums, structures, typedefs, etc... The Python script used to
<li>Otherwise use the <a href="ftp://xmlsoft.org/libxml2/python/">libxml2-pythonmodule build the bindings is python/generator.py in the source distribution.</p><p>To install the Python bindings there are 2 options:</p><ul><li>If you use an RPM based distribution, simply install the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-python
distribution</a>corresponding to your installed version oflibxml2 and RPM</a> and the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-python
libxslt. Note that to install it you will need both libxml2and libxslt RPM</a>.</li>
installed and run "python setup.py build install" in themodule tree.</li> <li>Otherwise use the <a href="ftp://xmlsoft.org/libxml2/python/">libxml2-python
</ul><p>The distribution includes a set of examples and regression tests for module distribution</a> corresponding to your installed version of
thepython bindings in the <code>python/tests</code>directory. Here are libxml2 and libxslt. Note that to install it you will need both libxml2
someexcepts from those tests:</p><h3>basic.py:</h3><p>This is a basic test of XSLT interfaces: loading a stylesheet and and libxslt installed and run "python setup.py build install" in the
adocument, transforming the document and saving the result.</p><pre>import libxml2 module tree.</li>
</ul><p>The distribution includes a set of examples and regression tests for the
python bindings in the <code>python/tests</code> directory. Here are some
excepts from those tests:</p><h3>basic.py:</h3><p>This is a basic test of XSLT interfaces: loading a stylesheet and a
document, transforming the document and saving the result.</p><pre>import libxml2
import libxslt import libxslt
styledoc = libxml2.parseFile("test.xsl") styledoc = libxml2.parseFile("test.xsl")
@@ -63,28 +67,28 @@ result = style.applyStylesheet(doc, None)
style.saveResultToFilename("foo", result, 0) style.saveResultToFilename("foo", result, 0)
style.freeStylesheet() style.freeStylesheet()
doc.freeDoc() doc.freeDoc()
result.freeDoc()</pre><p>The Python module is called libxslt, you will also need the libxml2 result.freeDoc()</pre><p>The Python module is called libxslt, you will also need the libxml2 module
modulefor the operations on XML trees. Let's have a look at the objects for the operations on XML trees. Let's have a look at the objects manipulated
manipulatedin that example and how is the processing done:</p><ul><li><code>styledoc</code>: is a libxml2 document tree. It is obtained in that example and how is the processing done:</p><ul><li><code>styledoc</code> : is a libxml2 document tree. It is obtained by
byparsing the XML file "test.xsl" containing the stylesheet.</li> parsing the XML file "test.xsl" containing the stylesheet.</li>
<li><code>style</code>: this is a precompiled stylesheet ready to be usedby <li><code>style</code> : this is a precompiled stylesheet ready to be used
the following transformations (note the plural form, by the following transformations (note the plural form, multiple
multipletransformations can resuse the same stylesheet).</li> transformations can resuse the same stylesheet).</li>
<li><code>doc</code>: this is the document to apply the transformation <li><code>doc</code> : this is the document to apply the transformation to.
to.In this case it is simply generated by parsing it from a file but In this case it is simply generated by parsing it from a file but any
anyother processing is possible as long as one get a libxml2 Doc. Note other processing is possible as long as one get a libxml2 Doc. Note that
thatHTML tree are suitable for XSLT processing in libxslt. This is HTML tree are suitable for XSLT processing in libxslt. This is actually
actuallyhow this page is generated !</li> how this page is generated !</li>
<li><code>result</code>: this is a document generated by applying <li><code>result</code> : this is a document generated by applying the
thestylesheet to the document. Note that some of the stylesheet stylesheet to the document. Note that some of the stylesheet informations
informationsmay be related to the serialization of that document and as may be related to the serialization of that document and as in this
in thisexample a specific saveResultToFilename() method of the stylesheet example a specific saveResultToFilename() method of the stylesheet should
shouldbe used to save it to a file (in that case to "foo").</li> be used to save it to a file (in that case to "foo").</li>
</ul><p>Also note the need to explicitely deallocate documents with </ul><p>Also note the need to explicitely deallocate documents with freeDoc()
freeDoc()except for the stylesheet document which is freed when its compiled except for the stylesheet document which is freed when its compiled form is
form isgarbage collected.</p><h3>extfunc.py:</h3><p>This one is a far more complex test. It shows how to modify the garbage collected.</p><h3>extfunc.py:</h3><p>This one is a far more complex test. It shows how to modify the behaviour
behaviourof an XSLT transformation by passing parameters and how to extend of an XSLT transformation by passing parameters and how to extend the XSLT
the XSLTengine with functions defined in python:</p><pre>import libxml2 engine with functions defined in python:</p><pre>import libxml2
import libxslt import libxslt
import string import string
@@ -105,20 +109,20 @@ def f(ctx, str):
return string.upper(str) return string.upper(str)
libxslt.registerExtModuleFunction("foo", "http://example.com/foo", f)</pre><p>This code defines and register an extension function. Note that libxslt.registerExtModuleFunction("foo", "http://example.com/foo", f)</pre><p>This code defines and register an extension function. Note that the
thefunction can be bound to any name (foo) and how the binding is function can be bound to any name (foo) and how the binding is also
alsoassociated to a namespace name "http://example.com/foo". From an XSLT associated to a namespace name "http://example.com/foo". From an XSLT point
pointof view the function just returns an upper case version of the string of view the function just returns an upper case version of the string passed
passedas a parameter. But the first part of the function also read some as a parameter. But the first part of the function also read some contextual
contextualinformation from the current XSLT processing environement, in that information from the current XSLT processing environement, in that case it
case itlooks for the current insertion node in the resulting output (either looks for the current insertion node in the resulting output (either the
theresulting document or the Result Value Tree being generated), and saves it resulting document or the Result Value Tree being generated), and saves it to
toa global variable for checking that the access actually worked.</p><p>For more informations on the xpathParserContext and a global variable for checking that the access actually worked.</p><p>For more informations on the xpathParserContext and transformContext
transformContextobjects check the <a href="internals.html">libray internals objects check the <a href="internals.html">libray internals description</a>.
description</a>.The pctxt is actually an object from a class derived from The pctxt is actually an object from a class derived from the
thelibxml2.xpathParserContext() with just a couple more properties including libxml2.xpathParserContext() with just a couple more properties including the
thepossibility to look up the XSLT transformation context from the possibility to look up the XSLT transformation context from the XPath
XPathcontext.</p><pre>styledoc = libxml2.parseDoc(""" context.</p><pre>styledoc = libxml2.parseDoc("""
&lt;xsl:stylesheet version='1.0' &lt;xsl:stylesheet version='1.0'
xmlns:xsl='http://www.w3.org/1999/XSL/Transform' xmlns:xsl='http://www.w3.org/1999/XSL/Transform'
xmlns:foo='http://example.com/foo' xmlns:foo='http://example.com/foo'
@@ -129,21 +133,21 @@ XPathcontext.</p><pre>styledoc = libxml2.parseDoc("""
&lt;article&gt;&lt;xsl:value-of select='foo:foo($bar)'/&gt;&lt;/article&gt; &lt;article&gt;&lt;xsl:value-of select='foo:foo($bar)'/&gt;&lt;/article&gt;
&lt;/xsl:template&gt; &lt;/xsl:template&gt;
&lt;/xsl:stylesheet&gt; &lt;/xsl:stylesheet&gt;
""")</pre><p>Here is a simple example of how to read an XML document from a """)</pre><p>Here is a simple example of how to read an XML document from a python
pythonstring with libxml2. Note how this stylesheet:</p><ul><li>Uses a global parameter <code>bar</code></li> string with libxml2. Note how this stylesheet:</p><ul><li>Uses a global parameter <code>bar</code></li>
<li>Reference the extension function f</li> <li>Reference the extension function f</li>
<li>how the Namespace name "http://example.com/foo" has to be bound to <li>how the Namespace name "http://example.com/foo" has to be bound to a
aprefix</li> prefix</li>
<li>how that prefix is excluded from the output</li> <li>how that prefix is excluded from the output</li>
<li>how the function is called from the select</li> <li>how the function is called from the select</li>
</ul><pre>style = libxslt.parseStylesheetDoc(styledoc) </ul><pre>style = libxslt.parseStylesheetDoc(styledoc)
doc = libxml2.parseDoc("&lt;doc/&gt;") doc = libxml2.parseDoc("&lt;doc/&gt;")
result = style.applyStylesheet(doc, { "bar": "'success'" }) result = style.applyStylesheet(doc, { "bar": "'success'" })
style.freeStylesheet() style.freeStylesheet()
doc.freeDoc()</pre><p>that part is identical, to the basic example except that thetransformation doc.freeDoc()</pre><p>that part is identical, to the basic example except that the
is passed a dictionnary of parameters. Note that the stringpassed "success" transformation is passed a dictionnary of parameters. Note that the string
had to be quoted, otherwise it is interpreted as an XPathquery for the childs passed "success" had to be quoted, otherwise it is interpreted as an XPath
of root named "success".</p><pre>root = result.children query for the childs of root named "success".</p><pre>root = result.children
if root.name != "article": if root.name != "article":
print "Unexpected root node name" print "Unexpected root node name"
sys.exit(1) sys.exit(1)
@@ -154,14 +158,12 @@ if nodeName != 'article':
print "The function callback failed to access its context" print "The function callback failed to access its context"
sys.exit(1) sys.exit(1)
result.freeDoc()</pre><p>That part just verifies that the transformation worked, that the result.freeDoc()</pre><p>That part just verifies that the transformation worked, that the parameter
parametergot properly passed to the engine, that the function f() got called got properly passed to the engine, that the function f() got called and that
and thatit properly accessed the context to find the name of the insertion it properly accessed the context to find the name of the insertion node.</p><h3>pyxsltproc.py:</h3><p>this module is a bit too long to be described there but it is basically a
node.</p><h3>pyxsltproc.py:</h3><p>this module is a bit too long to be described there but it is basically rewrite of the xsltproc command line interface of libxslt in Python. It
arewrite of the xsltproc command line interface of libxslt in Python. provides nearly all the functionalities of xsltproc and can be used as a base
Itprovides nearly all the functionalities of xsltproc and can be used as a module to write Python customized XSLT processors. One of the thing to notice
basemodule to write Python customized XSLT processors. One of the thing to are:</p><pre>libxml2.lineNumbersDefault(1)
noticeare:</p><pre>libxml2.lineNumbersDefault(1) libxml2.substituteEntitiesDefault(1)</pre><p>those two calls in the main() function are needed to force the libxml2
libxml2.substituteEntitiesDefault(1)</pre><p>those two calls in the main() function are needed to force the processor to generate DOM trees compliant with the XPath data model.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
libxml2processor to generate DOM trees compliant with the XPath data
model.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>

2209
doc/xslt.html
View File

File diff suppressed because it is too large Load Diff

10
doc/xsltproc2.html
View File

@@ -8,11 +8,11 @@ H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline } A:link, A:visited, A:active { text-decoration: underline }
</style><title>The xsltproc tool</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>The xsltproc tool</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, </style><title>The xsltproc tool</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><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"><h1>The XSLT C library for Gnome</h1><h2>The xsltproc tool</h2></td></tr></table></td></tr></table></td></tr></table><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><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="http://xmlsoft.org/wiki">Wiki</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>,
<a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>This program is the simplest way to use libxslt: from the command line. <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><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"><p>This program is the simplest way to use libxslt: from the command line. It
Itis also used for doing the regression tests of the library.</p><p>It takes as first argument the path or URL to an XSLT stylesheet, the is also used for doing the regression tests of the library.</p><p>It takes as first argument the path or URL to an XSLT stylesheet, the next
nextarguments are filenames or URIs of the inputs to be processed. The output arguments are filenames or URIs of the inputs to be processed. The output of
ofthe processing is redirected on the standard output. There is actually a the processing is redirected on the standard output. There is actually a few
fewmore options available:</p><pre>orchis:~ -&gt; xsltproc more options available:</p><pre>orchis:~ -&gt; xsltproc
Usage: xsltproc [options] stylesheet file [file ...] Usage: xsltproc [options] stylesheet file [file ...]
Options: Options:
--version or -V: show the version of libxml and libxslt used --version or -V: show the version of libxml and libxslt used