1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><style type="text/css"> 4TD {font-family: Verdana,Arial,Helvetica} 5BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em} 6H1 {font-family: Verdana,Arial,Helvetica} 7H2 {font-family: Verdana,Arial,Helvetica} 8H3 {font-family: Verdana,Arial,Helvetica} 9A:link, A:visited, A:active { text-decoration: underline } 10 </style><title>Reporting bugs and getting help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="GNOME2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C logo" /></a><a href="http://www.redhat.com"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XSLT C library for GNOME</h1><h2>Reporting bugs and getting help</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="intro.html">Introduction</a></li><li><a href="docs.html">Documentation</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="news.html">News</a></li><li><a href="xsltproc2.html">The xsltproc tool</a></li><li><a href="docbook.html">DocBook</a></li><li><a href="API.html">The programming API</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="internals.html">Library internals</a></li><li><a href="extensions.html">Writing extensions</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="EXSLT/index.html" style="font-weight:bold">libexslt</a></li><li><a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="ChangeLog.html">ChangeLog</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="tutorial/libxslttutorial.html">Tutorial</a>, 11 <a href="tutorial2/libxslt_pipes.html">Tutorial2</a></li><li><a href="xsltproc.html">Man page for xsltproc</a></li><li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li><li><a href="http://xmlsoft.org/">XML libxml2</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li><li><a href="http://codespeak.net/lxml/">lxml Python bindings</a></li><li><a href="http://cpan.uwinnipeg.ca/dist/XML-LibXSLT">Perl XSLT bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading17">XSLT with PHP</a></li><li><a href="http://www.mod-xslt2.com/">Apache module</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>If you need help with the XSLT language itself, here are a number of 12useful resources:</p><ul> 13 <li>I strongly suggest to subscribe to <a href="http://www.mulberrytech.com/xsl/xsl-list">XSL-list</a>, check <a href="http://www.biglist.com/lists/xsl-list/archives/">the XSL-list 14 archives</a></li> 15 <li>The <a href="http://www.dpawson.co.uk/xsl/xslfaq.html">XSL FAQ</a>.</li> 16 <li>The <a href="http://www.nwalsh.com/docs/tutorials/xsl/xsl/slides.html">tutorial</a> 17 written by Paul Grosso and Norman Walsh is a very good on-line 18 introdution to the language.</li> 19 <li>The <a href="http://www.zvon.org/xxl/XSLTutorial/Books/Book1/index.html">only 20 Zvon XSLT tutorial</a> details a lot of constructs with examples.</li> 21 <li><a href="http://www.jenitennison.com/xslt/index.html">Jeni Tennison's 22 XSLT</a> pages provide links to a lot of answers</li> 23 <li>the <a href="http://incrementaldevelopment.com/xsltrick/">Gallery of 24 XSLT Tricks</a> provides non-standard use case of XSLT</li> 25 <li>And I suggest to buy Michael Kay "XSLT Programmer's Reference" book 26 published by <a href="http://www.wrox.com/">Wrox</a> if you plan to work 27 seriously with XSLT in the future.</li> 28</ul><p>Well, bugs or missing features are always possible, and I will make a 29point of fixing them in a timely fashion. The best way to report a bug is to 30use the <a href="http://bugzilla.gnome.org/enter_bug.cgi?product=libxslt">GNOME bug 31tracking database</a> (make sure to use the "libxslt" module name). Before 32filing a bug, check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">list of existing 33libxslt bugs</a> to make sure it hasn't already been filed. I look at reports 34there regularly and it's good to have a reminder when a bug is still open. Be 35sure to specify that the bug is for the package libxslt.</p><p>For small problems you can try to get help on IRC, the #xml channel on 36irc.gnome.org (port 6667) usually have a few person subscribed which may help 37(but there is no guarantee and if a real issue is raised it should go on the 38mailing-list for archival).</p><p>There is also a mailing-list <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> for libxslt, with an <a href="http://mail.gnome.org/archives/xslt/">on-line archive</a>. To subscribe 39to this list, please visit the <a href="http://mail.gnome.org/mailman/listinfo/xslt">associated Web</a> page 40and follow the instructions.</p><p>Alternatively, you can just send the bug to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> list, if it's really libxslt 41related I will approve it.. Please do not send me mail directly especially 42for portability problem, it makes things really harder to track and in some 43cases I'm not the best person to answer a given question, ask the list 44instead. <strong>Do not send code, I won't debug it</strong> (but patches are 45really appreciated!).</p><p>Please note that with the current amount of virus and SPAM, sending mail 46to the list without being subscribed won't work. There is *far too many 47bounces* (in the order of a thousand a day !) I cannot approve them manually 48anymore. If your mail to the list bounced waiting for administrator approval, 49it is LOST ! Repost it and fix the problem triggering the error. Also please 50note that <span style="color: #FF0000; background-color: #FFFFFF">emails with 51a legal warning asking to not copy or redistribute freely the information 52they contain</span> are <strong>NOT</strong> acceptable for the mailing-list, 53such mail will as much as possible be discarded automatically, and are less 54likely to be answered if they made it to the list, <strong>DO NOT</strong> 55post to the list from an email address where such legal requirements are 56automatically added, get private paying support if you can't share 57information.</p><p>Check the following too <span style="color: #E50000">before 58posting</span>:</p><ul> 59 <li><a href="search.php">use the search engine</a> to get information 60 related to your problem.</li> 61 <li>make sure you are <a href="ftp://xmlsoft.org/libxslt/">using a recent 62 version</a>, and that the problem still shows up in those</li> 63 <li>check the <a href="http://mail.gnome.org/archives/xslt/">list 64 archives</a> to see if the problem was reported already, in this case 65 there is probably a fix available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">registered 66 open bugs</a></li> 67 <li>make sure you can reproduce the bug with xsltproc, a very useful thing 68 to do is run the transformation with -v argument and redirect the 69 standard error to a file, then search in this file for the transformation 70 logs just preceding the possible problem</li> 71 <li>Please send the command showing the error as well as the input and 72 stylesheet (as an attachment)</li> 73</ul><p>Then send the bug with associated information to reproduce it to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> list; if it's really libxslt 74related I will approve it. Please do not send mail to me directly, it makes 75things really hard to track and in some cases I am not the best person to 76answer a given question, ask on the list.</p><p>To <span style="color: #E50000">be really clear about support</span>:</p><ul> 77 <li>Support or help <span style="color: #E50000">request MUST be sent to 78 the list or on bugzilla</span> in case of problems, so that the Question 79 and Answers can be shared publicly. Failing to do so carries the implicit 80 message "I want free support but I don't want to share the benefits with 81 others" and is not welcome. I will automatically Carbon-Copy the 82 xslt@gnome.org mailing list for any technical reply made about libxml2 or 83 libxslt.</li> 84 <li>There is <span style="color: #E50000">no guarantee for support</span>, 85 if your question remains unanswered after a week, repost it, making sure 86 you gave all the detail needed and the information requested.</li> 87 <li>Failing to provide information as requested or double checking first 88 for prior feedback also carries the implicit message "the time of the 89 library maintainers is less valuable than my time" and might not be 90 welcome.</li> 91</ul><p>Of course, bugs reports with a suggested patch for fixing them will 92probably be processed faster.</p><p>If you're looking for help, a quick look at <a href="http://mail.gnome.org/archives/xslt/">the list archive</a> may actually 93provide the answer, I usually send source samples when answering libxslt 94usage questions. The <a href="html/libxslt-lib.html#LIBXSLT-LIB">auto-generated documentation</a> is 95not as polished as I would like (I need to learn more about Docbook), but 96it's a good starting point.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> 97