doc/xslt.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   2     "http://www.w3.org/TR/html4/loose.dtd">
   3 <html>
   4 <head>
   5   <title>The XSLT C library for GNOME</title>
   6   <meta name="GENERATOR" content="amaya 8.5, see http://www.w3.org/Amaya/">
   7   <meta http-equiv="Content-Type" content="text/html">
   8 </head>
   9
  10 <body bgcolor="#ffffff">
  11 <h1 align="center">The XSLT C library for GNOME</h1>
  12
  13 <h1 style="text-align: center">libxslt</h1>
  14
  15 <p>Libxslt is the <a href="http://www.w3.org/TR/xslt">XSLT</a> C library
  16 developed for the GNOME project. XSLT itself is a an XML language to define
  17 transformation for XML. Libxslt is based on <a
  18 href="http://xmlsoft.org/">libxml2</a> the XML C library developed for the
  19 GNOME project. It also implements most of the <a
  20 href="http://www.exslt.org/">EXSLT</a> set of processor-portable extensions
  21 functions and some of Saxon's evaluate and expressions extensions.</p>
  22
  23 <p>People can either embed the library in their application or use xsltproc
  24 the command line processing tool. This library is free software and can be
  25 reused in commercial applications (see the <a href="intro.html">intro</a>)</p>
  26
  27 <p>External documents:</p>
  28 <ul>
  29   <li>John Fleck wrote <a href="tutorial/libxslttutorial.html">a tutorial for
  30     libxslt</a></li>
  31   <li><a href="xsltproc.html">xsltproc user manual</a></li>
  32   <li><a href="http://xmlsoft.org/">the libxml documentation</a></li>
  33 </ul>
  34
  35 <p></p>
  36
  37 <p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p>
  38
  39 <h2><a name="Introducti">Introduction</a></h2>
  40
  41 <p>This document describes <a href="http://xmlsoft.org/XSLT/">libxslt</a>,
  42 the <a href="http://www.w3.org/TR/xslt">XSLT</a> C library developed for the
  43 <a href="http://www.gnome.org/">GNOME</a> project.</p>
  44
  45 <p>Here are some key points about libxslt:</p>
  46 <ul>
  47   <li>Libxslt is a C implementation</li>
  48   <li>Libxslt is based on libxml for XML parsing, tree manipulation and XPath
  49     support</li>
  50   <li>It is written in plain C, making as few assumptions as possible, and
  51     sticking closely to ANSI C/POSIX for easy embedding. Should works on
  52     Linux/Unix/Windows.</li>
  53   <li>This library is released under the <a
  54     href="http://www.opensource.org/licenses/mit-license.html">MIT
  55   Licence</a></li>
  56   <li>Though not designed primarily with performances in mind, libxslt seems
  57     to be a relatively fast processor.</li>
  58 </ul>
  59
  60 <h2><a name="Documentat">Documentation</a></h2>
  61
  62 <p>There are some on-line resources about using libxslt:</p>
  63 <ol>
  64   <li>Check the <a href="html/libxslt-lib.html#LIBXSLT-LIB">API
  65     documentation</a> automatically extracted from code comments (using the
  66     program apibuild.py, developed for libxml, together with the xsl script
  67     'newapi.xsl' and the libxslt xsltproc program).</li>
  68   <li>Look at the <a href="http://mail.gnome.org/archives/xslt/">mailing-list
  69     archive</a>.</li>
  70   <li>Of course since libxslt is based on libxml, it's a good idea to at
  71     least read <a href="http://xmlsoft.org/">libxml description</a></li>
  72 </ol>
  73
  74 <h2><a name="Reporting">Reporting bugs and getting help</a></h2>
  75
  76 <p>If you need help with the XSLT language itself, here are a number of
  77 useful resources:</p>
  78 <ul>
  79   <li>I strongly suggest to subscribe to <a
  80     href="http://www.mulberrytech.com/xsl/xsl-list">XSL-list</a>, check <a
  81     href="http://www.biglist.com/lists/xsl-list/archives/">the XSL-list
  82     archives</a></li>
  83   <li>The <a href="http://www.dpawson.co.uk/xsl/xslfaq.html">XSL FAQ</a>.</li>
  84   <li>The <a
  85     href="http://www.nwalsh.com/docs/tutorials/xsl/xsl/slides.html">tutorial</a>
  86     written by Paul Grosso and Norman Walsh is a very good on-line
  87     introdution to the language.</li>
  88   <li>The <a
  89     href="http://www.zvon.org/xxl/XSLTutorial/Books/Book1/index.html">only
  90     Zvon XSLT tutorial</a> details a lot of constructs with examples.</li>
  91   <li><a href="http://www.jenitennison.com/xslt/index.html">Jeni Tennison's
  92     XSLT</a> pages provide links to a lot of answers</li>
  93   <li>the <a href="http://incrementaldevelopment.com/xsltrick/">Gallery of
  94     XSLT Tricks</a> provides non-standard use case of XSLT</li>
  95   <li>And I suggest to buy Michael Kay "XSLT Programmer's Reference" book
  96     published by <a href="http://www.wrox.com/">Wrox</a> if you plan to work
  97     seriously with XSLT in the future.</li>
  98 </ul>
  99
 100 <p>Well, bugs or missing features are always possible, and I will make a
 101 point of fixing them in a timely fashion. The best way to report a bug is to
 102 use the <a
 103 href="http://bugzilla.gnome.org/enter_bug.cgi?product=libxslt">GNOME bug
 104 tracking database</a> (make sure to use the "libxslt" module name). Before
 105 filing a bug, check the <a
 106 href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">list of existing
 107 libxslt bugs</a> to make sure it hasn't already been filed. I look at reports
 108 there regularly and it's good to have a reminder when a bug is still open. Be
 109 sure to specify that the bug is for the package libxslt.</p>
 110
 111 <p>For small problems you can try to get help on IRC, the #xml channel on
 112 irc.gnome.org (port 6667) usually have a few person subscribed which may help
 113 (but there is no guarantee and if a real issue is raised it should go on the
 114 mailing-list for archival).</p>
 115
 116 <p>There is also a mailing-list <a
 117 href="mailto:xslt@gnome.org">xslt@gnome.org</a> for libxslt, with an <a
 118 href="http://mail.gnome.org/archives/xslt/">on-line archive</a>. To subscribe
 119 to this list, please visit the <a
 120 href="http://mail.gnome.org/mailman/listinfo/xslt">associated Web</a> page
 121 and follow the instructions.</p>
 122
 123 <p>Alternatively, you can just send the bug to the <a
 124 href="mailto:xslt@gnome.org">xslt@gnome.org</a> list, if it's really libxslt
 125 related I will approve it.. Please do not send me mail directly especially
 126 for portability problem, it makes things really harder to track and in some
 127 cases I'm not the best person to answer a given question, ask the list
 128 instead. <strong>Do not send code, I won't debug it</strong> (but patches are
 129 really appreciated!).</p>
 130
 131 <p>Please note that with the current amount of virus and SPAM, sending mail
 132 to the list without being subscribed won't work. There is *far too many
 133 bounces* (in the order of a thousand a day !) I cannot approve them manually
 134 anymore. If your mail to the list bounced waiting for administrator approval,
 135 it is LOST ! Repost it and fix the problem triggering the error. Also please
 136 note that <span style="color: #FF0000; background-color: #FFFFFF">emails with
 137 a legal warning asking to not copy or redistribute freely the information
 138 they contain</span> are <strong>NOT</strong> acceptable for the mailing-list,
 139 such mail will as much as possible be discarded automatically, and are less
 140 likely to be answered if they made it to the list, <strong>DO NOT</strong>
 141 post to the list from an email address where such legal requirements are
 142 automatically added, get private paying support if you can't share
 143 information.</p>
 144
 145 <p>Check the following too <span style="color: #E50000">before
 146 posting</span>:</p>
 147 <ul>
 148   <li><a href="search.php">use the search engine</a> to get information
 149     related to your problem.</li>
 150   <li>make sure you are <a href="ftp://xmlsoft.org/libxslt/">using a recent
 151     version</a>, and that the problem still shows up in those</li>
 152   <li>check the <a href="http://mail.gnome.org/archives/xslt/">list
 153     archives</a> to see if the problem was reported already, in this case
 154     there is probably a fix available, similarly check the <a
 155     href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">registered
 156     open bugs</a></li>
 157   <li>make sure you can reproduce the bug with xsltproc, a very useful thing
 158     to do is run the transformation with -v argument and redirect the
 159     standard error to a file, then search in this file for the transformation
 160     logs just preceding the possible problem</li>
 161   <li>Please send the command showing the error as well as the input and
 162     stylesheet (as an attachment)</li>
 163 </ul>
 164
 165 <p>Then send the bug with associated information to reproduce it to the <a
 166 href="mailto:xslt@gnome.org">xslt@gnome.org</a> list; if it's really libxslt
 167 related I will approve it. Please do not send mail to me directly, it makes
 168 things really hard to track and in some cases I am not the best person to
 169 answer a given question, ask on the list.</p>
 170
 171 <p>To <span style="color: #E50000">be really clear about support</span>:</p>
 172 <ul>
 173   <li>Support or help <span style="color: #E50000">request MUST be sent to
 174     the list or on bugzilla</span> in case of problems, so that the Question
 175     and Answers can be shared publicly. Failing to do so carries the implicit
 176     message "I want free support but I don't want to share the benefits with
 177     others" and is not welcome. I will automatically Carbon-Copy the
 178     xslt@gnome.org mailing list for any technical reply made about libxml2 or
 179     libxslt.</li>
 180   <li>There is <span style="color: #E50000">no guarantee for support</span>,
 181     if your question remains unanswered after a week, repost it, making sure
 182     you gave all the detail needed and the information requested.</li>
 183   <li>Failing to provide information as requested or double checking first
 184     for prior feedback also carries the implicit message "the time of the
 185     library maintainers is less valuable than my time" and might not be
 186     welcome.</li>
 187 </ul>
 188
 189 <p>Of course, bugs reports with a suggested patch for fixing them will
 190 probably be processed faster.</p>
 191
 192 <p>If you're looking for help, a quick look at <a
 193 href="http://mail.gnome.org/archives/xslt/">the list archive</a> may actually
 194 provide the answer, I usually send source samples when answering libxslt
 195 usage questions. The <a
 196 href="html/libxslt-lib.html#LIBXSLT-LIB">auto-generated documentation</a> is
 197 not as polished as I would like (I need to learn more about Docbook), but
 198 it's a good starting point.</p>
 199
 200 <h2><a name="help">How to help</a></h2>
 201
 202 <p>You can help the project in various ways, the best thing to do first is to
 203 subscribe to the mailing-list as explained before, check the <a
 204 href="http://mail.gnome.org/archives/xslt/">archives </a>and the <a
 205 href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">GNOME bug
 206 database:</a>:</p>
 207 <ol>
 208   <li>provide patches when you find problems</li>
 209   <li>provide the diffs when you port libxslt to a new platform. They may not
 210     be integrated in all cases but help pinpointing portability problems
 211   and</li>
 212   <li>provide documentation fixes (either as patches to the code comments or
 213     as HTML diffs).</li>
 214   <li>provide new documentations pieces (translations, examples, etc ...)</li>
 215   <li>Check the TODO file and try to close one of the items</li>
 216   <li>take one of the points raised in the archive or the bug database and
 217     provide a fix. <a href="mailto:daniel@veillard.com">Get in touch with me
 218     </a>before to avoid synchronization problems and check that the suggested
 219     fix will fit in nicely :-)</li>
 220 </ol>
 221
 222 <h2><a name="Downloads">Downloads</a></h2>
 223
 224 <p>The latest versions of libxslt can be found on the <a
 225 href="ftp://xmlsoft.org/libxslt/">xmlsoft.org</a> server and on mirrors (<a
 226 href="ftp://fr.rpmfind.net/pub/libxml/">France</a>) or on the <a
 227 href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">GNOME FTP server</a> as a
 228 <a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxslt/1.1/">source
 229 archive</a>, Antonin Sprinzl also provides <a
 230 href="ftp://gd.tuwien.ac.at/pub/libxml/">a mirror in Austria</a>. (NOTE that
 231 you need the <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a>,
 232 <a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>,
 233 <a href="http://rpmfind.net/linux/RPM/libxslt.html">libxslt</a> and <a
 234 href="http://rpmfind.net/linux/RPM/libxslt-devel.html">libxslt-devel</a>
 235 packages installed to compile applications using libxslt.) <a
 236 href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the maintainer of
 237 the Windows port, <a
 238 href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
 239 binaries</a>. <a href="http://opencsw.org/">CSW</a> provides
 240 <a href="http://opencsw.org/packages/libxslt">Solaris binaries</a>, and
 241 <a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> provides <a
 242 href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os X
 243 binaries</a>.</p>
 244
 245 <p><a name="Contribs">Contribs:</a></p>
 246
 247 <p>I do accept external contributions, especially if compiling on another
 248 platform, get in touch with me to upload the package. I will keep them in the
 249 <a href="ftp://xmlsoft.org/libxml2/contribs/">contrib directory</a></p>
 250
 251 <p>Libxslt is also available from SVN:</p>
 252 <ul>
 253   <li><p>The <a href="http://svn.gnome.org/viewcvs/libxslt/trunk/">GNOME SVN
 254     base</a>. Check the <a
 255     href="http://developer.gnome.org/tools/svn.html">GNOME SVN Tools</a>
 256     page; the SVN module is <b>libxslt</b>.</p>
 257   </li>
 258   <li><a href="ftp://xmlsoft.org/libxml2/libxslt-cvs-snapshot.tar.gz">snapshots from
 259     SVN</a> updated every hour are also provided</li>
 260 </ul>
 261
 262 <h2><a name="FAQ">FAQ</a></h2>
 263 <ol>
 264   <li><em>Troubles compiling or linking programs using libxslt</em>
 265     <p>Usually the problem comes from the fact that the compiler doesn't get
 266     the right compilation or linking flags. There is a small shell script
 267     <code>xslt-config</code> which is installed as part of libxslt usual
 268     install process which provides those flags. Use</p>
 269     <p><code>xslt-config --cflags</code></p>
 270     <p>to get the compilation flags and</p>
 271     <p><code>xslt-config --libs</code></p>
 272     <p>to get the linker flags. Usually this is done directly from the
 273     Makefile as:</p>
 274     <p><code>CFLAGS=`xslt-config --cflags`</code></p>
 275     <p><code>LIBS=`xslt-config --libs`</code></p>
 276     <p>Note also that if you use the EXSLT extensions from the program then
 277     you should prepend <code>-lexslt</code> to the LIBS options</p>
 278   </li>
 279   <li><em>passing parameters on the xsltproc command line doesn't work</em>
 280     <p><em>xsltproc --param test alpha foo.xsl foo.xml</em></p>
 281     <p><em>the param does not get passed and ends up as ""</em></p>
 282     <p>In a nutshell do a double escaping at the shell prompt:</p>
 283     <p>xsltproc --param test "'alpha'" foo.xsl foo.xml</p>
 284     <p>i.e. the string value is surrounded by " and ' then terminated by '
 285     and ". Libxslt interpret the parameter values as XPath expressions, so
 286     the string -&gt;<code>alpha</code>&lt;- is intepreted as the node set
 287     matching this string. You really want -&gt;<code>'alpha'</code>&lt;- to
 288     be passed to the processor. And to allow this you need to escape the
 289     quotes at the shell level using -&gt;<code>"'alpha'"</code>&lt;- .</p>
 290     <p>or use</p>
 291     <p>xsltproc --stringparam test alpha foo.xsl foo.xml</p>
 292   </li>
 293   <li><em>Is there C++ bindings ?</em>
 294     <p>Yes for example <a
 295     href="http://pmade.org/pjones/software/xmlwrapp/">xmlwrapp</a> , see <a
 296     href="python.html">the related pages about bindings</a></p>
 297   </li>
 298 </ol>
 299
 300 <h2><a name="News">News</a></h2>
 301
 302 <p>The <a href="ChangeLog.html">change log</a> describes the recents commits
 303 to the <a href="http://svn.gnome.org/viewcvs/libxslt/trunk/">SVN</a> code base.</p>
 304
 305 <p>Those are the public releases made:</p>
 306
 307 <h3>1.1.26: Sep 24 2009</h3>
 308 <ul>
 309   <li> Improvement:
 310     Add xsltProcessOneNode to exported symbols for lxml (Daniel Veillard)
 311   </li>
 312   <li> Bug fixes:
 313     Fix an idness generation problem (Daniel Veillard),
 314     595612 Try to fix some locking problems (Daniel Veillard),
 315     Fix a crash on misformed imported stylesheets (Daniel Veillard)
 316   </li>
 317 </ul>
 318 <h3>1.1.25: Sep 17 2009</h3>
 319 <ul>
 320   <li> Features:
 321       Add API versioning and various cleanups (Daniel Veillard),
 322       xsl:sort lang support using the locale (Nick Wellnhofer and Roumen Petrov)
 323   </li>
 324   <li> Documentation:
 325       Fix the download links for Solaris (Daniel Veillard),
 326       Fix makefile and spec file to include doc in rpm (Daniel Veillard)
 327   </li>
 328   <li> Portability:
 329       Make sure testThreads is linked with pthreads (Daniel Veillard),
 330       Fix potential crash on debug of extensions Solaris (Ben Walton),
 331       applied patch from Roumen Petrov for mingw cross compilation problems (Roumen Petrov),
 332       patch from Richard Jones to build shared libs with MinGW cross-compiler (Richard Jones),
 333       fix include path when compiling with MinGW (Roumen Petrov),
 334       portability fixes ( Nick Wellnhofer and Roumen Petrov)
 335   </li>
 336   <li> Bug fixes:
 337       Big fixes of pattern compilations (Nick Wellnhofer),
 338       Fix uses of xmlAddChild for error handling (Daniel Veillard),
 339       Detect deep recusion on function calls (Daniel Veillard),
 340       Avoid an error in namespace generation (Martin),
 341       Fix importing of encoding from included stylesheets (Nick Wellnhofer),
 342       Fix problems with embedded stylesheets and namespaces (Martin),
 343       QName parsing fix for patterns (Martin),
 344       Crash compiling stylesheet with DTD (Martin),
 345       Fix xsl:strip-space with namespace and wildcard (Nick Wellnhofer),
 346       Fix a mutex deadlock on unregistered extensions (Nix),
 347       567192 xsltproc --output option ignore --xinclude (Joachim Breitner),
 348       Fix redundant headers in list (Daniel Veillard),
 349       134754 Configure's --with-html-dir related fixes (Julio M. Merino Vidal),
 350       305913 a serious problem in extensions reentrancy (Daniel Veillard),
 351       Fix an idness issue when building the tree (Daniel Veillard),
 352       Fixed indexing error reported by Ron Burk on the mailing list. (William M. Brack),
 353       prevent some unchecked pointer accesses (Jake Goulding),
 354       fix for CVE-2008-2935 libexslt RC4 encryption/decryption functions Daniel (Daniel Veillard),
 355       avoid a quadratic behaviour when hitting duplicates (Daniel Veillard),
 356       544829 fixed option --with-debugger (Arun Ragnavan),
 357       541965 fixed incorrect argument popping in exsltMathAtan2Function (William M. Brack),
 358       fix problem with string check for element-available (Ron Burk),
 359       539741 added code to handle literal within an AVT (William M. Brack)
 360   </li>
 361   <li> Improvements:
 362       Allow use of EXSLT outside XSLT (Martin),
 363       Support Esperanto locale (Nick Wellnhofer),
 364       Change how attributes are copied for id and speed (Daniel Veillard),
 365       Add API versioning and various cleanups (Daniel Veillard),
 366       Adding a test program to check thread reentrancy (Daniel Veillard),
 367       big patch from  finishing xsl:sort lang support (Roumen Petrov),
 368       add xsl:sort lang support using the locale (Nick Wellnhofer)
 369   </li>
 370   <li> Cleanups:
 371       Label xsltProcessOneNode as static (Daniel Veillard),
 372       git setup (Daniel Veillard),
 373       fixed typo detected by new libxml2 code (William M. Brack),
 374       xsltExtFunctionLookup was defined but never implemented (Ralf Junker)
 375   </li>
 376 </ul>
 377 <h3>1.1.24: May 13 2008</h3>
 378 <ul>
 379   <li>Documentation: man page fix (Vincent Lefevre).</li>
 380   <li>Bug fixes: pattern bug fix, key initialization problems, exclusion of
 381       unknown namespaced element on top of stylesheets, python generator
 382       syntactic cleanup (Martin)</li>
 383 </ul>
 384 <h3>1.1.23: Apr  8 2008</h3>
 385 <ul>
 386   <li>Documentation: fix links for Cygwin DocBook setup (Philippe Bourcier),
 387       xsltParseStylesheetDoc doc fix (Jason Viers), fix manpage default
 388       maxdepth value </li>
 389   <li>Bug fixes: python segfault (Daniel Gryniewicz), week-in-year bug fix
 390       (Maurice van der Pot), fix python iterator problem (William Brack),
 391       avoid garbage collection problems on str:tokenize and str:split
 392       and function results (William Brack and Peter Pawlowski)
 393       superfluous re-generation of keys (William Brack), remove superfluous
 394       code in xsltExtInitTest (Tony Graham), func:result segfault fix
 395       (William Brack), timezone offset problem (Peter Pawlowski),</li>
 396   <li>Portability fixes: old gcrypt support fix (Brent Cowgill), Python
 397       portability patch (Stephane Bidoul), VS 2008 fix (Rob Richard) </li>
 398 </ul>
 399 <h3>1.1.22: Aug 23 2007</h3>
 400 <ul>
 401   <li>Bug fixes: RVT cleanup problems (William Brack), exclude-result-prefix
 402       bug (William Brack), stylesheet compilation error handling (Rob Richards).
 403       </li>
 404   <li>Portability fixes: improve build with VS2005 (Rob Richards),
 405       fixing build on AIX (Bjorn Wiberg), fix the security file checks on
 406       Windows (Roland Schwarz and Rob Richards). </li>
 407   <li>Improvement: add an --encoding option to xsltproc (Drazen Kacar). </li>
 408 </ul>
 409 <h3>1.1.21: Jun 12 2007</h3>
 410 <ul>
 411   <li>Bug fixes: out of memory allocation errors (William Brack),
 412       namespace problem on compound predicates (William Brack),
 413       python space/tab inconsistencies (Andreas Hanke), hook xsl:message
 414       to per transformation error callbacks (Shaun McCance),
 415       cached RVT problem (William Brack), XPath context maintainance
 416       on choose (William Brack), memory leaks in the math module (William
 417       Brack), exclude-result-prefix induced namespace problem (William
 418       Brack)</li>
 419   <li>Build: configure setup for TRIO_REPLACE_STDIO (William Brack)
 420   <li>Documentation: updated after change from CVs to SVN (William Brack)</li>
 421 </ul>
 422 <h3>1.1.20: Jan 17 2007</h3>
 423 <ul>
 424   <li>Portability fixes: strict aliasing fix (Marcus Meissner), BSD portability
 425       patches (Roland Illig)</li>
 426   <li>Bug fixes: Result Value Tree handling fix (William Brack), function
 427       parameters fix (William), uninitialized variable (Kjartan Maraas),
 428       empty text node handling (William), plugin support and test fixes (William),
 429       fragment support fixes (William)</li>
 430   <li>Improvements: python stylesheet compare and transform context
 431       access (Nic Ferrier), EXSLT string replace support (Joel Reed),
 432       xsltproc better low level error handling (Mike Hommey and William)</li>
 433 </ul>
 434 <h3>1.1.19: Nov 29 2006</h3>
 435 <ul>
 436   <li>Bug fixes: entities within attributes (William Brack), Python detection
 437       problem (Joseph Sacco), in-scope namespace bug (Mike Hommey), Result
 438       value tree caching bug (William Brack)</li>
 439 </ul>
 440 <h3>1.1.18: Oct 26 2006</h3>
 441 <ul>
 442   <li>portability and build fixes: DESTDIR problem, build paths in python
 443       shared lib, compile when libxml2 doesn't support XInclude (Gary Coady).</li>
 444   <li>bug fixes: a number of namespace related bugs (Kasimier Buchcik),
 445       parameters bugs (Kasimier Buchcik), proximity position in predicates
 446       of match patterns (Kasimier), exslt-node-set troubles with strings
 447       (Kasimier), CDATA serialization, Python floats and booleans XPath
 448       conversions, XInclude support fixes, RVT cleanup problem (William Brack
 449       and Kasimier), attribute checking in stylesheets (Kasimier), xsltForEach
 450       context problem (Kasimier), security check should pass full URLs (Shane
 451       Corgatelli), security cleanup patch (Mikhail Zabaluev), some python
 452       accessor for stylesheet were broken, memory errors when compiling
 453       stylesheets (Mike Hommey), EXSLT current date end-of-month problem
 454       (William Brack).</li>
 455   <li>improvements: refactoring of namespace handling, value-of impleemntation
 456       and template internal processing (Kasimier Buchcik), new xsltproc
 457       flag to apply Xinclude to stylesheets.</li>
 458   <li>documentation: xsltproc man pages (Daniel Leidert), tests updates
 459       (William Brack), various typo fixes (Daniel Leidert), comments on
 460       versions macros (Peter Breitenlohner).</li>
 461 </ul>
 462 <h3>1.1.17: Jun 6 2006</h3>
 463 <ul>
 464   <li>portability fixes: python detection</li>
 465   <li>bug fixes: some regression tests, attribute/namespaces output (Kasimier
 466     Buchcik), problem in mixed xsl:value-of and xsl:text uses (Kasimier)</li>
 467   <li>improvements: internal refactoring (Kasimier Buchcik), use of the XPath
 468     object cache in libxml2-2.6.25 (Kasimier)</li>
 469 </ul>
 470
 471 <h3>1.1.16: May 01 2006</h3>
 472 <ul>
 473   <li>portability fixes: EXSLT date/time on Solaris and IRIX (Albert Chin),
 474       HP-UX  build (Albert Chin),
 475   <li>build fixes: Python detection(Joseph Sacco), plugin configurei
 476       (Joel Reed)</li>
 477   <li>bug fixes: pattern compilation fix(William Brack), EXSLT date/time
 478       fix (Thomas Broyer), EXSLT function bug, potential loop on variable
 479       eval, startup race (Christopher Palmer), debug statement left in python
 480       (Nic Ferrier), various cleanup based on Coverity reports), error on
 481       Out of memory condition (Charles Hardin), various namespace prefixes
 482       fixes (Kasimier Buchcik), </li>
 483   <li>improvement: speed up sortingi, start of internals refactoring (Kasimier
 484       Buchcik)</li>
 485   <li>documentation: man page fixes and updates (Daniel Leidert)
 486 </ul>
 487
 488 <h3>1.1.15: Sep 04 2005</h3>
 489 <ul>
 490   <li>build fixes: Windows build cleanups and updates (Igor Zlatkovic),
 491     remove jhbuild warnings</li>
 492   <li>bug fixes: negative number formatting (William Brack), number
 493     formatting per mille definition (William Brack), XInclude default values
 494     (William), text copy bugs (William), bug related to xmlXPathContext size,
 495     reuse libxml2 memory management for text nodes, dictionary text bug,
 496     forbid variables in match (needs libxml2-2.6.21)</li>
 497   <li>improvements: EXSLT dyn:map (Mark Vakoc),</li>
 498   <li>documentation: EXSLT date and time functions namespace in man (Jonathan
 499     Wakely)</li>
 500 </ul>
 501
 502 <h3>1.1.14: Apr 02 2005</h3>
 503 <ul>
 504   <li>bug fixes: text node on stylesheet document without a dictionary
 505     (William Brack), more checking of XSLT syntax, calling xsltInit()
 506     multiple times, mode values interning raised by Mark Vakoc, bug in
 507     pattern matching with ancestors, bug in patterna matching with cascading
 508     select, xinclude and document() problem, build outside of source tree
 509     (Mike Castle)</li>
 510   <li>improvement: added a --nodict mode to xsltproc to check problems for
 511     docuemtns without dictionaries</li>
 512 </ul>
 513
 514 <h3>1.1.13: Mar 13 2005</h3>
 515 <ul>
 516   <li>build fixes: 64bits cleanup (William Brack), python 2.4 test (William),
 517     LIBXSLT_VERSION_EXTRA on Windows (William), Windows makefiles fixes (Joel
 518     Reed), libgcrypt-devel requires for RPM spec.</li>
 519   <li>bug fixes: exslt day-of-week-in-month (Sal Paradise), xsl:call-template
 520     should not change the current template rule (William Brack), evaluation
 521     of global variables (William Brack), RVT's in XPath predicates (William),
 522     namespace URI on template names (Mark Vakoc), stat() for Windows patch
 523     (Aleksey Gurtovoy), pattern expression fixes (William Brack), out of
 524     memory detection misses (William), parserOptions propagation (William),
 525     exclude-result-prefixes fix (William), // patten fix (William).</li>
 526   <li>extensions: module support (Joel Reed), dictionary based speedups
 527     trying to get rid of xmlStrEqual as much as possible.</li>
 528   <li>documentation: added Wiki (Joel Reed)</li>
 529 </ul>
 530
 531 <h3>1.1.12: Oct 29 2004</h3>
 532 <ul>
 533   <li>build fixes: warnings removal (William).</li>
 534   <li>bug fixes: attribute document pointer fix (Mark Vakoc), exslt date
 535     negative periods (William Brack), generated tree structure fixes,
 536     namespace lookup fix, use reentrant gmtime_r (William Brack),
 537     exslt:funtion namespace fix (William), potential NULL pointer reference
 538     (Dennis Dams, William), force string interning on generated
 539   documents.</li>
 540   <li>documentation: update of the second tutorial (Panagiotis Louridas), add
 541     exslt doc in rpm packages, fix the xsltproc man page.</li>
 542 </ul>
 543
 544 <h3>1.1.11: Sep 29 2004</h3>
 545 <ul>
 546   <li>bug fixes: xsl:include problems (William Brack), UTF8 number pattern
 547     (William), date-time validation (William), namespace fix (William),
 548     various Exslt date fixes (William), error callback fixes, leak with
 549     namespaced global variable, attempt to fix a weird problem #153137</li>
 550   <li>improvements: exslt:date-sum tests (Derek Poon)</li>
 551   <li>documentation: second tutorial by Panagiotis Lourida</li>
 552 </ul>
 553
 554 <h3>1.1.10: Aug 31 2004</h3>
 555 <ul>
 556   <li>build fix: NUL in c file blocking compilation on Solaris, Windows build
 557     (Igor Zlatkovic)</li>
 558   <li>fix: key initialization problem (William Brack)</li>
 559   <li>documentation: fixed missing man page description for --path</li>
 560 </ul>
 561
 562 <h3>1.1.9: Aug 22 2004</h3>
 563 <ul>
 564   <li>build fixes: missing tests (William Brack), Python dependancies, Python
 565     on 64bits boxes, --with-crypto flag (Rob Richards),</li>
 566   <li>fixes: RVT key handling (William), Python binding (William and Sitsofe
 567     Wheeler), key and XPath troubles (William), template priority on imports
 568     (William), str:tokenize with empty strings (William), #default namespace
 569     alias behaviour (William), doc ordering missing for main document
 570     (William), 64bit bug (Andreas Schwab)</li>
 571   <li>improvements: EXSLT date:sum added (Joel Reed), hook for document
 572     loading for David Hyatt, xsltproc --nodtdattr to avoid defaulting DTD
 573     attributes, extend xsltproc --version with CVS stamp (William).</li>
 574   <li>Documentation: web page problem reported by Oliver Stoeneberg</li>
 575 </ul>
 576
 577 <h3>1.1.8: July 5 2004</h3>
 578 <ul>
 579   <li>build fixes: Windows runtime options (Oliver Stoeneberg), Windows
 580     binary package layout (Igor Zlatkovic), libgcrypt version test and link
 581     (William)</li>
 582   <li>documentation: fix libxslt namespace name in doc (William)</li>
 583   <li>bug fixes: undefined namespace message (William Brack), search engine
 584     (William), multiple namespace fixups (William), namespace fix for key
 585     evaluation (William), Python memory debug bindings,</li>
 586   <li>improvements: crypto extensions for exslt (Joel Reed, William)</li>
 587 </ul>
 588
 589 <h3>1.1.7: May 17 2004</h3>
 590 <ul>
 591   <li>build fix: warning about localtime_r on Solaris</li>
 592   <li>bug fix: UTF8 string tokenize (William Brack), subtle memory
 593     corruption, linefeed after comment at document level (William),
 594     disable-output-escaping problem (William), pattern compilation in deep
 595     imported stylesheets (William), namespace extension prefix bug,
 596     libxslt.m4 bug (Edward Rudd), namespace lookup for attribute, namespaced
 597     DOCTYPE name</li>
 598 </ul>
 599
 600 <h3>1.1.6: Apr 18 2004</h3>
 601 <ul>
 602   <li>2 bug fixes about keys fixed one by Mark Vakoc</li>
 603 </ul>
 604
 605 <h3>1.1.5: Mar 23 2004</h3>
 606 <ul>
 607   <li>performance: use dictionary lookup for variables</li>
 608   <li>remove use of _private from source documents</li>
 609   <li>cleanup of "make tests" output</li>
 610   <li>bugfixes: AVT in local variables, use localtime_r to avoid thread
 611     troubles (William), dictionary handling bug (William), limited number of
 612     stubstitutions in AVT (William), tokenize fix for UTF-8 (William),
 613     superfluous namespace (William), xsltproc error code on
 614     &lt;xsl:message&gt; halt, OpenVMS fix, dictionary reference counting
 615     change.</li>
 616 </ul>
 617
 618 <h3>1.1.4: Feb 23 2004</h3>
 619 <ul>
 620   <li>bugfixes: attributes without doc (Mariano Suárez-Alvarez), problem with
 621     Yelp, extension problem</li>
 622   <li>display extension modules (Steve Little)</li>
 623   <li>Windows compilation patch (Mark Vadoc), Mingw (Mikhail Grushinskiy)</li>
 624 </ul>
 625
 626 <h3>1.1.3: Feb 16 2004</h3>
 627 <ul>
 628   <li>Rewrote the Attribute Value Template code, new XPath compilation
 629     interfaces, dictionary reuses for XSLT with potential for serious
 630     performance improvements.</li>
 631   <li>bug fixes: portability (William Brack), key() in node-set() results
 632     (William), comment before doctype (William), math and node-set() problems
 633     (William), cdata element and default namespace (William), behaviour on
 634     unknown XSLT elements (Stefan Kost), priority of "//foo" patterns
 635     (William), xsl:element and xsl:attribute QName check (William), comments
 636     with -- (William), attribute namespace (William), check for ?&gt; in PI
 637     (William)</li>
 638   <li>Documentations: cleanup (John Fleck and William)</li>
 639   <li>Python: patch for OS-X (Gianni Ceccarelli), enums export (Stephane
 640     bidoul)</li>
 641 </ul>
 642
 643 <h3>1.1.2: Dec 24 2003</h3>
 644 <ul>
 645   <li>Documentation fixes (John Fleck, William Brack), EXSLT documentation
 646     (William Brack)</li>
 647   <li>Windows compilation fixes for MSVC and Mingw (Igor Zlatkovic)</li>
 648   <li>Bug fixes: exslt:date returning NULL strings (William Brack),
 649     namespaces output (William Brack),  key and namespace definition problem,
 650     passing options down to the document() parser, xsl:number fixes (William
 651     Brack)</li>
 652 </ul>
 653
 654 <h3>1.1.1: Dec 10 2003</h3>
 655 <ul>
 656   <li>code cleanup (William Brack)</li>
 657   <li>Windows: Makefile improvements (Igor Zlatkovic)</li>
 658   <li>documentation improvements: William Brack, libexslt man page (Jonathan
 659     Wakely)</li>
 660   <li>param in EXSLT functions (Shaun McCance)</li>
 661   <li>XSLT debugging improvements (Mark Vakoc)</li>
 662   <li>bug fixes: number formatting (Bjorn Reese), exslt:tokenize (William
 663     Brack), key selector parsing with | reported by Oleg Paraschenko,
 664     xsl:element with computed namespaces (William Brack), xslt:import/include
 665     recursion detection (William Brack), exslt:function used in keys (William
 666     Brack), bug when CDATA_SECTION are foun in the tree (William Brack),
 667     entities handling when using XInclude.</li>
 668 </ul>
 669
 670 <h3>1.1.0: Nov 4 2003</h3>
 671 <ul>
 672   <li>Removed DocBook SGML broken support</li>
 673   <li>fix xsl:key to work with PIs</li>
 674   <li>Makefile and build improvement (Graham Wilson), build cleanup (William
 675     Brack), macro fix (Justin Fletcher), build outside of source tree (Roumen
 676     Petrov)</li>
 677   <li>xsltproc option display fix (Alexey Efimov), --load-trace (Crutcher
 678     Dunnavant)</li>
 679   <li>Python: never use stdout for error</li>
 680   <li>extension memory error fix (Karl Eichwalder)</li>
 681   <li>header path fixes (Steve Ball)</li>
 682   <li>added saxon:line-number() to libexslt (Brett Kail)</li>
 683   <li>Fix some tortuous template problems when using predicates (William
 684     Brack)</li>
 685   <li>Debugger status patch (Kasimier Buchcik)</li>
 686   <li>Use new libxml2-2.6.x APIs for faster processing</li>
 687   <li>Make sure xsl:sort is empty</li>
 688   <li>Fixed a bug in default processing of attributes</li>
 689   <li>Removes the deprecated breakpoint library</li>
 690   <li>detect invalid names on templates (William Brack)</li>
 691   <li>fix exslt:document (and similar) base handling problem</li>
 692 </ul>
 693
 694 <h3>1.0.33: Sep 12 2003</h3>
 695
 696 <p>This is a bugfix only release</p>
 697 <ul>
 698   <li>error message missing argument (William Brack)</li>
 699   <li>mode not cascaded in template fallbacks (William Brack)</li>
 700   <li>catch redefinition of parameter/variables  (William Brack)</li>
 701   <li>multiple keys with same namespace name (William Brack)</li>
 702   <li>patch for compilation using MingW on Windows (Mikhail Grushinskiy)</li>
 703   <li>header export macros for Windows (Igor Zlatkovic)</li>
 704   <li>cdata-section-elements handling of namespaced names</li>
 705   <li>compilation without libxml2 XPointer support (Mark Vadoc)</li>
 706   <li>apply-templates crash (William Brack)</li>
 707   <li>bug with imported templates (William Brack)</li>
 708   <li>imported attribute-sets merging bug (DocBook) (William Brack)</li>
 709 </ul>
 710
 711 <h3>1.0.32: Aug 9 2003</h3>
 712 <ul>
 713   <li>bugfixes: xsltSaveResultToFile() python binding (Chris Jaeger), EXSLT
 714     function (William Brack), RVT for globals (William Brack), EXSLT date
 715     (William Brack),
 716     <p>speed of large text output, xsl:copy with attributes, strip-space and
 717     namespaces prefix, fix for --path xsltproc option, EXST:tokenize (Shaun
 718     McCance), EXSLT:seconds (William Brack), sort with multiple keys (William
 719     Brack), checking of { and } for attribute value templates (William
 720     Brack)</p>
 721   </li>
 722   <li>Python bindings for extension elements (Sean Treadway)</li>
 723   <li>EXSLT:split added (Shaun McCance)</li>
 724   <li>portability fixes for HP-UX/Solaris/IRIX (William Brack)</li>
 725   <li>doc cleanup</li>
 726 </ul>
 727
 728 <h3>1.0.31: Jul 6 2003</h3>
 729 <ul>
 730   <li>bugfixes: xsl:copy on namespace nodes, AVT for xsl:sort order, fix for
 731     the debugger (Keith Isdale), output filename limitation, trio.h and
 732     triodef.h added (Albert Chin), EXSLT node-set (Peter Breitenlohner),
 733     xsltChoose and whitespace (Igor Zlatkovic),
 734     <p>stylesheet compilation (Igor Zlatkovic), NaN and sort (William Brack),
 735     RVT bug introduced in 1.0.30</p>
 736   </li>
 737   <li>avoid generating &amp;quot; (fix in libxml2-2.5.8)</li>
 738   <li>fix 64bit cleaness problem and compilation troubles introduced in
 739   1.0.30</li>
 740   <li>Windows makefile generation (Igor Zlatkovic)</li>
 741   <li>HP-UX portability fix</li>
 742 </ul>
 743
 744 <h3>1.0.30: May 4 2003</h3>
 745 <ul>
 746   <li>Fixes and new APIs to handle Result Value Trees and avoid leaks</li>
 747   <li>Fixes for: EXSLT math pow() function (Charles Bozeman), global
 748     parameter and global variables mismatch, a segfault on pattern
 749     compilation errors, namespace copy in xsl:copy-of, python generator
 750     problem, OpenVMS trio update, premature call to xsltFreeStackElem (Igor),
 751     current node when templates applies to attributes</li>
 752 </ul>
 753
 754 <h3>1.0.29: Apr 1 2003</h3>
 755 <ul>
 756   <li>performance improvements especially for large flat documents</li>
 757   <li>bug fixes: Result Value Tree handling, XML IDs, keys(), extra namespace
 758     declarations with xsl:elements.</li>
 759   <li>portability: python and trio fixes (Albert Chin), python on Solaris
 760     (Ben Phillips)</li>
 761 </ul>
 762
 763 <h3>1.0.28: Mar 24 2003</h3>
 764 <ul>
 765   <li>fixed node() in patterns semantic.</li>
 766   <li>fixed a memory access problem in format-number()</li>
 767   <li>fixed stack overflow in recursive global variable or params</li>
 768   <li>cleaned up Result Value Tree handling, and fixed a couple of old bugs
 769     in the process</li>
 770 </ul>
 771
 772 <h3>1.0.27: Feb 24 2003</h3>
 773 <ul>
 774   <li>bug fixes: spurious xmlns:nsX="" generation, serialization bug (in
 775     libxml2), a namespace copy problem, errors in the RPM spec prereqs</li>
 776   <li>Windows path canonicalization and document cache fix (Igor)</li>
 777 </ul>
 778
 779 <h3>1.0.26: Feb 10 2003</h3>
 780 <ul>
 781   <li>Fixed 3 serious bugs in document() and stylesheet compilation which
 782     could lead to a crash</li>
 783 </ul>
 784
 785 <h3>1.0.25: Feb 5 2003</h3>
 786 <ul>
 787   <li>Bug fix: double-free for standalone stylesheets introduced in 1.0.24, C
 788     syntax pbm, 3 bugs reported by Eric van der Vlist</li>
 789   <li>Some XPath and XInclude related problems were actually fixed in
 790     libxml2-2.5.2</li>
 791   <li>Documentation: emphasize taht --docbook is not for XML docs.</li>
 792 </ul>
 793
 794 <h3>1.0.24: Jan 14 2003</h3>
 795 <ul>
 796   <li>bug fixes: imported global varables, python bindings (Stéphane Bidoul),
 797     EXSLT memory leak (Charles Bozeman), namespace generation on
 798     xsl:attribute, space handling with imports (Daniel Stodden),
 799     extension-element-prefixes (Josh Parsons), comments within xsl:text (Matt
 800     Sergeant), superfluous xmlns generation, XInclude related bug for
 801     numbering, EXSLT strings (Alexey Efimov), attribute-sets computation on
 802     imports, extension module init and shutdown callbacks not called</li>
 803   <li>HP-UX portability (Alexey Efimov), Windows makefiles (Igor and Stephane
 804     Bidoul), VMS makefile updates (Craig A. Berry)</li>
 805   <li>adds xsltGetProfileInformation() (Michael Rothwell)</li>
 806   <li>fix the API generation scripts</li>
 807   <li>API to provide the sorting routines (Richard Jinks)</li>
 808   <li>added XML description of the EXSLT API</li>
 809   <li>added ESXLT URI (un)escaping (Jörg Walter)</li>
 810   <li>Some memory leaks have been found and fixed</li>
 811   <li>document() now support fragment identifiers in URIs</li>
 812 </ul>
 813
 814 <h3>1.0.23: Nov 17 2002</h3>
 815 <ul>
 816   <li>Windows build cleanup (Igor)</li>
 817   <li>Unix build and RPM packaging cleanup</li>
 818   <li>Improvement of the python bindings: extension functions and activating
 819     EXSLT</li>
 820   <li>various bug fixes: number formatting, portability for bounded string
 821     functions, CData nodes, key(), @*[...] patterns</li>
 822   <li>Documentation improvements (John Fleck)</li>
 823   <li>added libxslt.m4 (Thomas Schraitle)</li>
 824 </ul>
 825
 826 <h3>1.0.22: Oct 18 2002</h3>
 827 <ul>
 828   <li>Updates on the Windows Makefiles</li>
 829   <li>Added a security module, and a related set of new options to
 830   xsltproc</li>
 831   <li>Allowed per transformation error handler.</li>
 832   <li>Fixed a few bugs: node() semantic, URI escaping, media-type, attribute
 833     lists</li>
 834 </ul>
 835
 836 <h3>1.0.21: Sep 26 2002</h3>
 837 <ul>
 838   <li>Bug fixes: match="node()", date:difference() (Igor and Charlie
 839     Bozeman), disable-output-escaping</li>
 840   <li>Python bindings: style.saveResultToString() from Ralf Mattes</li>
 841   <li>Logos from Marc Liyanage</li>
 842   <li>Mem leak fix from Nathan Myers</li>
 843   <li>Makefile: DESTDIR fix from Christophe Merlet, AMD x86_64 (Mandrake),
 844     Windows (Igor), Python detection</li>
 845   <li>Documentation improvements: John Fleck</li>
 846 </ul>
 847
 848 <h3>1.0.20: Aug 23 2002</h3>
 849 <ul>
 850   <li>Windows makefile updates (Igor) and x86-64 (Frederic Crozat)</li>
 851   <li>fixed HTML meta tag saving for Mac/IE users</li>
 852   <li>possible leak patches from Nathan Myers</li>
 853   <li>try to handle document('') as best as possible depending in the
 854   cases</li>
 855   <li>Fixed the DocBook stylesheets handling problem</li>
 856   <li>Fixed a few XSLT reported errors</li>
 857 </ul>
 858
 859 <h3>1.0.19:  July 6 2002</h3>
 860 <ul>
 861   <li>EXSLT: dynamic functions and date support bug fixes (Mark Vakoc)</li>
 862   <li>xsl:number fix: Richard Jinks</li>
 863   <li>xsl:format-numbers fix: Ken Neighbors</li>
 864   <li>document('') fix: bug pointed by Eric van der Vlist</li>
 865   <li>xsl:message with terminate="yes" fixes: William Brack</li>
 866   <li>xsl:sort order support added: Ken Neighbors</li>
 867   <li>a few other bug fixes, some of them requiring the latest version of
 868     libxml2</li>
 869 </ul>
 870
 871 <h3>1.0.18: May 27 2002</h3>
 872 <ul>
 873   <li>a number of bug fixes: attributes, extra namespace declarations
 874     (DocBook), xsl:include crash (Igor), documentation (Christian Cornelssen,
 875     Charles Bozeman and Geert Kloosterman),  element-available (Richard
 876   Jinks)</li>
 877   <li>xsltproc can now list teh registered extensions thanks to Mark
 878   Vakoc</li>
 879   <li>there is a new API to save directly to a string
 880     xsltSaveResultToString() by Morus Walter</li>
 881   <li>specific error registration function for the python API</li>
 882 </ul>
 883
 884 <h3>1.0.17: April 29 2002</h3>
 885 <ul>
 886   <li>cleanup in code, XSLT debugger support and Makefiles for Windows by
 887   Igor</li>
 888   <li>a C++ portability fix by Mark Vakoc</li>
 889   <li>EXSLT date improvement and regression tests by Charles Bozeman</li>
 890   <li>attempt to fix a bug in xsltProcessUserParamInternal</li>
 891 </ul>
 892
 893 <h3>1.0.16: April 15 2002</h3>
 894 <ul>
 895   <li>Bug fixes: strip-space, URL in HTML output, error when xsltproc can't
 896     save</li>
 897   <li>portability fixes: OSF/1, IEEE on alphas, Windows, Python bindings</li>
 898 </ul>
 899
 900 <h3>1.0.15: Mar 25 2002</h3>
 901 <ul>
 902   <li>Bugfixes: XPath, python Makefile, recursive attribute sets, @foo[..]
 903     templates</li>
 904   <li>Debug of memory alocation with valgind</li>
 905   <li>serious profiling leading to significant improvement for DocBook
 906     processing</li>
 907   <li>revamp of the Windows build</li>
 908 </ul>
 909
 910 <h3>1.0.14: Mar 18 2002</h3>
 911 <ul>
 912   <li>Improvement in the XPath engine (libxml2-2.4.18)</li>
 913   <li>Nasty bug fix related to exslt:node-set</li>
 914   <li>Fixed the python Makefiles, cleanup of doc comments, Windows
 915     portability fixes</li>
 916 </ul>
 917
 918 <h3>1.0.13: Mar 8 2002</h3>
 919 <ul>
 920   <li>a number of bug fixes including "namespace node have no parents"</li>
 921   <li>Improvement of the Python bindings</li>
 922   <li>Charles Bozeman provided fixes and regression tests for exslt date
 923     functions.</li>
 924 </ul>
 925
 926 <h3>1.0.12: Feb 11 2002</h3>
 927 <ul>
 928   <li>Fixed the makefiles especially the python module ones</li>
 929   <li>half a dozen bugs fixes including 2 old ones</li>
 930 </ul>
 931
 932 <h3>1.0.11: Feb 8 2002</h3>
 933 <ul>
 934   <li>Change of Licence to the <a
 935     href="http://www.opensource.org/licenses/mit-license.html">MIT
 936   Licence</a></li>
 937   <li>Added a beta version of the Python bindings, including support to
 938     extend the engine with functions written in Python</li>
 939   <li>A number of bug fixes</li>
 940   <li>Charlie Bozeman provided more EXSLT functions</li>
 941   <li>Portability fixes</li>
 942 </ul>
 943
 944 <h3>1.0.10: Jan 14 2002</h3>
 945 <ul>
 946   <li>Windows fixes for Win32 from Igor</li>
 947   <li>Fixed the Solaris compilation trouble (Albert)</li>
 948   <li>Documentation changes and updates: John Fleck</li>
 949   <li>Added a stringparam option to avoid escaping hell at the shell
 950   level</li>
 951   <li>A few bug fixes</li>
 952 </ul>
 953
 954 <h3>1.0.9: Dec 7 2001</h3>
 955 <ul>
 956   <li>Makefile patches from Peter Williams</li>
 957   <li>attempt to fix the compilation problem associated to prelinking</li>
 958   <li>obsoleted libxsltbreakpoint now deprecated and frozen to 1.0.8 API</li>
 959   <li>xsltproc return codes are now significant, John Fleck updated the
 960     documentation</li>
 961   <li>patch to allow as much as 40 steps in patterns (Marc Tardif), should be
 962     made dynamic really</li>
 963   <li>fixed a bug raised by Nik Clayton when using doctypes with HTML
 964   output</li>
 965   <li>patches from Keith Isdale to interface with xsltdebugger</li>
 966 </ul>
 967
 968 <h3>1.0.8: Nov 26 2001</h3>
 969 <ul>
 970   <li>fixed an annoying header problem, removed a few bugs and some code
 971     cleanup</li>
 972   <li>patches for Windows and update of Windows Makefiles by Igor</li>
 973   <li>OpenVMS port instructions from John A Fotheringham</li>
 974   <li>fixed some Makefiles annoyance and libraries prelinking
 975   information</li>
 976 </ul>
 977
 978 <h3>1.0.7: Nov 10 2001</h3>
 979 <ul>
 980   <li>remove a compilation problem with LIBXSLT_PUBLIC</li>
 981   <li>Finishing the integration steps for Keith Isdale debugger</li>
 982   <li>fixes the handling of indent="no" on HTML output</li>
 983   <li>fixes on the configure script and RPM spec file</li>
 984 </ul>
 985
 986 <h3>1.0.6: Oct 30 2001</h3>
 987 <ul>
 988   <li>bug fixes on number formatting (Thomas), date/time functions (Bruce
 989     Miller)</li>
 990   <li>update of the Windows Makefiles (Igor)</li>
 991   <li>fixed DOCTYPE generation rules for HTML output (me)</li>
 992 </ul>
 993
 994 <h3>1.0.5: Oct 10 2001</h3>
 995 <ul>
 996   <li>some portability fixes, including Windows makefile updates from
 997   Igor</li>
 998   <li>fixed a dozen bugs on XSLT and EXSLT (me and Thomas Broyer)</li>
 999   <li>support for Saxon's evaluate and expressions extensions added (initial
