bugs.html 10 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  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" /><link rel="SHORTCUT ICON" href="/favicon.ico" /><style type="text/css">
  4. TD {font-family: Verdana,Arial,Helvetica}
  5. BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
  6. H1 {font-family: Verdana,Arial,Helvetica}
  7. H2 {font-family: Verdana,Arial,Helvetica}
  8. H3 {font-family: Verdana,Arial,Helvetica}
  9. A: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/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 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 XML C parser and toolkit of 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="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</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="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</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="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</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://opencsw.org/packages/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://codespeak.net/lxml/">lxml Python bindings</a></li><li><a href="http://cpan.uwinnipeg.ca/dist/XML-LibXML">Perl bindings</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</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>Well, bugs or missing features are always possible, and I will make a
  11. point of fixing them in a timely fashion. The best way to report a bug is to
  12. use the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome
  13. bug tracking database</a> (make sure to use the "libxml2" module name). I
  14. look at reports there regularly and it's good to have a reminder when a bug
  15. is still open. Be sure to specify that the bug is for the package libxml2.</p><p>For small problems you can try to get help on IRC, the #xml channel on
  16. irc.gnome.org (port 6667) usually have a few person subscribed which may help
  17. (but there is no guarantee and if a real issue is raised it should go on the
  18. mailing-list for archival).</p><p>There is also a mailing-list <a href="mailto:xml@gnome.org">xml@gnome.org</a> for libxml, with an <a href="http://mail.gnome.org/archives/xml/">on-line archive</a> (<a href="http://xmlsoft.org/messages">old</a>). To subscribe to this list,
  19. please visit the <a href="http://mail.gnome.org/mailman/listinfo/xml">associated Web</a> page and
  20. follow the instructions. <strong>Do not send code, I won't debug it</strong>
  21. (but patches are really appreciated!).</p><p>Please note that with the current amount of virus and SPAM, sending mail
  22. to the list without being subscribed won't work. There is *far too many
  23. bounces* (in the order of a thousand a day !) I cannot approve them manually
  24. anymore. If your mail to the list bounced waiting for administrator approval,
  25. it is LOST ! Repost it and fix the problem triggering the error. Also please
  26. note that <span style="color: #FF0000; background-color: #FFFFFF">emails with
  27. a legal warning asking to not copy or redistribute freely the information
  28. they contain</span> are <strong>NOT</strong> acceptable for the mailing-list,
  29. such mail will as much as possible be discarded automatically, and are less
  30. likely to be answered if they made it to the list, <strong>DO NOT</strong>
  31. post to the list from an email address where such legal requirements are
  32. automatically added, get private paying support if you can't share
  33. information.</p><p>Check the following <strong><span style="color: #FF0000">before
  34. posting</span></strong>:</p><ul><li>Read the <a href="FAQ.html">FAQ</a> and <a href="search.php">use the
  35. search engine</a> to get information related to your problem.</li>
  36. <li>Make sure you are <a href="ftp://xmlsoft.org/libxml2/">using a recent
  37. version</a>, and that the problem still shows up in a recent version.</li>
  38. <li>Check the <a href="http://mail.gnome.org/archives/xml/">list
  39. archives</a> to see if the problem was reported already. In this case
  40. there is probably a fix available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">registered
  41. open bugs</a>.</li>
  42. <li>Make sure you can reproduce the bug with xmllint or one of the test
  43. programs found in source in the distribution.</li>
  44. <li>Please send the command showing the error as well as the input (as an
  45. attachment)</li>
  46. </ul><p>Then send the bug with associated information to reproduce it to the <a href="mailto:xml@gnome.org">xml@gnome.org</a> list; if it's really libxml
  47. related I will approve it. Please do not send mail to me directly, it makes
  48. things really hard to track and in some cases I am not the best person to
  49. answer a given question, ask on the list.</p><p>To <span style="color: #E50000">be really clear about support</span>:</p><ul><li>Support or help <span style="color: #E50000">requests MUST be sent to
  50. the list or on bugzilla</span> in case of problems, so that the Question
  51. and Answers can be shared publicly. Failing to do so carries the implicit
  52. message "I want free support but I don't want to share the benefits with
  53. others" and is not welcome. I will automatically Carbon-Copy the
  54. xml@gnome.org mailing list for any technical reply made about libxml2 or
  55. libxslt.</li>
  56. <li>There is <span style="color: #E50000">no guarantee of support</span>. If
  57. your question remains unanswered after a week, repost it, making sure you
  58. gave all the detail needed and the information requested.</li>
  59. <li>Failing to provide information as requested or double checking first
  60. for prior feedback also carries the implicit message "the time of the
  61. library maintainers is less valuable than my time" and might not be
  62. welcome.</li>
  63. </ul><p>Of course, bugs reported with a suggested patch for fixing them will
  64. probably be processed faster than those without.</p><p>If you're looking for help, a quick look at <a href="http://mail.gnome.org/archives/xml/">the list archive</a> may actually
  65. provide the answer. I usually send source samples when answering libxml2
  66. usage questions. The <a href="http://xmlsoft.org/html/book1.html">auto-generated documentation</a> is
  67. not as polished as I would like (i need to learn more about DocBook), but
  68. it's a good starting point.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>