Blame doc/bugs.html

Packit 423ecb
Packit 423ecb
Packit 423ecb
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="SHORTCUT ICON" href="/favicon.ico" /><style type="text/css">
Packit 423ecb
TD {font-family: Verdana,Arial,Helvetica}
Packit 423ecb
BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
Packit 423ecb
H1 {font-family: Verdana,Arial,Helvetica}
Packit 423ecb
H2 {font-family: Verdana,Arial,Helvetica}
Packit 423ecb
H3 {font-family: Verdana,Arial,Helvetica}
Packit 423ecb
A:link, A:visited, A:active { text-decoration: underline }
Packit 423ecb
</style><title>Reporting bugs and getting help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000">
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

The XML C parser and toolkit of Gnome

Reporting bugs and getting help

<center>Main Menu</center>
<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>
<center>Related links</center>

Well, bugs or missing features are always possible, and I will make a

Packit 423ecb
point of fixing them in a timely fashion. The best way to report a bug is to
Packit 423ecb
use the Gnome
Packit 423ecb
bug tracking database (make sure to use the "libxml2" module name). I
Packit 423ecb
look at reports there regularly and it's good to have a reminder when a bug
Packit 423ecb
is still open. Be sure to specify that the bug is for the package libxml2.

For small problems you can try to get help on IRC, the #xml channel on

Packit 423ecb
irc.gnome.org (port 6667) usually has a few people subscribed which may help
Packit 423ecb
(but there is no guarantee and if a real issue is raised it should go on the
Packit 423ecb
mailing-list for archival).

There is also a mailing-list xml@gnome.org for libxml, with an on-line archive (old). To subscribe to this list,

Packit 423ecb
please visit the associated Web page and
Packit 423ecb
follow the instructions. Do not send code, I won't debug it
Packit 423ecb
(but patches are really appreciated!).

Please note that with the current amount of virus and SPAM, sending mail

Packit 423ecb
to the list without being subscribed won't work. There is *far too many
Packit 423ecb
bounces* (in the order of a thousand a day !) I cannot approve them manually
Packit 423ecb
anymore. If your mail to the list bounced waiting for administrator approval,
Packit 423ecb
it is LOST ! Repost it and fix the problem triggering the error. Also please
Packit 423ecb
note that emails with
Packit 423ecb
a legal warning asking to not copy or redistribute freely the information
Packit 423ecb
they contain are NOT acceptable for the mailing-list,
Packit 423ecb
such mail will as much as possible be discarded automatically, and are less
Packit 423ecb
likely to be answered if they made it to the list, DO NOT
Packit 423ecb
post to the list from an email address where such legal requirements are
Packit 423ecb
automatically added, get private paying support if you can't share
Packit 423ecb
information.

Check the following before

Packit 423ecb
posting:

    Packit 423ecb
      
  • Read the FAQ and use the
  • Packit 423ecb
        search engine to get information related to your problem.
    Packit 423ecb
      
  • Make sure you are using a recent
  • Packit 423ecb
        version, and that the problem still shows up in a recent version.
    Packit 423ecb
      
  • Check the list
  • Packit 423ecb
        archives to see if the problem was reported already. In this case
    Packit 423ecb
        there is probably a fix available, similarly check the registered
    Packit 423ecb
        open bugs.
    Packit 423ecb
      
  • Make sure you can reproduce the bug with xmllint or one of the test
  • Packit 423ecb
        programs found in source in the distribution.
    Packit 423ecb
      
  • Please send the command showing the error as well as the input (as an
  • Packit 423ecb
        attachment)
    Packit 423ecb

    Then send the bug with associated information to reproduce it to the xml@gnome.org list; if it's really libxml

    Packit 423ecb
    related I will approve it. Please do not send mail to me directly, it makes
    Packit 423ecb
    things really hard to track and in some cases I am not the best person to
    Packit 423ecb
    answer a given question, ask on the list.

    To be really clear about support:

      Packit 423ecb
        
    • Support or help requests MUST be sent to
    • Packit 423ecb
          the list or on bugzilla in case of problems, so that the Question
      Packit 423ecb
          and Answers can be shared publicly. Failing to do so carries the implicit
      Packit 423ecb
          message "I want free support but I don't want to share the benefits with
      Packit 423ecb
          others" and is not welcome. I will automatically Carbon-Copy the
      Packit 423ecb
          xml@gnome.org mailing list for any technical reply made about libxml2 or
      Packit 423ecb
          libxslt.
      Packit 423ecb
        
    • There is no guarantee of support. If
    • Packit 423ecb
          your question remains unanswered after a week, repost it, making sure you
      Packit 423ecb
          gave all the detail needed and the information requested.
      Packit 423ecb
        
    • Failing to provide information as requested or double checking first
    • Packit 423ecb
          for prior feedback also carries the implicit message "the time of the
      Packit 423ecb
          library maintainers is less valuable than my time" and might not be
      Packit 423ecb
          welcome.
      Packit 423ecb

      Of course, bugs reported with a suggested patch for fixing them will

      Packit 423ecb
      probably be processed faster than those without.

      If you're looking for help, a quick look at the list archive may actually

      Packit 423ecb
      provide the answer. I usually send source samples when answering libxml2
      Packit 423ecb
      usage questions. The auto-generated documentation is
      Packit 423ecb
      not as polished as I would like (i need to learn more about DocBook), but
      Packit 423ecb
      it's a good starting point.

      Daniel Veillard

      </body></html>