<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">

<s1 title="Bug Reporting">

    <s2 title="How to report bugs">
        <p> Please report bugs to <jump href="http://nagoya.apache.org/bugzilla/">Bugzilla</jump>,
	     the Apache bug database.  Pick the product "Xerces-C++: Apache XML parsers in C++"
            using the following components:
        </p>
        <table>
            <tr><th><em>Component</em></th><th><em>Description</em></th></tr>
            <tr><td>DOM</td><td>Items specific to DOM</td></tr>
            <tr><td>SAX/SAX2</td><td>Items specific to SAX or SAX2</td></tr>
            <tr><td>Non-Validating Parser</td><td>General Parsing Problem</td></tr>
            <tr><td>Validating Parser (DTD)</td><td>DTD related parser issue</td></tr>
            <tr><td>Validating Parser (Schema)</td><td>Schema related parser issue</td></tr>
            <tr><td>Utilities</td><td>Items related to utilities like MessageLoader, Transcoder, NetAccessors, Platform specific utilities</td></tr>
            <tr><td>Build</td><td>Problem with build, makefile, project files</td></tr>
            <tr><td>Documentation</td><td>Documentation bugs such as FAQ, Programming Guide</td></tr>
            <tr><td>Samples/Tests</td><td>Samples or test cases related issues</td></tr>
            <tr><td>Miscellaneous</td><td>Items not covered in other categories</td></tr>
        </table>
        <p>A copy of your bug report is sent automatically to the discussion list
           <jump href="mailto:&XercesCEmailAddress;">&XercesCName; mailing list</jump>.
        </p>
    </s2>
			
    <s2 title="Search first">
        <p> Check the <jump href="http://nagoya.apache.org/bugzilla/">Bugzilla</jump> database
            before submitting your bug report to avoid creating a duplicate report.
            Even the bug has been reported already, you may add a comment to the existing report
            since your contribution may lead to a quicker identification/resolution to the bug reported.
        </p>
        <p> Here is the list of
            <jump href=
            "http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Xerces-C%2B%2B&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;order=bugs.bug_id">
            outstanding bugs</jump>  that are currently reported in Bugzilla.
        </p>
        <p> Here is the list of
            <jump href=
            "http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Xerces-C%2B%2B&amp;short_desc=&amp;short_desc_type=substring&amp;long_desc=&amp;long_desc_type=substring&amp;bug_file_loc=&amp;bug_file_loc_type=substring&amp;keywords=PatchAvailable&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;newqueryname=&amp;order=bugs.bug_id">
            outstanding patch</jump>.
        </p>
    </s2>

    <s2 title="Write good bug report">
        <p> Writing a useful bug report, which makes the bug reproducible, is the first step
            towards the resolution of the bug. Specifics about the bug, like
        </p>
	 <ul>
          <li>&XercesCName; version number</li>
          <li>Platform</li>
          <li>Operating system and version number</li>
          <li>Compiler and version number</li>
          <li>The XML document (or excerpt) that failed</li>
          <li>The C++ application code that failed</li>
          <li>Whether you built the &XercesCName; library yourself or used the
              binary distribution</li>
          <li>What happened</li>
        </ul>			
        <p>
            are all necessary information to allow developer to reproduce,
            identify, evaluate and eventually, fix the bug, which is the very
            purpose of your reporting of the bug.
        </p>
        <p> And please use the Keyword <code>"PatchAvailable"</code> if a patch is attached
        </p>
    </s2>
</s1>