1000     contribution from Darren Graves)</li>
1001   <li>better handling of XPath evaluation errors</li>
1002 </ul>
1003
1004 <h3>1.0.4: Sep 12 2001</h3>
1005 <ul>
1006   <li>Documentation updates from John fleck</li>
1007   <li>bug fixes (DocBook  FO generation should be fixed)  and portability
1008     improvements</li>
1009   <li>Thomas Broyer improved the existing EXSLT support and added String,
1010     Time and Date core functions support</li>
1011 </ul>
1012
1013 <h3>1.0.3:  Aug 23 2001</h3>
1014 <ul>
1015   <li>XML Catalog support see the doc</li>
1016   <li>New NaN/Infinity floating point code</li>
1017   <li>A few bug fixes</li>
1018 </ul>
1019
1020 <h3>1.0.2:  Aug 15 2001</h3>
1021 <ul>
1022   <li>lot of bug fixes, increased the testsuite</li>
1023   <li>a large chunk of EXSLT is implemented</li>
1024   <li>improvements on the extension framework</li>
1025   <li>documentation improvements</li>
1026   <li>Windows MSC projects files should be up-to-date</li>
1027   <li>handle attributes inherited from the DTD by default</li>
1028 </ul>
1029
1030 <h3>1.0.1:  July 24 2001</h3>
1031 <ul>
1032   <li>initial EXSLT framework</li>
1033   <li>better error reporting</li>
1034   <li>fixed the profiler on Windows</li>
1035   <li>bug fixes</li>
1036 </ul>
1037
1038 <h3>1.0.0: July 10 2001</h3>
1039 <ul>
1040   <li>a lot of cleanup, a lot of regression tests added or fixed</li>
1041   <li>added a documentation for <a href="extensions.html">writing
1042     extensions</a></li>
1043   <li>fixed some variable evaluation problems (with William)</li>
1044   <li>added profiling of stylesheet execution accessible as the xsltproc
1045     --profile option</li>
1046   <li>fixed element-available() and the implementation of the various
1047     chunking methods present, Norm Walsh provided a lot of feedback</li>
1048   <li>exclude-result-prefixes and namespaces output should now work as
1049     expected</li>
1050   <li>added support of embedded stylesheet as described in section 2.7 of the
1051     spec</li>
1052 </ul>
1053
1054 <h3>0.14.0: July 5 2001</h3>
1055 <ul>
1056   <li>lot of bug fixes, and code cleanup</li>
1057   <li>completion of the little XSLT-1.0 features left unimplemented</li>
1058   <li>Added and implemented the extension API suggested by Thomas Broyer</li>
1059   <li>the Windows MSC environment should be complete</li>
1060   <li>tested and optimized with a really large document (DocBook Definitive
1061     Guide) libxml/libxslt should really be faster on serious workloads</li>
1062 </ul>
1063
1064 <h3>0.13.0: June 26 2001</h3>
1065 <ul>
1066   <li>lots of cleanups</li>
1067   <li>fixed a C++ compilation problem</li>
1068   <li>couple of fixes to xsltSaveTo()</li>
1069   <li>try to fix Docbook-xslt-1.4 and chunking, updated the regression test
1070     with them</li>
1071   <li>fixed pattern compilation and priorities problems</li>
1072   <li>Patches for Windows and MSC project mostly contributed by Yon Derek</li>
1073   <li>update to the Tutorial by John Fleck</li>
1074   <li>William fixed bugs in templates and for-each functions</li>
1075   <li>added a new interface xsltRunStylesheet() for a more flexible output
1076     (incomplete), added -o option to xsltproc</li>
1077 </ul>
1078
1079 <h3>0.12.0: June 18 2001</h3>
1080 <ul>
1081   <li>fixed a dozen of bugs reported</li>
1082   <li>HTML generation should be quite better (requires libxml-2.3.11 upgrade
1083     too)</li>
1084   <li>William fixed some problems with document()</li>
1085   <li>Fix namespace nodes selection and copy (requires libxml-2.3.11 upgrade
1086     too)</li>
1087   <li>John Fleck added a<a href="tutorial/libxslttutorial.html">
1088   tutorial</a></li>
1089   <li>Fixes for namespace handling when evaluating variables</li>
1090   <li>XInclude global flag added to process XInclude on document() if
1091     requested</li>
1092   <li>made xsltproc --version more detailed</li>
1093 </ul>
1094
1095 <h3>0.11.0: June 1 2001</h3>
1096
1097 <p>Mostly a bug fix release.</p>
1098 <ul>
1099   <li>integration of catalogs from xsltproc</li>
1100   <li>added --version to xsltproc for bug reporting</li>
1101   <li>fixed errors when handling ID in external parsed entities</li>
1102   <li>document() should hopefully work correctly but ...</li>
1103   <li>fixed bug with PI and comments processing</li>
1104   <li>William fixed the XPath string functions when using unicode</li>
1105 </ul>
1106
1107 <h3>0.10.0: May 19 2001</h3>
1108 <ul>
1109   <li>cleanups to make stylesheet read-only (not 100% complete)</li>
1110   <li>fixed URI resolution in document()</li>
1111   <li>force all XPath expression to be compiled at stylesheet parsing time,
1112     even if unused ...</li>
1113   <li>Fixed HTML default output detection</li>
1114   <li>Fixed double attribute generation #54446</li>
1115   <li>Fixed {{ handling in attributes #54451</li>
1116   <li>More tests and speedups for DocBook document transformations</li>
1117   <li>Fixed a really bad race like bug in xsltCopyTreeList()</li>
1118   <li>added a documentation on the libxslt internals</li>
1119   <li>William Brack and Bjorn Reese improved format-number()</li>
1120   <li>Fixed multiple sort, it should really work now</li>
1121   <li>added a --docbook option for SGML DocBook input (hackish)</li>
1122   <li>a number of other bug fixes and regression test added as people were
1123     submitting them</li>
1124 </ul>
1125
1126 <h3>0.9.0: May 3 2001</h3>
1127 <ul>
1128   <li>lot of various bugfixes, extended the regression suite</li>
1129   <li>xsltproc should work with multiple params</li>
1130   <li>added an option to use xsltproc with HTML input</li>
1131   <li>improved the stylesheet compilation, processing of complex stylesheets
1132     should be faster</li>
1133   <li>using the same stylesheet for concurrent processing on multithreaded
1134     programs should work now</li>
1135   <li>fixed another batch of namespace handling problems</li>
1136   <li>Implemented multiple level of sorting</li>
1137 </ul>
1138
1139 <h3>0.8.0: Apr 22 2001</h3>
1140 <ul>
1141   <li>fixed ansidecl.h problem</li>
1142   <li>fixed unparsed-entity-uri() and generate-id()</li>
1143   <li>sort semantic fixes and priority prob from William M. Brack</li>
1144   <li>fixed namespace handling problems in XPath expression computations
1145     (requires libxml-2.3.7)</li>
1146   <li>fixes to current() and key()</li>
1147   <li>other, smaller fixes, lots of testing with N Walsh DocBook HTML
1148     stylesheets</li>
1149 </ul>
1150
1151 <h3>0.7.0: Apr 10 2001</h3>
1152 <ul>
1153   <li>cleanup using stricter compiler flags</li>
1154   <li>command line parameter passing</li>
1155   <li>fix to xsltApplyTemplates from William M. Brack</li>
1156   <li>added the XSLTMark in the regression tests as well as document()</li>
1157 </ul>
1158
1159 <h3>0.6.0: Mar 22 2001</h3>
1160 <ul>
1161   <li>another beta</li>
1162   <li>requires 2.3.5, which provide XPath expression compilation support</li>
1163   <li>document() extension should function properly</li>
1164   <li>fixed a number or reported bugs</li>
1165 </ul>
1166
1167 <h3>0.5.0: Mar 10 2001</h3>
1168 <ul>
1169   <li>fifth beta</li>
1170   <li>some optimization work, for the moment 2 XSLT transform cannot use the
1171     same stylesheet at the same time (to be fixed)</li>
1172   <li>fixed problems with handling of tree results</li>
1173   <li>fixed a reported strip-spaces problem</li>
1174   <li>added more reported/fixed bugs to the test suite</li>
1175   <li>incorporated William M. Brack fix for imports and global variables as
1176     well as patch for with-param support in apply-templates</li>
1177   <li>a bug fix on for-each</li>
1178 </ul>
1179
1180 <h3>0.4.0: Mar 1 2001</h3>
1181 <ul>
1182   <li>fourth beta test, released at the same time of libxml2-2.3.3</li>
1183   <li>bug fixes</li>
1184   <li>some optimization</li>
1185   <li>started implement extension support, not finished</li>
1186   <li>implemented but not tested multiple file output</li>
1187 </ul>
1188
1189 <h3>0.3.0: Feb 24 2001</h3>
1190 <ul>
1191   <li>third beta test, released at the same time of libxml2-2.3.2</li>
1192   <li>lot of bug fixes</li>
1193   <li>some optimization</li>
1194   <li>added DocBook XSL based testsuite</li>
1195 </ul>
1196
1197 <h3>0.2.0: Feb 15 2001</h3>
1198 <ul>
1199   <li>second beta version, released at the same time as libxml2-2.3.1</li>
1200   <li>getting close to feature completion, lot of bug fixes, some in the HTML
1201     and XPath support of libxml</li>
1202   <li>start becoming usable for real work. This version can now regenerate
1203     the XML 2e HTML from the original XML sources and the associated
1204     stylesheets (in <a
1205     href="http://www.w3.org/TR/REC-xml#b4d250b6c21">section I of the XML
1206     REC</a>)</li>
1207   <li>Still misses extension element/function/prefixes support. Support of
1208     key() and document() is not complete</li>
1209 </ul>
1210
1211 <h3>0.1.0: Feb 8 2001</h3>
1212 <ul>
1213   <li>first beta version, released at the same time as libxml2-2.3.0</li>
1214   <li>lots of bug fixes, first "testing" version, but incomplete</li>
1215 </ul>
1216
1217 <h3>0.0.1: Jan 25 2001</h3>
1218 <ul>
1219   <li>first alpha version released at the same time as libxml2-2.2.12</li>
1220   <li>Framework in place, should work on simple examples, but far from being
1221     feature complete</li>
1222 </ul>
1223
1224 <h2><a name="xsltproc">The xsltproc tool</a></h2>
1225
1226 <p>This program is the simplest way to use libxslt: from the command line. It
1227 is also used for doing the regression tests of the library.</p>
1228
1229 <p>It takes as first argument the path or URL to an XSLT stylesheet, the next
1230 arguments are filenames or URIs of the inputs to be processed. The output of
1231 the processing is redirected on the standard output. There is actually a few
1232 more options available:</p>
1233 <pre>orchis:~ -&gt; xsltproc
1234 Usage: xsltproc [options] stylesheet file [file ...]
1235    Options:
1236       --version or -V: show the version of libxml and libxslt used
1237       --verbose or -v: show logs of what's happening
1238       --output file or -o file: save to a given file
1239       --timing: display the time used
1240       --repeat: run the transformation 20 times
1241       --debug: dump the tree of the result instead
1242       --novalid: skip the Dtd loading phase
1243       --noout: do not dump the result
1244       --maxdepth val : increase the maximum depth
1245       --html: the input document is(are) an HTML file(s)
1246       --docbook: the input document is SGML docbook
1247       --param name value : pass a (parameter,value) pair
1248       --nonet refuse to fetch DTDs or entities over network
1249       --warnnet warn against fetching over the network
1250       --catalogs : use the catalogs from $SGML_CATALOG_FILES
1251       --xinclude : do XInclude processing on document input
1252       --profile or --norman : dump profiling information
1253 orchis:~ -&gt;</pre>
1254
1255 <h2><a name="DocBook">DocBook</a></h2>
1256
1257 <p><img src="duck.png" align="right" alt="The duck picture"></p>
1258
1259 <p><a href="http://www.oasis-open.org/committees/docbook/">DocBook</a> is an
1260 XML/SGML vocabulary particularly well suited to books and papers about
1261 computer hardware and software.</p>
1262
1263 <p>xsltproc and libxslt are not specifically dependant on DocBook, but since
1264 a lot of people use xsltproc and libxml2 for DocBook formatting, here are a
1265 few pointers and information which may be helpful:</p>
1266 <ul>
1267   <li>The <a href="http://www.oasis-open.org/committees/docbook/">DocBook
1268     homepage at Oasis</a> you should find pointers there on all the lastest
1269     versions of the DTDs and XSLT stylesheets</li>
1270   <li><a href="http://www.docbook.org/">DocBook: The Definitive Guide</a> is
1271     the official reference documentation for DocBook.</li>
1272   <li><a
1273     href="https://sourceforge.net/docman/index.php?group_id=21935">DocBook
1274     Open Repository</a> contains a lot of information about DocBook</li>
1275   <li>Bob Stayton provides a <a href="http://www.sagehill.net/">lot of
1276     resources</a> and consulting services around DocBook.</li>
1277   <li>Here is a <a href="/buildDocBookCatalog">shell script</a> to generate
1278     XML Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/
1279     directory, it will set-up /etc/xml/catalog and /etc/xml/docbook based on
1280     the resources found on the system. Otherwise it will just create
1281     ~/xmlcatalog and ~/dbkxmlcatalog and doing:
1282     <p><code>export XMLCATALOG=$HOME/xmlcatalog</code></p>
1283     <p>should allow to process DocBook documentations without requiring
1284     network accesses for the DTd or stylesheets</p>
1285   </li>
1286   <li>I have uploaded <a href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">a
1287     small tarball</a> containing XML Catalogs for DocBook 4.1.2 which seems
1288     to work fine for me too</li>
1289   <li>Informations on installing a <a
1290     href="http://wiki.docbook.org/topic/CygwinPackages">Windows
1291     DocBook processing setup</a> based on Cygwin (using the binaries from the
1292     official Windows port should be possible too)</li>
1293   <li>Alexander Kirillov's page on <a
1294     href="http://www.math.sunysb.edu/~kirillov/dbxml/">Using DocBook XML
1295     4.1.2</a> (RPM packages)</li>
1296   <li>Tim Waugh's <a href="http://cyberelk.net/tim/xmlto/">xmlto front-end
1297     conversion script</a></li>
1298   <li>Linux Documentation Project <a
1299     href="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/">
1300     DocBook-Install-mini-HOWTO</a></li>
1301   <li>ScrollKeeper the open documentation cataloging project has a <a
1302     href="http://scrollkeeper.sourceforge.net/docbook.shtml">DocBook
1303     section</a></li>
1304   <li>Dan York presentation on <a
1305     href="http://www.lodestar2.com/people/dyork/talks/2001/xugo/docbook/index.html">Publishing
1306     using DocBook XML</a></li>
1307 </ul>
1308
1309 <p>Do not use the --docbook option of xsltproc to process XML DocBook
1310 documents, this option is only intended to provide some (limited) support of
1311 the SGML version of DocBook.</p>
1312
1313 <p>Points which are not DocBook specific but still worth mentionning
1314 again:</p>
1315 <ul>
1316   <li>if you think DocBook processing time is too slow, make sure you have
1317     XML Catalogs pointing to a local installation of the DTD of DocBook.
1318     Check the <a href="http://xmlsoft.org/catalog.html">XML Catalog page</a>
1319     to understand more on this subject.</li>
1320   <li>before processing a new document, use the command
1321     <p><code>xmllint --valid --noout path_to_document</code></p>
1322     <p>to make sure that your input is valid DocBook. And fixes the errors
1323     before processing further. Note that XSLT processing may work correctly
1324     with some forms of validity errors left, but in general it can give
1325     troubles on output.</p>
1326   </li>
1327 </ul>
1328
1329 <h2><a name="API">The programming API</a></h2>
1330
1331 <p>Okay this section is clearly incomplete. But integrating libxslt into your
1332 application should be relatively easy. First check the few steps described
1333 below, then for more detailed information, look at the<a
1334 href="html/libxslt-lib.html"> generated pages</a> for the API and the source
1335 of libxslt/xsltproc.c  and the  <a
1336 href="tutorial/libxslttutorial.html">tutorial</a>.</p>
1337
1338 <p>Basically doing an XSLT transformation can be done in a few steps:</p>
1339 <ol>
1340   <li>configure the parser for XSLT:
1341     <p>xmlSubstituteEntitiesDefault(1);</p>
1342     <p>xmlLoadExtDtdDefaultValue = 1;</p>
1343   </li>
1344   <li>parse the stylesheet with xsltParseStylesheetFile()</li>
1345   <li>parse the document with xmlParseFile()</li>
1346   <li>apply the stylesheet using xsltApplyStylesheet()</li>
1347   <li>save the result using xsltSaveResultToFile() if needed set
1348     xmlIndentTreeOutput to 1</li>
1349 </ol>
1350
1351 <p>Steps 2,3, and 5 will probably need to be changed depending on you
1352 processing needs and environment for example if reading/saving from/to
1353 memory, or if you want to apply XInclude processing to the stylesheet or
1354 input documents.</p>
1355
1356 <h2><a name="Python">Python and bindings</a></h2>
1357
1358 <p>There is a number of language bindings and wrappers available for libxml2,
1359 the list below is not exhaustive. Please contact the <a
1360 href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>
1361 (<a href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) in
1362 order to get updates to this list or to discuss the specific topic of libxml2
1363 or libxslt wrappers or bindings:</p>
1364 <ul>
1365   <li><a
1366     href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
1367     Sergeant</a> developped <a href="http://axkit.org/download/">XML::LibXML
1368     and XML::LibXSLT</a>, Perl wrappers for libxml2/libxslt as part of the <a
1369     href="http://axkit.com/">AxKit XML application server</a></li>
1370   <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provides and
1371     earlier version of the libxml/libxslt <a
1372     href="http://www.rexx.com/~dkuhlman">wrappers for Python</a></li>
1373   <li>Petr Kozelka provides <a
1374     href="http://sourceforge.net/projects/libxml2-pas">Pascal units to glue
1375     libxml2</a> with Kylix, Delphi and other Pascal compilers</li>
1376   <li>Wai-Sun "Squidster" Chia provides <a
1377     href="http://www.rubycolor.org/arc/redist/">bindings for Ruby</a>  and
1378     libxml2 bindings are also available in Ruby through the <a
1379     href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a> module
1380     maintained by Tobias Peters.</li>
1381   <li>Steve Ball and contributors maintains <a
1382     href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings for
1383     Tcl</a></li>
1384   <li><a href="mailto:xmlwrapp@pmade.org">Peter Jones</a> maintains C++
1385     bindings for libxslt within <a
1386     href="http://pmade.org/pjones/software/xmlwrapp/">xmlwrapp</a></li>
1387   <li><a href="phillim2@comcast.net">Mike Phillips</a> provides a module
1388     using <a href="http://siasl.dyndns.org/projects/projects.html">libxslt
1389     for PHP</a>.</li>
1390   <li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a> is
1391     an effort to create a 100% JAXP-compatible Java wrapper for libxml2 and
1392     libxslt as part of GNU ClasspathX project.</li>
1393   <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look for
1394     <a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li>
1395   <li><a
1396     href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>
1397     provides <a
1398     href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLib
1399     osax</a>. This is an osax for Mac OS X with a set of commands to
1400     implement in AppleScript the XML DOM, XPATH and XSLT.</li>
1401 </ul>
1402
1403 <p>The libxslt Python module depends on the <a
1404 href="http://xmlsoft.org/python.html">libxml2 Python</a> module.</p>
1405
1406 <p>The distribution includes a set of Python bindings, which are guaranteed to
1407 be maintained as part of the library in the future, though the Python
1408 interface have not yet reached the completeness of the C API.</p>
1409
1410 <p><a href="mailto:stephane.bidoul@softwareag.com">Stéphane Bidoul</a>
1411 maintains <a href="http://users.skynet.be/sbi/libxml-python/">a Windows port
1412 of the Python bindings</a>.</p>
1413
1414 <p>Note to people interested in building bindings, the API is formalized as
1415 <a href="libxslt-api.xml">an XML API description file</a> which allows to
1416 automate a large part of the Python bindings, this includes function
1417 descriptions, enums, structures, typedefs, etc... The Python script used to
1418 build the bindings is python/generator.py in the source distribution.</p>
1419
1420 <p>To install the Python bindings there are 2 options:</p>
1421 <ul>
1422   <li>If you use an RPM based distribution, simply install the <a
1423     href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-python
1424     RPM</a> and the <a
1425     href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-python
1426     RPM</a>.</li>
1427   <li>Otherwise use the <a href="ftp://xmlsoft.org/libxml2/python/">libxml2-python
1428     module distribution</a> corresponding to your installed version of
1429     libxml2 and libxslt. Note that to install it you will need both libxml2
1430     and libxslt installed and run "python setup.py build install" in the
1431     module tree.</li>
1432 </ul>
1433
1434 <p>The distribution includes a set of examples and regression tests for the
1435 python bindings in the <code>python/tests</code> directory. Here are some
1436 excepts from those tests:</p>
1437
1438 <h3>basic.py:</h3>
1439
1440 <p>This is a basic test of XSLT interfaces: loading a stylesheet and a
1441 document, transforming the document and saving the result.</p>
1442 <pre>import libxml2
1443 import libxslt
1444
1445 styledoc = libxml2.parseFile("test.xsl")
1446 style = libxslt.parseStylesheetDoc(styledoc)
1447 doc = libxml2.parseFile("test.xml")
1448 result = style.applyStylesheet(doc, None)
1449 style.saveResultToFilename("foo", result, 0)
1450 style.freeStylesheet()
1451 doc.freeDoc()
1452 result.freeDoc()</pre>
1453
1454 <p>The Python module is called libxslt, you will also need the libxml2 module
1455 for the operations on XML trees. Let's have a look at the objects manipulated
1456 in that example and how is the processing done:</p>
1457 <ul>
1458   <li><code>styledoc</code> : is a libxml2 document tree. It is obtained by
1459     parsing the XML file "test.xsl" containing the stylesheet.</li>
1460   <li><code>style</code> : this is a precompiled stylesheet ready to be used
1461     by the following transformations (note the plural form, multiple
1462     transformations can resuse the same stylesheet).</li>
1463   <li><code>doc</code> : this is the document to apply the transformation to.
1464     In this case it is simply generated by parsing it from a file but any
1465     other processing is possible as long as one get a libxml2 Doc. Note that
1466     HTML tree are suitable for XSLT processing in libxslt. This is actually
1467     how this page is generated !</li>
1468   <li><code>result</code> : this is a document generated by applying the
1469     stylesheet to the document. Note that some of the stylesheet information
1470     may be related to the serialization of that document and as in this
1471     example a specific saveResultToFilename() method of the stylesheet should
1472     be used to save it to a file (in that case to "foo").</li>
1473 </ul>
1474
1475 <p>Also note the need to explicitely deallocate documents with freeDoc()
1476 except for the stylesheet document which is freed when its compiled form is
1477 garbage collected.</p>
1478
1479 <h3>extfunc.py:</h3>
1480
1481 <p>This one is a far more complex test. It shows how to modify the behaviour
1482 of an XSLT transformation by passing parameters and how to extend the XSLT
1483 engine with functions defined in python:</p>
1484 <pre>import libxml2
1485 import libxslt
1486 import string
1487
1488 nodeName = None
1489 def f(ctx, str):
1490     global nodeName
1491
1492     #
1493     # Small check to verify the context is correcly accessed
1494     #
1495     try:
1496         pctxt = libxslt.xpathParserContext(_obj=ctx)
1497         ctxt = pctxt.context()
1498         tctxt = ctxt.transformContext()
1499         nodeName = tctxt.insertNode().name
1500     except:
1501         pass
1502
1503     return string.upper(str)
1504
1505 libxslt.registerExtModuleFunction("foo", "http://example.com/foo", f)</pre>
1506
1507 <p>This code defines and register an extension function. Note that the
1508 function can be bound to any name (foo) and how the binding is also
1509 associated to a namespace name "http://example.com/foo". From an XSLT point
1510 of view the function just returns an upper case version of the string passed
1511 as a parameter. But the first part of the function also read some contextual
1512 information from the current XSLT processing environement, in that case it
1513 looks for the current insertion node in the resulting output (either the
1514 resulting document or the Result Value Tree being generated), and saves it to
1515 a global variable for checking that the access actually worked.</p>
1516
1517 <p>For more information on the xpathParserContext and transformContext
1518 objects check the <a href="internals.html">libray internals description</a>.
1519 The pctxt is actually an object from a class derived from the
1520 libxml2.xpathParserContext() with just a couple more properties including the
1521 possibility to look up the XSLT transformation context from the XPath
1522 context.</p>
1523 <pre>styledoc = libxml2.parseDoc("""
1524 &lt;xsl:stylesheet version='1.0'
1525   xmlns:xsl='http://www.w3.org/1999/XSL/Transform'
1526   xmlns:foo='http://example.com/foo'
1527   xsl:exclude-result-prefixes='foo'&gt;
1528
1529   &lt;xsl:param name='bar'&gt;failure&lt;/xsl:param&gt;
1530   &lt;xsl:template match='/'&gt;
1531     &lt;article&gt;&lt;xsl:value-of select='foo:foo($bar)'/&gt;&lt;/article&gt;
1532   &lt;/xsl:template&gt;
1533 &lt;/xsl:stylesheet&gt;
1534 """)</pre>
1535
1536 <p>Here is a simple example of how to read an XML document from a python
1537 string with libxml2. Note how this stylesheet:</p>
1538 <ul>
1539   <li>Uses a global parameter <code>bar</code></li>
1540   <li>Reference the extension function f</li>
1541   <li>how the Namespace name "http://example.com/foo" has to be bound to a
1542     prefix</li>
1543   <li>how that prefix is excluded from the output</li>
1544   <li>how the function is called from the select</li>
1545 </ul>
1546 <pre>style = libxslt.parseStylesheetDoc(styledoc)
1547 doc = libxml2.parseDoc("&lt;doc/&gt;")
1548 result = style.applyStylesheet(doc, { "bar": "'success'" })
1549 style.freeStylesheet()
1550 doc.freeDoc()</pre>
1551
1552 <p>that part is identical, to the basic example except that the
1553 transformation is passed a dictionary of parameters. Note that the string
1554 passed "success" had to be quoted, otherwise it is interpreted as an XPath
1555 query for the childs of root named "success".</p>
1556 <pre>root = result.children
1557 if root.name != "article":
1558     print "Unexpected root node name"
1559     sys.exit(1)
1560 if root.content != "SUCCESS":
1561     print "Unexpected root node content, extension function failed"
1562     sys.exit(1)
1563 if nodeName != 'article':
1564     print "The function callback failed to access its context"
1565     sys.exit(1)
1566
1567 result.freeDoc()</pre>
1568
1569 <p>That part just verifies that the transformation worked, that the parameter
1570 got properly passed to the engine, that the function f() got called and that
1571 it properly accessed the context to find the name of the insertion node.</p>
1572
1573 <h3>pyxsltproc.py:</h3>
1574
1575 <p>this module is a bit too long to be described there but it is basically a
1576 rewrite of the xsltproc command line interface of libxslt in Python. It
1577 provides nearly all the functionalities of xsltproc and can be used as a base
1578 module to write Python customized XSLT processors. One of the thing to notice
1579 are:</p>
1580 <pre>libxml2.lineNumbersDefault(1)
1581 libxml2.substituteEntitiesDefault(1)</pre>
1582
1583 <p>those two calls in the main() function are needed to force the libxml2
1584 processor to generate DOM trees compliant with the XPath data model.</p>
1585
1586 <h2><a name="Internals">Library internals</a></h2>
1587
1588 <h3>Table  of contents</h3>
1589 <ul>
1590   <li><a href="internals.html#Introducti">Introduction</a></li>
1591   <li><a href="internals.html#Basics">Basics</a></li>
1592   <li><a href="internals.html#Keep">Keep it simple stupid</a></li>
1593   <li><a href="internals.html#libxml">The libxml nodes</a></li>
1594   <li><a href="internals.html#XSLT">The XSLT processing steps</a></li>
1595   <li><a href="internals.html#XSLT1">The XSLT stylesheet compilation</a></li>
1596   <li><a href="internals.html#XSLT2">The XSLT template compilation</a></li>
1597   <li><a href="internals.html#processing">The processing itself</a></li>
1598   <li><a href="internals.html#XPath">XPath expressions compilation</a></li>
1599   <li><a href="internals.html#XPath1">XPath interpretation</a></li>
1600   <li><a href="internals.html#Descriptio">Description of XPath
1601   Objects</a></li>
1602   <li><a href="internals.html#XPath3">XPath functions</a></li>
1603   <li><a href="internals.html#stack">The variables stack frame</a></li>
1604   <li><a href="internals.html#Extension">Extension support</a></li>
1605   <li><a href="internals.html#Futher">Further reading</a></li>
1606   <li><a href="internals.html#TODOs">TODOs</a></li>
1607 </ul>
1608
1609 <h3><a name="Introducti2">Introduction</a></h3>
1610
1611 <p>This document describes the processing of <a
1612 href="http://xmlsoft.org/XSLT/">libxslt</a>, the <a
1613 href="http://www.w3.org/TR/xslt">XSLT</a> C library developed for the <a
1614 href="http://www.gnome.org/">GNOME</a> project.</p>
1615
1616 <p>Note: this documentation is by definition incomplete and I am not good at
1617 spelling, grammar, so patches and suggestions are <a
1618 href="mailto:veillard@redhat.com">really welcome</a>.</p>
1619
1620 <h3><a name="Basics1">Basics</a></h3>
1621
1622 <p>XSLT is a transformation language. It takes an input document and a
1623 stylesheet document and generates an output document:</p>
1624
1625 <p align="center"><img src="processing.gif"
1626 alt="the XSLT processing model"></p>
1627
1628 <p>Libxslt is written in C. It relies on <a
1629 href="http://www.xmlsoft.org/">libxml</a>, the XML C library for GNOME, for
1630 the following operations:</p>
1631 <ul>
1632   <li>parsing files</li>
1633   <li>building the in-memory DOM structure associated with the documents
1634     handled</li>
1635   <li>the XPath implementation</li>
1636   <li>serializing back the result document to XML and HTML. (Text is handled
1637     directly.)</li>
1638 </ul>
1639
1640 <h3><a name="Keep1">Keep it simple stupid</a></h3>
1641
1642 <p>Libxslt is not very specialized. It is built under the assumption that all
1643 nodes from the source and output document can fit in the virtual memory of
1644 the system. There is a big trade-off there. It is fine for reasonably sized
1645 documents but may not be suitable for large sets of data. The gain is that it
1646 can be used in a relatively versatile way. The input or output may never be
1647 serialized, but the size of documents it can handle are limited by the size
1648 of the memory available.</p>
1649
1650 <p>More specialized memory handling approaches are possible, like building
1651 the input tree from a serialization progressively as it is consumed,
1652 factoring repetitive patterns, or even on-the-fly generation of the output as
1653 the input is parsed but it is possible only for a limited subset of the
1654 stylesheets. In general the implementation of libxslt follows the following
1655 pattern:</p>
1656 <ul>
1657   <li>KISS (keep it simple stupid)</li>
1658   <li>when there is a clear bottleneck optimize on top of this simple
1659     framework and refine only as much as is needed to reach the expected
1660     result</li>
1661 </ul>
1662
1663 <p>The result is not that bad, clearly one can do a better job but more
1664 specialized too. Most optimization like building the tree on-demand would
1665 need serious changes to the libxml XPath framework. An easy step would be to
1666 serialize the output directly (or call a set of SAX-like output handler to
1667 keep this a flexible interface) and hence avoid the memory consumption of the
1668 result.</p>
1669
1670 <h3><a name="libxml">The libxml nodes</a></h3>
1671
1672 <p>DOM-like trees, as used and generated by libxml and libxslt, are
1673 relatively complex. Most node types follow the given structure except a few
1674 variations depending on the node type:</p>
1675
1676 <p align="center"><img src="node.gif" alt="description of a libxml node"></p>
1677
1678 <p>Nodes carry a <strong>name</strong> and the node <strong>type</strong>
1679 indicates the kind of node it represents, the most common ones are:</p>
1680 <ul>
1681   <li>document nodes</li>
1682   <li>element nodes</li>
1683   <li>text nodes</li>
1684 </ul>
1685
1686 <p>For the XSLT processing, entity nodes should not be generated (i.e. they
1687 should be replaced by their content). Most nodes also contains the following
1688 "navigation" information:</p>
1689 <ul>
1690   <li>the containing <strong>doc</strong>ument</li>
1691   <li>the <strong>parent</strong> node</li>
1692   <li>the first <strong>children</strong> node</li>
1693   <li>the <strong>last</strong> children node</li>
1694   <li>the <strong>prev</strong>ious sibling</li>
1695   <li>the following sibling (<strong>next</strong>)</li>
1696 </ul>
1697
1698 <p>Elements nodes carries the list of attributes in the properties, an
1699 attribute itself holds the navigation pointers and the children list (the
1700 attribute value is not represented as a simple string to allow usage of
1701 entities references).</p>
1702
1703 <p>The <strong>ns</strong> points to the namespace declaration for the
1704 namespace associated to the node, <strong>nsDef</strong> is the linked list
1705 of namespace declaration present on element nodes.</p>
1706
1707 <p>Most nodes also carry an <strong>_private</strong> pointer which can be
1708 used by the application to hold specific data on this node.</p>
1709
1710 <h3><a name="XSLT">The XSLT processing steps</a></h3>
1711
1712 <p>There are a few steps which are clearly decoupled at the interface
1713 level:</p>
1714 <ol>
1715   <li>parse the stylesheet and generate a DOM tree</li>
1716   <li>take the stylesheet tree and build a compiled version of it (the
1717     compilation phase)</li>
1718   <li>take the input and generate a DOM tree</li>
1719   <li>process the stylesheet against the input tree and generate an output
1720     tree</li>
1721   <li>serialize the output tree</li>
1722 </ol>
1723
1724 <p>A few things should be noted here:</p>
1725 <ul>
1726   <li>the steps 1/ 3/ and 5/ are optional</li>
1727   <li>the stylesheet obtained at 2/ can be reused by multiple processing 4/
1728     (and this should also work in threaded programs)</li>
1729   <li>the tree provided in 2/ should never be freed using xmlFreeDoc, but by
1730     freeing the stylesheet.</li>
1731   <li>the input tree 4/ is not modified except the _private field which may
1732     be used for labelling keys if used by the stylesheet</li>
1733 </ul>
1734
1735 <h3><a name="XSLT1">The XSLT stylesheet compilation</a></h3>
1736
1737 <p>This is the second step described. It takes a stylesheet tree, and
1738 "compiles" it. This associates to each node a structure stored in the
1739 _private field and containing information computed in the stylesheet:</p>
1740
1741 <p align="center"><img src="stylesheet.gif"
1742 alt="a compiled XSLT stylesheet"></p>
1743
1744 <p>One xsltStylesheet structure is generated per document parsed for the
1745 stylesheet. XSLT documents allow includes and imports of other documents,
1746 imports are stored in the <strong>imports</strong> list (hence keeping the
1747 tree hierarchy of includes which is very important for a proper XSLT
1748 processing model) and includes are stored in the <strong>doclist</strong>
1749 list. An imported stylesheet has a parent link to allow browsing of the
1750 tree.</p>
1751
1752 <p>The DOM tree associated to the document is stored in <strong>doc</strong>.
1753 It is preprocessed to remove ignorable empty nodes and all the nodes in the
1754 XSLT namespace are subject to precomputing. This usually consist of
1755 extracting all the context information from the context tree (attributes,
1756 namespaces, XPath expressions), and storing them in an xsltStylePreComp
1757 structure associated to the <strong>_private</strong> field of the node.</p>
1758
1759 <p>A couple of notable exceptions to this are XSLT template nodes (more on
1760 this later) and attribute value templates. If they are actually templates,
1761 the value cannot be computed at compilation time. (Some preprocessing could
1762 be done like isolation and preparsing of the XPath subexpressions but it's
1763 not done, yet.)</p>
1764
1765 <p>The xsltStylePreComp structure also allows storing of the precompiled form
1766 of an XPath expression that can be associated to an XSLT element (more on
1767 this later).</p>
1768
1769 <h3><a name="XSLT2">The XSLT template compilation</a></h3>
1770
1771 <p>A proper handling of templates lookup is one of the keys of fast XSLT
1772 processing. (Given a node in the source document this is the process of
1773 finding which templates should be applied to this node.) Libxslt follows the
1774 hint suggested in the <a href="http://www.w3.org/TR/xslt#patterns">5.2
1775 Patterns</a> section of the XSLT Recommendation, i.e. it doesn't evaluate it
1776 as an XPath expression but tokenizes it and compiles it as a set of rules to
1777 be evaluated on a candidate node. There usually is an indication of the node
1778 name in the last step of this evaluation and this is used as a key check for
1779 the match. As a result libxslt builds a relatively more complex set of
1780 structures for the templates:</p>
1781
1782 <p align="center"><img src="templates.gif"
1783 alt="The templates related structure"></p>
1784
1785 <p>Let's describe a bit more closely what is built. First the xsltStylesheet
1786 structure holds a pointer to the template hash table. All the XSLT patterns
1787 compiled in this stylesheet are indexed by the value of the the target
1788 element (or attribute, pi ...) name, so when a element or an attribute "foo"
1789 needs to be processed the lookup is done using the name as a key.</p>
1790
1791 <p>Each of the patterns is compiled into an xsltCompMatch structure. It holds
1792 the set of rules based on the tokenization of the pattern stored in reverse
1793 order (matching is easier this way). It also holds some information about the
1794 previous matches used to speed up the process when one iterates over a set of
1795 siblings. (This optimization may be defeated by trashing when running
1796 threaded computation, it's unclear that this is a big deal in practice.)
1797 Predicate expressions are not compiled at this stage, they may be at run-time
1798 if needed, but in this case they are compiled as full XPath expressions (the
1799 use of some fixed predicate can probably be optimized, they are not yet).</p>
1800
1801 <p>The xsltCompMatch are then stored in the hash table, the clash list is
1802 itself sorted by priority of the template to implement "naturally" the XSLT
1803 priority rules.</p>
1804
1805 <p>Associated to the compiled pattern is the xsltTemplate itself containing
1806 the information required for the processing of the pattern including, of
1807 course, a pointer to the list of elements used for building the pattern
1808 result.</p>
1809
1810 <p>Last but not least a number of patterns do not fit in the hash table
1811 because they are not associated to a name, this is the case for patterns
1812 applying to the root, any element, any attributes, text nodes, pi nodes, keys
1813 etc. Those are stored independently in the stylesheet structure as separate
1814 linked lists of xsltCompMatch.</p>
1815
1816 <h3><a name="processing">The processing itself</a></h3>
1817
1818 <p>The processing is defined by the XSLT specification (the basis of the
1819 algorithm is explained in <a
1820 href="http://www.w3.org/TR/xslt#section-Introduction">the Introduction</a>
1821 section). Basically it works by taking the root of the input document and
1822 applying the following algorithm:</p>
1823 <ol>
1824   <li>Finding the template applying to it. This is a lookup in the template
1825     hash table, walking the hash list until the node satisfies all the steps
1826     of the pattern, then checking the appropriate(s) global templates to see
1827     if there isn't a higher priority rule to apply</li>
1828   <li>If there is no template, apply the default rule (recurse on the
1829     children)</li>
1830   <li>else walk the content list of the selected templates, for each of them:
1831     <ul>
1832       <li>if the node is in the XSLT namespace then the node has a _private
1833         field pointing to the preprocessed values, jump to the specific
1834       code</li>
1835       <li>if the node is in an extension namespace, look up the associated
1836         behavior</li>
1837       <li>otherwise copy the node.</li>
1838     </ul>
1839     <p>The closure is usually done through the XSLT
1840     <strong>apply-templates</strong> construct recursing by applying the
1841     adequate template on the input node children or on the result of an
1842     associated XPath selection lookup.</p>
1843   </li>
1844 </ol>
1845
1846 <p>Note that large parts of the input tree may not be processed by a given
1847 stylesheet and that on the opposite some may be processed multiple times.
1848 (This often is the case when a Table of Contents is built).</p>
1849
1850 <p>The module <code>transform.c</code> is the one implementing most of this
1851 logic. <strong>xsltApplyStylesheet()</strong> is the entry point, it
1852 allocates an xsltTransformContext containing the following:</p>
1853 <ul>
1854   <li>a pointer to the stylesheet being processed</li>
1855   <li>a stack of templates</li>
1856   <li>a stack of variables and parameters</li>
1857   <li>an XPath context</li>
1858   <li>the template mode</li>
1859   <li>current document</li>
1860   <li>current input node</li>
1861   <li>current selected node list</li>
1862   <li>the current insertion points in the output document</li>
1863   <li>a couple of hash tables for extension elements and functions</li>
1864 </ul>
1865
1866 <p>Then a new document gets allocated (HTML or XML depending on the type of
1867 output), the user parameters and global variables and parameters are
1868 evaluated. Then <strong>xsltProcessOneNode()</strong> which implements the
1869 1-2-3 algorithm is called on the root element of the input. Step 1/ is
1870 implemented by calling <strong>xsltGetTemplate()</strong>, step 2/ is
1871 implemented by <strong>xsltDefaultProcessOneNode()</strong> and step 3/ is
1872 implemented by <strong>xsltApplyOneTemplate()</strong>.</p>
1873
1874 <h3><a name="XPath">XPath expression compilation</a></h3>
1875
1876 <p>The XPath support is actually implemented in the libxml module (where it
1877 is reused by the XPointer implementation). XPath is a relatively classic
1878 expression language. The only uncommon feature is that it is working on XML
1879 trees and hence has specific syntax and types to handle them.</p>
1880
1881 <p>XPath expressions are compiled using <strong>xmlXPathCompile()</strong>.
1882 It will take an expression string in input and generate a structure
1883 containing the parsed expression tree, for example the expression:</p>
1884 <pre>/doc/chapter[title='Introduction']</pre>
1885
1886 <p>will be compiled as</p>
1887 <pre>Compiled Expression : 10 elements
1888   SORT
1889     COLLECT  'child' 'name' 'node' chapter
1890       COLLECT  'child' 'name' 'node' doc
1891         ROOT
1892       PREDICATE
1893         SORT
1894           EQUAL =
1895             COLLECT  'child' 'name' 'node' title
1896               NODE
1897             ELEM Object is a string : Introduction
1898               COLLECT  'child' 'name' 'node' title
1899                 NODE</pre>
1900
1901 <p>This can be tested using the  <code>testXPath</code>  command (in the
1902 libxml codebase) using the <code>--tree</code> option.</p>
1903
1904 <p>Again, the KISS approach is used. No optimization is done. This could be
1905 an interesting thing to add. <a
1906 href="http://www-106.ibm.com/developerworks/library/x-xslt2/?dwzone=x?open&amp;l=132%2ct=gr%2c+p=saxon">Michael
1907 Kay describes</a> a lot of possible and interesting optimizations done in
1908 Saxon which would be possible at this level. I'm unsure they would provide
1909 much gain since the expressions tends to be relatively simple in general and
1910 stylesheets are still hand generated. Optimizations at the interpretation
1911 sounds likely to be more efficient.</p>
1912
1913 <h3><a name="XPath1">XPath interpretation</a></h3>
1914
1915 <p>The interpreter is implemented by <strong>xmlXPathCompiledEval()</strong>
1916 which is the front-end to <strong>xmlXPathCompOpEval()</strong> the function
1917 implementing the evaluation of the expression tree. This evaluation follows
1918 the KISS approach again. It's recursive and calls
1919 <strong>xmlXPathNodeCollectAndTest()</strong> to collect nodes set when
1920 evaluating a <code>COLLECT</code> node.</p>
1921
1922 <p>An evaluation is done within the framework of an XPath context stored in
1923 an <strong>xmlXPathContext</strong> structure, in the framework of a
1924 transformation the context is maintained within the XSLT context. Its content
1925 follows the requirements from the XPath specification:</p>
1926 <ul>
1927   <li>the current document</li>
1928   <li>the current node</li>
1929   <li>a hash table of defined variables (but not used by XSLT)</li>
1930   <li>a hash table of defined functions</li>
1931   <li>the proximity position (the place of the node in the current node
1932   list)</li>
1933   <li>the context size (the size of the current node list)</li>
1934   <li>the array of namespace declarations in scope (there also is a namespace
1935     hash table but it is not used in the XSLT transformation).</li>
1936 </ul>
1937
1938 <p>For the purpose of XSLT an <strong>extra</strong> pointer has been added
1939 allowing to retrieve the XSLT transformation context. When an XPath
1940 evaluation is about to be performed, an XPath parser context is allocated
1941 containing and XPath object stack (this is actually an XPath evaluation
1942 context, this is a remain of the time where there was no separate parsing and
1943 evaluation phase in the XPath implementation). Here is an overview of the set
1944 of contexts associated to an XPath evaluation within an XSLT
1945 transformation:</p>
1946
1947 <p align="center"><img src="contexts.gif"
1948 alt="The set of contexts associated "></p>
1949
1950 <p>Clearly this is a bit too complex and confusing and should be refactored
1951 at the next set of binary incompatible releases of libxml. For example the
1952 xmlXPathCtxt has a lot of unused parts and should probably be merged with
1953 xmlXPathParserCtxt.</p>
1954
1955 <h3><a name="Descriptio">Description of XPath Objects</a></h3>
1956
1957 <p>An XPath expression manipulates XPath objects. XPath defines the default
1958 types boolean, numbers, strings and node sets. XSLT adds the result tree
1959 fragment type which is basically an unmodifiable node set.</p>
1960
1961 <p>Implementation-wise, libxml follows again a KISS approach, the
1962 xmlXPathObject is a structure containing a type description and the various
1963 possibilities. (Using an enum could have gained some bytes.) In the case of
1964 node sets (or result tree fragments), it points to a separate xmlNodeSet
1965 object which contains the list of pointers to the document nodes:</p>
1966
1967 <p align="center"><img src="object.gif"
1968 alt="An Node set object pointing to "></p>
1969
1970 <p>The <a href="http://xmlsoft.org/html/libxml-xpath.html">XPath API</a> (and
1971 its <a href="http://xmlsoft.org/html/libxml-xpathinternals.html">'internal'
1972 part</a>) includes a number of functions to create, copy, compare, convert or
1973 free XPath objects.</p>
1974
1975 <h3><a name="XPath3">XPath functions</a></h3>
1976
1977 <p>All the XPath functions available to the interpreter are registered in the
1978 function hash table linked from the XPath context. They all share the same
1979 signature:</p>
1980 <pre>void xmlXPathFunc (xmlXPathParserContextPtr ctxt, int nargs);</pre>
1981
1982 <p>The first argument is the XPath interpretation context, holding the
1983 interpretation stack. The second argument defines the number of objects
1984 passed on the stack for the function to consume (last argument is on top of
1985 the stack).</p>
1986
1987 <p>Basically an XPath function does the following:</p>
1988 <ul>
1989   <li>check <code>nargs</code> for proper handling of errors or functions
1990     with variable numbers of parameters</li>
1991   <li>pop the parameters from the stack using <code>obj =
1992     valuePop(ctxt);</code></li>
1993   <li>do the function specific computation</li>
1994   <li>push the result parameter on the stack using <code>valuePush(ctxt,
1995     res);</code></li>
1996   <li>free up the input parameters with
1997   <code>xmlXPathFreeObject(obj);</code></li>
1998   <li>return</li>
1999 </ul>
2000
2001 <p>Sometime the work can be done directly by modifying in-situ the top object
2002 on the stack <code>ctxt-&gt;value</code>.</p>
2003
2004 <h3><a name="stack">The XSLT variables stack frame</a></h3>
2005
2006 <p>Not to be confused with XPath object stack, this stack holds the XSLT
2007 variables and parameters as they are defined through the recursive calls of
2008 call-template, apply-templates and default templates. This is used to define
2009 the scope of variables being called.</p>
2010
2011 <p>This part seems to be the most urgent attention right now, first it is
2012 done in a very inefficient way since the location of the variables and
2013 parameters within the stylesheet tree is still done at run time (it really
2014 should be done statically at compile time), and I am still unsure that my
2015 understanding of the template variables and parameter scope is actually
2016 right.</p>
2017
2018 <p>This part of the documentation is still to be written once this part of
2019 the code will be stable. <span
2020 style="background-color: #FF0000">TODO</span></p>
2021
2022 <h3><a name="Extension">Extension support</a></h3>
2023
2024 <p>There is a separate document explaining <a href="extensions.html">how the
2025 extension support works</a>.</p>
2026
2027 <h3><a name="Futher">Further reading</a></h3>
2028
2029 <p>Michael Kay wrote <a
2030 href="http://www-106.ibm.com/developerworks/library/x-xslt2/?dwzone=x?open&amp;l=132%2ct=gr%2c+p=saxon">a
2031 really interesting article on Saxon internals</a> and the work he did on
2032 performance issues. I wishes I had read it before starting libxslt design (I
2033 would probably have avoided a few mistakes and progressed faster). A lot of
2034 the ideas in his papers should be implemented or at least tried in
2035 libxslt.</p>
2036
2037 <p>The <a href="http://xmlsoft.org/">libxml documentation</a>, especially <a
2038 href="http://xmlsoft.org/xmlio.html">the I/O interfaces</a> and the <a
2039 href="http://xmlsoft.org/xmlmem.html">memory management</a>.</p>
2040
2041 <h3><a name="TODOs">TODOs</a></h3>
2042
2043 <p>redesign the XSLT stack frame handling. Far too much work is done at
2044 execution time. Similarly for the attribute value templates handling, at
2045 least the embedded subexpressions ought to be precompiled.</p>
2046
2047 <p>Allow output to be saved to a SAX like output (this notion of SAX like API
2048 for output should be added directly to libxml).</p>
2049
2050 <p>Implement and test some of the optimization explained by Michael Kay
2051 especially:</p>
2052 <ul>
2053   <li>static slot allocation on the stack frame</li>
2054   <li>specific boolean interpretation of an XPath expression</li>
2055   <li>some of the sorting optimization</li>
2056   <li>Lazy evaluation of location path. (this may require more changes but
2057     sounds really interesting. XT does this too.)</li>
2058   <li>Optimization of an expression tree (This could be done as a completely
2059     independent module.)</li>
2060 </ul>
2061
2062 <p></p>
2063
2064 <p>Error reporting, there is a lot of case where the XSLT specification
2065 specify that a given construct is an error are not checked adequately by
2066 libxslt. Basically one should do a complete pass on the XSLT spec again and
2067 add all tests to the stylesheet compilation. Using the DTD provided in the
2068 appendix and making direct checks using the libxml validation API sounds a
2069 good idea too (though one should take care of not raising errors for
2070 elements/attributes in different namespaces).</p>
2071
2072 <p>Double check all the places where the stylesheet compiled form might be
2073 modified at run time (extra removal of blanks nodes, hint on the
2074 xsltCompMatch).</p>
2075
2076 <p></p>
2077
2078 <h2><a name="Extensions">Writing extensions</a></h2>
2079
2080 <h3>Table  of content</h3>
2081 <ul>
2082   <li><a href="extensions.html#Introducti">Introduction</a></li>
2083   <li><a href="extensions.html#Basics">Basics</a></li>
2084   <li><a href="extensions.html#Keep">Extension modules</a></li>
2085   <li><a href="extensions.html#Registerin">Registering a module</a></li>
2086   <li><a href="extensions.html#module">Loading a module</a></li>
2087   <li><a href="extensions.html#Registerin1">Registering an extension
2088     function</a></li>
2089   <li><a href="extensions.html#Implementi">Implementing an extension
2090     function</a></li>
2091   <li><a href="extensions.html#Examples">Examples for extension
2092   functions</a></li>
2093   <li><a href="extensions.html#Registerin2">Registering an extension
2094     element</a></li>
2095   <li><a href="extensions.html#Implementi1">Implementing an extension
2096     element</a></li>
2097   <li><a href="extensions.html#Example">Example for extension
2098   elements</a></li>
2099   <li><a href="extensions.html#shutdown">The shutdown of a module</a></li>
2100   <li><a href="extensions.html#Future">Future work</a></li>
2101 </ul>
2102
2103 <h3><a name="Introducti1">Introduction</a></h3>
2104
2105 <p>This document describes the work needed to write extensions to the
2106 standard XSLT library for use with <a
2107 href="http://xmlsoft.org/XSLT/">libxslt</a>, the <a
2108 href="http://www.w3.org/TR/xslt">XSLT</a> C library developed for the <a
2109 href="http://www.gnome.org/">GNOME</a> project.</p>
2110
2111 <p>Before starting reading this document it is highly recommended to get
2112 familiar with <a href="internals.html">the libxslt internals</a>.</p>
2113
2114 <p>Note: this documentation is by definition incomplete and I am not good at
2115 spelling, grammar, so patches and suggestions are <a
2116 href="mailto:veillard@redhat.com">really welcome</a>.</p>
2117
2118 <h3><a name="Basics">Basics</a></h3>
2119
2120 <p>The <a href="http://www.w3.org/TR/xslt">XSLT specification</a> provides
2121 two <a href="http://www.w3.org/TR/xslt">ways to extend an XSLT engine</a>:</p>
2122 <ul>
2123   <li>providing <a href="http://www.w3.org/TR/xslt">new extension
2124     functions</a> which can be called from XPath expressions</li>
2125   <li>providing <a href="http://www.w3.org/TR/xslt">new extension
2126     elements</a> which can be inserted in stylesheets</li>
2127 </ul>
2128
2129 <p>In both cases the extensions need to be associated to a new namespace,
2130 i.e. an URI used as the name for the extension's namespace (there is no need
2131 to have a resource there for this to work).</p>
2132
2133 <p>libxslt provides a few extensions itself, either in the libxslt namespace
2134 "http://xmlsoft.org/XSLT/namespace" or in namespaces for other well known
2135 extensions provided by other XSLT processors like Saxon, Xalan or XT.</p>
2136
2137 <h3><a name="Keep">Extension modules</a></h3>
2138
2139 <p>Since extensions are bound to a namespace name, usually sets of extensions
2140 coming from a given source are using the same namespace name defining in
2141 practice a group of extensions providing elements, functions or both. From
2142 the libxslt point of view those are considered as an "extension module", and
2143 most of the APIs work at a module point of view.</p>
2144
2145 <p>Registration of new functions or elements are bound to the activation of
2146 the module. This is currently done by declaring the namespace as an extension
2147 by using the attribute  <code>extension-element-prefixes</code> on the
2148 <code><a href="http://www.w3.org/TR/xslt">xsl:stylesheet</a></code>
2149 element.</p>
2150
2151 <p>An extension module is defined by 3 objects:</p>
2152 <ul>
2153   <li>the namespace name associated</li>
2154   <li>an initialization function</li>
2155   <li>a shutdown function</li>
2156 </ul>
2157
2158 <h3><a name="Registerin">Registering a module</a></h3>
2159
2160 <p>Currently a libxslt module has to be compiled within the application using
2161 libxslt. There is no code to load dynamically shared libraries associated to
2162 a namespace (this may be added but is likely to become a portability
2163 nightmare).</p>
2164
2165 <p>The current way to register a module is to link the code implementing it
2166 with the application and to call a registration function:</p>
2167 <pre>int xsltRegisterExtModule(const xmlChar *URI,
2168                           xsltExtInitFunction initFunc,
2169                           xsltExtShutdownFunction shutdownFunc);</pre>
2170
2171 <p>The associated header is read by:</p>
2172 <pre>#include&lt;libxslt/extensions.h&gt;</pre>
2173
2174 <p>which also defines the type for the initialization and shutdown
2175 functions</p>
2176
2177 <h3><a name="module">Loading a module</a></h3>
2178
2179 <p>Once the module URI has been registered and if the XSLT processor detects
2180 that a given stylesheet needs the functionalities of an extended module, this
2181 one is initialized.</p>
2182
2183 <p>The xsltExtInitFunction type defines the interface for an initialization
2184 function:</p>
2185 <pre>/**
2186  * xsltExtInitFunction:
2187  * @ctxt:  an XSLT transformation context
2188  * @URI:  the namespace URI for the extension
2189  *
2190  * A function called at initialization time of an XSLT
2191  * extension module
2192  *
2193  * Returns a pointer to the module specific data for this
2194  * transformation
2195  */
2196 typedef void *(*xsltExtInitFunction)(xsltTransformContextPtr ctxt,
2197                                      const xmlChar *URI);</pre>
2198
2199 <p>There are 3 things to notice:</p>
2200 <ul>
2201   <li>The function gets passed the namespace name URI as an argument. This
2202     allows a single function to provide the initialization for multiple
2203     logical modules.</li>
2204   <li>It also gets passed a transformation context. The initialization is
2205     done at run time before any processing occurs on the stylesheet but it
2206     will be invoked separately each time for each transformation.</li>
2207   <li>It returns a pointer.  This can be used to store module specific
2208     information which can be retrieved later when a function or an element
2209     from the extension is used.  An obvious example is a connection to a
2210     database which should be kept and reused along with the transformation.
2211     NULL is a perfectly valid return; there is no way to indicate a failure
2212     at this level</li>
2213 </ul>
2214
2215 <p>What this function is expected to do is:</p>
2216 <ul>
2217   <li>prepare the context for this module (like opening the database
2218     connection)</li>
2219   <li>register the extensions specific to this module</li>
2220 </ul>
2221
2222 <h3><a name="Registerin1">Registering an extension function</a></h3>
2223
2224 <p>There is a single call to do this registration:</p>
2225 <pre>int xsltRegisterExtFunction(xsltTransformContextPtr ctxt,
2226                             const xmlChar *name,
2227                             const xmlChar *URI,
2228                             xmlXPathEvalFunc function);</pre>
2229
2230 <p>The registration is bound to a single transformation instance referred by
2231 ctxt, name is the UTF8 encoded name for the NCName of the function, and URI
2232 is the namespace name for the extension (no checking is done, a module could
2233 register functions or elements from a different namespace, but it is not
2234 recommended).</p>
2235
2236 <h3><a name="Implementi">Implementing an extension function</a></h3>
2237
2238 <p>The implementation of the function must have the signature of a libxml
2239 XPath function:</p>
2240 <pre>/**
2241  * xmlXPathEvalFunc:
2242  * @ctxt: an XPath parser context
2243  * @nargs: the number of arguments passed to the function
2244  *
2245  * an XPath evaluation function, the parameters are on the
2246  * XPath context stack
2247  */
2248
2249 typedef void (*xmlXPathEvalFunc)(xmlXPathParserContextPtr ctxt,
2250                                  int nargs);</pre>
2251
2252 <p>The context passed to an XPath function is not an XSLT context but an <a
2253 href="internals.html#XPath1">XPath context</a>. However it is possible to
2254 find one from the other:</p>
2255 <ul>
2256   <li>The function xsltXPathGetTransformContext provides this lookup facility:
2257     <pre>xsltTransformContextPtr
2258          xsltXPathGetTransformContext
2259                           (xmlXPathParserContextPtr ctxt);</pre>
2260   </li>
2261   <li>The <code>xmlXPathContextPtr</code> associated to an
2262     <code>xsltTransformContext</code> is stored in the <code>xpathCtxt</code>
2263     field.</li>
2264 </ul>
2265
2266 <p>The first thing an extension function may want to do is to check the
2267 arguments passed on the stack, the <code>nargs</code> parameter will tell how
2268 many of them were provided on the XPath expression. The macro valuePop will
2269 extract them from the XPath stack:</p>
2270 <pre>#include &lt;libxml/xpath.h&gt;
2271 #include &lt;libxml/xpathInternals.h&gt;
2272
2273 xmlXPathObjectPtr obj = valuePop(ctxt); </pre>
2274
2275 <p>Note that <code>ctxt</code> is the XPath context not the XSLT one. It is
2276 then possible to examine the content of the value. Check <a
2277 href="internals.html#Descriptio">the description of XPath objects</a> if
2278 necessary. The following is a common sequence checking whether the argument
2279 passed is a string and converting it using the built-in XPath
2280 <code>string()</code> function if this is not the case:</p>
2281 <pre>if (obj-&gt;type != XPATH_STRING) {
2282     valuePush(ctxt, obj);
2283     xmlXPathStringFunction(ctxt, 1);
2284     obj = valuePop(ctxt);
2285 }</pre>
2286
2287 <p>Most common XPath functions are available directly at the C level and are
2288 exported either in <code>&lt;libxml/xpath.h&gt;</code> or in
2289 <code>&lt;libxml/xpathInternals.h&gt;</code>.</p>
2290
2291 <p>The extension function may also need to retrieve the data associated to
2292 this module instance (the database connection in the previous example) this
2293 can be done using the xsltGetExtData:</p>
2294 <pre>void * xsltGetExtData(xsltTransformContextPtr ctxt,
2295                       const xmlChar *URI);</pre>
2296
2297 <p>Again the URI to be provided is the one which was used when registering
2298 the module.</p>
2299
2300 <p>Once the function finishes, don't forget to:</p>
2301 <ul>
2302   <li>push the return value on the stack using <code>valuePush(ctxt,
2303     obj)</code></li>
2304   <li>deallocate the parameters passed to the function using
2305     <code>xmlXPathFreeObject(obj)</code></li>
2306 </ul>
2307
2308 <h3><a name="Examples">Examples for extension functions</a></h3>
2309
2310 <p>The module libxslt/functions.c contains the sources of the XSLT built-in
2311 functions, including document(), key(), generate-id(), etc. as well as a full
2312 example module at the end. Here is the test function implementation for the
2313 libxslt:test function:</p>
2314 <pre>/**
2315  * xsltExtFunctionTest:
2316  * @ctxt:  the XPath Parser context
2317  * @nargs:  the number of arguments
2318  *
2319  * function libxslt:test() for testing the extensions support.
2320  */
2321 static void
2322 xsltExtFunctionTest(xmlXPathParserContextPtr ctxt, int nargs)
2323 {
2324     xsltTransformContextPtr tctxt;
2325     void *data;
2326
2327     tctxt = xsltXPathGetTransformContext(ctxt);
2328     if (tctxt == NULL) {
2329         xsltGenericError(xsltGenericErrorContext,
2330             "xsltExtFunctionTest: failed to get the transformation context\n");
2331         return;
2332     }
2333     data = xsltGetExtData(tctxt, (const xmlChar *) XSLT_DEFAULT_URL);
2334     if (data == NULL) {
2335         xsltGenericError(xsltGenericErrorContext,
2336             "xsltExtFunctionTest: failed to get module data\n");
2337         return;
2338     }
2339 #ifdef WITH_XSLT_DEBUG_FUNCTION
2340     xsltGenericDebug(xsltGenericDebugContext,
2341                      "libxslt:test() called with %d args\n", nargs);
2342 #endif
2343 }</pre>
2344
2345 <h3><a name="Registerin2">Registering an extension element</a></h3>
2346
2347 <p>There is a single call to do this registration:</p>
2348 <pre>int xsltRegisterExtElement(xsltTransformContextPtr ctxt,
2349                            const xmlChar *name,
2350                            const xmlChar *URI,
2351                            xsltTransformFunction function);</pre>
2352
2353 <p>It is similar to the mechanism used to register an extension function,
2354 except that the signature of an extension element implementation is
2355 different.</p>
2356
2357 <p>The registration is bound to a single transformation instance referred to
2358 by ctxt, name is the UTF8 encoded name for the NCName of the element, and URI
2359 is the namespace name for the extension (no checking is done, a module could
2360 register elements for a different namespace, but it is not recommended).</p>
2361
2362 <h3><a name="Implementi1">Implementing an extension element</a></h3>
2363
2364 <p>The implementation of the element must have the signature of an XSLT
2365 transformation function:</p>
2366 <pre>/**
2367  * xsltTransformFunction:
2368  * @ctxt: the XSLT transformation context
2369  * @node: the input node
2370  * @inst: the stylesheet node
2371  * @comp: the compiled information from the stylesheet
2372  *
2373  * signature of the function associated to elements part of the
2374  * stylesheet language like xsl:if or xsl:apply-templates.
2375  */
2376 typedef void (*xsltTransformFunction)
2377                           (xsltTransformContextPtr ctxt,
2378                            xmlNodePtr node,
2379                            xmlNodePtr inst,
2380                            xsltStylePreCompPtr comp);</pre>
2381
2382 <p>The first argument is the XSLT transformation context. The second and
2383 third arguments are xmlNodePtr i.e. internal memory <a
2384 href="internals.html#libxml">representation of  XML nodes</a>. They are
2385 respectively <code>node</code> from the the input document being transformed
2386 by the stylesheet and <code>inst</code> the extension element in the
2387 stylesheet. The last argument is <code>comp</code> a pointer to a precompiled
2388 representation of <code>inst</code> but usually for an extension function
2389 this value is <code>NULL</code> by default (it could be added and associated
2390 to the instruction in <code>inst-&gt;_private</code>).</p>
2391
2392 <p>The same functions are available from a function implementing an extension
2393 element as in an extension function, including
2394 <code>xsltGetExtData()</code>.</p>
2395
2396 <p>The goal of an extension element being usually to enrich the generated
2397 output, it is expected that they will grow the currently generated output
2398 tree. This can be done by grabbing ctxt-&gt;insert which is the current
2399 libxml node being generated (Note this can also be the intermediate value
2400 tree being built for example to initialize a variable, the processing should
2401 be similar). The functions for libxml tree manipulation from <a
2402 href="http://xmlsoft.org/html/libxml-tree.html">&lt;libxml/tree.h&gt;</a> can
2403 be employed to extend or modify the tree, but it is required to preserve the
2404 insertion node and its ancestors since there are existing pointers to those
2405 elements still in use in the XSLT template execution stack.</p>
2406
2407 <h3><a name="Example">Example for extension elements</a></h3>
2408
2409 <p>The module libxslt/transform.c contains the sources of the XSLT built-in
2410 elements, including xsl:element, xsl:attribute, xsl:if, etc. There is a small
2411 but full example in functions.c providing the implementation for the
2412 libxslt:test element, it will output a comment in the result tree:</p>
2413 <pre>/**
2414  * xsltExtElementTest:
2415  * @ctxt:  an XSLT processing context
2416  * @node:  The current node
2417  * @inst:  the instruction in the stylesheet
2418  * @comp:  precomputed information
2419  *
2420  * Process a libxslt:test node
2421  */
2422 static void
2423 xsltExtElementTest(xsltTransformContextPtr ctxt, xmlNodePtr node,
2424                    xmlNodePtr inst,
2425                    xsltStylePreCompPtr comp)
2426 {
2427     xmlNodePtr comment;
2428
2429     if (ctxt == NULL) {
2430         xsltGenericError(xsltGenericErrorContext,
2431                          "xsltExtElementTest: no transformation context\n");
2432         return;
2433     }
2434     if (node == NULL) {
2435         xsltGenericError(xsltGenericErrorContext,
2436                          "xsltExtElementTest: no current node\n");
2437         return;
2438     }
2439     if (inst == NULL) {
2440         xsltGenericError(xsltGenericErrorContext,
2441                          "xsltExtElementTest: no instruction\n");
2442         return;
2443     }
2444     if (ctxt-&gt;insert == NULL) {
2445         xsltGenericError(xsltGenericErrorContext,
2446                          "xsltExtElementTest: no insertion point\n");
2447         return;
2448     }
2449     comment =
2450         xmlNewComment((const xmlChar *)
2451                       "libxslt:test element test worked");
2452     xmlAddChild(ctxt-&gt;insert, comment);
2453 }</pre>
2454
2455 <h3><a name="shutdown">The shutdown of a module</a></h3>
2456
2457 <p>When the XSLT processor ends a transformation, the shutdown function (if
2458 it exists) for each of the modules initialized is called.  The
2459 xsltExtShutdownFunction type defines the interface for a shutdown
2460 function:</p>
2461 <pre>/**
2462  * xsltExtShutdownFunction:
2463  * @ctxt:  an XSLT transformation context
2464  * @URI:  the namespace URI for the extension
2465  * @data:  the data associated to this module
2466  *
2467  * A function called at shutdown time of an XSLT extension module
2468  */
2469 typedef void (*xsltExtShutdownFunction) (xsltTransformContextPtr ctxt,
2470                                          const xmlChar *URI,
2471                                          void *data);</pre>
2472
2473 <p>This is really similar to a module initialization function except a third
2474 argument is passed, it's the value that was returned by the initialization
2475 function. This allows the routine to deallocate resources from the module for
2476 example close the connection to the database to keep the same example.</p>
2477
2478 <h3><a name="Future">Future work</a></h3>
2479
2480 <p>Well, some of the pieces missing:</p>
2481 <ul>
2482   <li>a way to load shared libraries to instantiate new modules</li>
2483   <li>a better detection of extension functions usage and their registration
2484     without having to use the extension prefix which ought to be reserved to
2485     element extensions.</li>
2486   <li>more examples</li>
2487   <li>implementations of the <a href="http://www.exslt.org/">EXSLT</a> common
2488     extension libraries, Thomas Broyer nearly finished implementing them.</li>
2489 </ul>
2490
2491 <p></p>
2492
2493 <h2><a name="Contributi">Contributions</a></h2>
2494 <ul>
2495   <li>Bjorn Reese is the author of the number support and worked on the
2496     XSLTMark support</li>
2497   <li>William Brack was an early adopted, contributed a number of patches and
2498     spent quite some time debugging non-trivial problems in early versions of
2499     libxslt</li>
2500   <li><a href="mailto:igor@zlatkovic.com">Igor  Zlatkovic</a> is now the
2501     maintainer of the Windows port, <a
2502     href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
2503     binaries</a></li>
2504   <li>Thomas Broyer provided a lot of suggestions, and drafted most of the
2505     extension API</li>
2506   <li>John Fleck maintains <a href="tutorial/libxslttutorial.html">a tutorial
2507     for libxslt</a></li>
2508   <li><a
2509     href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
2510     Sergeant</a> developed <a
2511     href="http://axkit.org/download/">XML::LibXSLT</a>, a perl wrapper for
2512     libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML
2513     application server</a></li>
2514   <li>there is a module for <a
2515     href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt support
2516     in OpenNSD/AOLServer</a></li>
2517   <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provides
2518     libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for
2519     Python</a></li>
2520   <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a>, and
2521     contributors maintain <a href="http://tclxml.sourceforge.net/">tcl
2522     bindings for libxml2 and libxslt</a>, as well as <a
2523     href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a> a GUI for
2524     xmllint and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>
2525     a GUI for xsltproc.</li>
2526   <li>If you want to use libxslt in a Mac OS X/Cocoa or Objective-C
2527     framework, Marc Liyanage provides <a
2528     href="http://www.entropy.ch/software/macosx/#testxslt">an application
2529     TestXSLT for XSLT and XML editing</a> including wrapper classes for the
2530     XML parser and XSLT processor.</li>
2531 </ul>
2532
2533 <p></p>
2534
2535 <p><a href="mailto:daniel@veillard.com">Daniel Veillard</a></p>
2536 </body>
2537 </html>