source: trunk/third/libxslt/doc/bugs.html @ 18543

Revision 18543, 10.0 KB checked in by ghudson, 21 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r18542, which included commits to RCS files with non-trunk default branches.
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5<style type="text/css"><!--
6TD {font-family: Verdana,Arial,Helvetica}
7BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
8H1 {font-family: Verdana,Arial,Helvetica}
9H2 {font-family: Verdana,Arial,Helvetica}
10H3 {font-family: Verdana,Arial,Helvetica}
11A:link, A:visited, A:active { text-decoration: underline }
12--></style>
13<title>Reporting bugs and getting help</title>
14</head>
15<body bgcolor="#8b7765" text="#000000" link="#000000" vlink="#000000">
16<table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr>
17<td width="100">
18<a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 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>
19</td>
20<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">
21<h1>The XSLT C library for Gnome</h1>
22<h2>Reporting bugs and getting help</h2>
23</td></tr></table></td></tr></table></td>
24</tr></table>
25<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>
26<td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td>
27<table width="100%" border="0" cellspacing="1" cellpadding="3">
28<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr>
29<tr><td bgcolor="#fffacd">
30<form action="search.php" enctype="application/x-www-form-urlencoded" method="GET">
31<input name="query" type="TEXT" size="20" value=""><input name="submit" type="submit" value="Search ...">
32</form>
33<ul>
34<li><a href="index.html">Home</a></li>
35<li><a href="intro.html">Introduction</a></li>
36<li><a href="docs.html">Documentation</a></li>
37<li><a href="bugs.html">Reporting bugs and getting help</a></li>
38<li><a href="help.html">How to help</a></li>
39<li><a href="downloads.html">Downloads</a></li>
40<li><a href="FAQ.html">FAQ</a></li>
41<li><a href="news.html">News</a></li>
42<li><a href="xsltproc2.html">The xsltproc tool</a></li>
43<li><a href="docbook.html">DocBook</a></li>
44<li><a href="API.html">The programming API</a></li>
45<li><a href="python.html">Python and bindings</a></li>
46<li><a href="internals.html">Library internals</a></li>
47<li><a href="extensions.html">Writing extensions</a></li>
48<li><a href="contribs.html">Contributions</a></li>
49<li>
50<a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a>
51</li>
52</ul>
53</td></tr>
54</table>
55<table width="100%" border="0" cellspacing="1" cellpadding="3">
56<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr>
57<tr><td bgcolor="#fffacd"><ul>
58<li><a href="tutorial/libxslttutorial.html">Tutorial</a></li>
59<li><a href="xsltproc.html">Man page for xsltproc</a></li>
60<li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li>
61<li><a href="http://xmlsoft.org/">XML libxml</a></li>
62<li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li>
63<li><a href="ftp://xmlsoft.org/">FTP</a></li>
64<li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li>
65<li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
66<li><a href="http://www.zveno.com/open_source/libxml2xslt.html">MacOsX binaries</a></li>
67<li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li>
68<li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li>
69<li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li>
70</ul></td></tr>
71</table>
72<table width="100%" border="0" cellspacing="1" cellpadding="3">
73<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr>
74<tr><td bgcolor="#fffacd"><ul>
75<li><a href="APIchunk0.html">Alphabetic</a></li>
76<li><a href="APIconstructors.html">Constructors</a></li>
77<li><a href="APIfunctions.html">Functions/Types</a></li>
78<li><a href="APIfiles.html">Modules</a></li>
79<li><a href="APIsymbols.html">Symbols</a></li>
80</ul></td></tr>
81</table>
82</td></tr></table></td>
83<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">
84<p>If you need help with the XSLT language itself, here are a number of
85useful resources:</p>
86<ul>
87<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
88    archives</a>
89</li>
90  <li>The <a href="http://www.dpawson.co.uk/xsl/xslfaq.html">XSL FAQ</a>.</li>
91  <li>The <a href="http://www.nwalsh.com/docs/tutorials/xsl/xsl/slides.html">tutorial</a>
92    written by Paul Grosso and Norman Walsh is a very good on-line
93    introdution to the language.</li>
94  <li>The <a href="http://www.zvon.org/xxl/XSLTutorial/Books/Book1/index.html">only
95    Zvon XSLT tutorial</a> details a lot of constructs with examples.</li>
96  <li>
97<a href="http://www.jenitennison.com/xslt/index.html">Jeni Tennison's
98    XSLT</a> pages provide links to a lot of answers</li>
99  <li>the <a href="http://incrementaldevelopment.com/xsltrick/">Gallery of
100    XSLT Tricks</a> provides non-standard use case of XSLT</li>
101  <li>And I suggest to buy Michael Kay &quot;XSLT Programmer's Reference&quot; book
102    published by <a href="http://www.wrox.com/">Wrox</a> if you plan to work
103    seriously with XSLT in the future.</li>
104</ul>
105<p>Well, bugs or missing features are always possible, and I will make a
106point of fixing them in a timely fashion. The best way to report a bug is to
107use the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Gnome
108bug tracking database</a> (make sure to use the &quot;libxslt&quot; module name). I
109look at reports there regularly and it's good to have a reminder when a bug
110is still open. Be sure to specify that the bug is for the package libxslt.</p>
111<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
112to this list, please visit the <a href="http://mail.gnome.org/mailman/listinfo/xslt">associated Web</a> page
113and follow the instructions.</p>
114<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
115related I will approve it.. Please do not send me mail directly especially
116for portability problem, it makes things really harder to track and in some
117cases I'm not the best person to answer a given question, ask the list
118instead. <strong>Do not send code, I won't debug it</strong> (but patches are
119really appreciated!).</p>
120<p>Check the following too <span style="color: #E50000">before
121posting</span>:</p>
122<ul>
123<li>
124<a href="search.php">use the search engine</a> to get informations
125    related to your problem.</li>
126  <li>make sure you are <a href="ftp://xmlsoft.org/">using a recent
127    version</a>, and that the problem still shows up in those</li>
128  <li>check the <a href="http://mail.gnome.org/archives/xslt/">list
129    archives</a> to see if the problem was reported already, in this case
130    there is probably a fix available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">registered
131    open bugs</a>
132</li>
133  <li>make sure you can reproduce the bug with xsltproc, a very useful thing
134    to do is run the transformation with -v argument and redirect the
135    standard error to a file, then search in this file for the transformation
136    logs just preceding the possible problem</li>
137  <li>Please send the command showing the error as well as the input and
138    stylesheet (as an attachment)</li>
139</ul>
140<p>Then send the bug with associated informations to reproduce it to the <a href="mailto:xslt@gnome.org">xslt@gnome.org</a> list; if it's really libxslt
141related I will approve it. Please do not send mail to me directly, it makes
142things really hard to track and in some cases I am not the best person to
143answer a given question, ask on the list.</p>
144<p>To <span style="color: #E50000">be really clear about support</span>:</p>
145<ul>
146<li>Support or help <span style="color: #E50000">request MUST be sent to
147    the list or on bugzilla</span> in case of problems, so that the Question
148    and Answers can be shared publicly. Failing to do so carries the implicit
149    message &quot;I want free support but I don't want to share the benefits with
150    others&quot; and is not welcome.</li>
151  <li>There is <span style="color: #E50000">no garantee for support</span>,
152    if your question remains unanswered after a week, repost it, making sure
153    you gave all the detail needed and the informations requested.</li>
154  <li>Failing to provide informations as requested or double checking first
155    for prior feedback also carries the implicit message &quot;the time of the
156    library maintainers is less valuable than my time&quot; and might not be
157    welcome.</li>
158</ul>
159<p>Of course, bugs reports with a suggested patch for fixing them will
160probably be processed faster.</p>
161<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
162provide the answer, I usually send source samples when answering libxslt
163usage questions. The <a href="html/libxslt-lib.html#LIBXSLT-LIB">auto-generated documentation</a> is
164not as polished as I would like (I need to learn more about Docbook), but
165it's a good starting point.</p>
166<p><a href="bugs.html">Daniel Veillard</a></p>
167</td></tr></table></td></tr></table></td></tr></table></td>
168</tr></table></td></tr></table>
169</body>
170</html>
Note: See TracBrowser for help on using the repository browser.