freebsd-nq/contrib/gcc/gnats.html
2002-12-04 15:15:07 +00:00

171 lines
5.6 KiB
HTML

<html>
<head>
<title>Submitting Bug Reports using GNATS</title>
</head>
<h1>Submitting Bug Reports using GNATS</h1>
<body>
<h2>gnatsweb and gccbug</h2>
<p>GNATS, the GNU bug tracking system, is used to track GCC bug reports.
Before submitting a bug report, please read the <a
href="bugs.html">general instructions</a>.</p>
<p>The preferred way to submit a bug report is by means of the
<a href="http://gcc.gnu.org/cgi-bin/gnatsweb.pl?database=gcc&amp;user=guest&amp;password=guest&amp;cmd=login">gnatsweb</a>
interface. Make sure you include an e-mail address, so we can inform
you when the status of your report changes.</p>
<p>Another way is to use the <code>gccbug</code> program that is
automatically installed with current versions of GCC, which submits the bug
report by e-mail.</p>
<p>Both techniques use the same GNATS bug database.</p>
<h2>Filling out a report</h2>
<p>The bug report form provides a number of fields; you'll need to
fill-out most of those (as indicated below) to provide a complete
report. The fields have the following purpose:</p>
<dl>
<dt><strong>Originator</strong></dt>
<dd>Your name.</dd>
<dt><strong>Organization</strong></dt>
<dd>Your organization. You can leave this field blank.</dd>
<dt><strong>Confidential</strong></dt>
<dd>This field is unused and set to 'no'. All bug reports, including
sample code, are publicly accessible.</dd>
<dt><strong>Synopsis</strong></dt>
<dd>A one-line description of the problem; something like "GCC 2.95
does not foo", "objc crashes when doing bar".</dd>
<dt><strong>Severity</strong></dt>
<dd>Can be one of
<dl>
<dt>critical</dt>
<dd>GCC is completely not operational; no work-around known.</dd>
<dt>serious</dt>
<dd>GCC is not working properly; a work-around is possible.</dd>
<dt>non-critical</dt>
<dd>Report indicates minor problem.</dd>
</dl>
</dd>
<dt><strong>Priority</strong></dt>
<dd>Can be one of
<dl>
<dt>high</dt>
<dd>A solution is necessary as soon as possible. <em>This is reserved to
GCC maintainers.</em></dd>
<dt>medium</dt>
<dd>The problem should be solved in the next release.</dd>
<dt>low</dt>
<dd>The problem should be solved in a future release.</dd>
</dl>
</dd>
<dt><strong>Category</strong></dt>
<dd>This indicates the GCC subproject which is affected by the problem.
Currently, it can be one of
<dl>
<dt>ada</dt>
<dd>A problem with the Ada compiler, libraries or tools.</dd>
<dt>bootstrap</dt>
<dd>GCC fails to bootstrap. This should be filed <em>only</em> if a
bootstrap failure prevails for an extended period of time (at least
one week) on any platform (and possibly not-so-common conditions like
a read-only srcdir), or non-mainstream platforms.</dd>
<dt>c++</dt>
<dd>A problem with the C++ compiler.</dd>
<dt>c</dt>
<dd>A problem with the C compiler.</dd>
<dt>debug</dt>
<dd>A problem with generating debugging information.</dd>
<dt>fortran</dt>
<dd>A problem with the Fortran compiler.</dd>
<dt>java</dt>
<dd>A problem with the Java compiler.</dd>
<dt>libf2c</dt>
<dd>A problem in the Fortran runtime library.</dd>
<dt>libgcj</dt>
<dd>A problem in the Java runtime library.</dd>
<dt>libobjc</dt>
<dd>A problem in the Objective C runtime library.</dd>
<dt>libstdc++</dt>
<dd>A problem in the Standard C++ runtime library.</dd>
<dt>middle-end</dt>
<dd>A problem in the internal compiler passes.</dd>
<dt>objc</dt>
<dd>A problem with the Objective C compiler.</dd>
<dt>optimization</dt>
<dd>A problem only occurring under optimization.</dd>
<dt>preprocessor</dt>
<dd>A problem with the C preprocessor.</dd>
<dt>target</dt>
<dd>The problem depends on the specific target architecture.</dd>
<dt>web</dt>
<dd>There is an error or omission on the Web pages.</dd>
<dt>other</dt>
<dd>The problem is in none of these categories.</dd>
</dl>
</dd>
<dt><strong>Class</strong></dt>
<dd>A classification of the problem; one of
<dl>
<dt>doc-bug</dt>
<dd>The documentation is incorrect.</dd>
<dt>accepts-illegal</dt>
<dd>GCC fails to reject erroneous code.</dd>
<dt>rejects-legal</dt>
<dd>GCC gives an error message for correct code.</dd>
<dt>wrong-code</dt>
<dd>The machine code generated by GCC is incorrect.</dd>
<dt>ice-on-legal-code</dt>
<dd>GCC gives an Internal Compiler Error (ICE) for correct code.</dd>
<dt>ice-on-illegal-code</dt>
<dd>GCC gives an ICE instead of reporting an error.</dd>
<dt>pessimizes-code</dt>
<dd>GCC misses an important optimization opportunity.</dd>
<dt>sw-bug</dt>
<dd>Software bug of some other class than above.</dd>
<dt>change-request</dt>
<dd>A feature in GCC is missing.</dd>
<dt>support</dt>
<dd>I need help with GCC.</dd>
</dl>
</dd>
<dt><strong>Release</strong></dt>
<dd>GCC version, as obtained from 'gcc -v' (one line).</dd>
<dt><strong>Environment</strong></dt>
<dd>Information about your operating system version, hardware architecture,
and environment settings that affect GCC.</dd>
<dt><strong>Description</strong></dt>
<dd>Precise description of the problem. You should put the error messages
printed by GCC here; source code should go into the next section.</dd>
<dt><strong>How-To-Repeat</strong></dt>
<dd>Please put the complete source code to reproduce the problem here.
The gccbug script currently does not support file
attachments. Instead, if you have multiple files, include them
uuencoded (compressing them before if they are large). If you use
gnatsweb, you can use the file attachments button instead.</dd>
<dt><strong>Fix</strong></dt>
<dd>How to correct or work around the problem, if known (multiple lines).</dd>
</dl>
</body>
</html>