* Fix some grammar nits
* Clean up the formatting a bit
This commit is contained in:
Joe Marcus Clarke
parent
f56ae13adb
commit
bd68581963
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/www/; revision=14013
1 changed files with 49 additions and 45 deletions
|
|
@ -1,6 +1,6 @@
|
||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
||||||
<!ENTITY base CDATA "../..">
|
<!ENTITY base CDATA "../..">
|
||||||
<!ENTITY date "$FreeBSD$">
|
<!ENTITY date "$FreeBSD: www/en/gnome/docs/bugging.sgml,v 1.6 2002/02/04 06:50:41 sobomax Exp $">
|
||||||
<!ENTITY title "FreeBSD GNOME Project: Reporting a Bug">
|
<!ENTITY title "FreeBSD GNOME Project: Reporting a Bug">
|
||||||
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
|
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
|
||||||
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
|
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
|
||||||
|
|
@ -15,72 +15,76 @@
|
||||||
|
|
||||||
<h2>1. What to report?</h2>
|
<h2>1. What to report?</h2>
|
||||||
|
|
||||||
<p>The rule of the thumb should be: report as much information as you
|
<p>The rule of the thumb is: report as much information as you
|
||||||
can, because even if there is some irrelevant information usually
|
can. Even if there is some irrelevant information
|
||||||
developers could quite easy filter it out. On the contrary, the
|
developers can easily filter it out. On the contrary, the
|
||||||
situation is much worse when there is too little information to
|
situation is much worse when there is too little information to
|
||||||
reliably track down or reproduce the problem - in this case developers
|
reliably track down or reproduce the problem - in this case
|
||||||
have to spend their time guessing and/or asking originator of report
|
developers have to spend their time guessing and/or asking
|
||||||
to send more information.</p>
|
originator of report to send more information.</p>
|
||||||
|
|
||||||
<p>There are plenty of examples of totally useless bug reports, something
|
<p>There are plenty of examples of totally useless bug reports,
|
||||||
like <i>"Hey, gnomefoo port is broken. I'm running FreeBSD-X.Y.
|
something like <i>"Hey, gnomefoo port is broken. I'm running
|
||||||
Please fix."</i> Needless to say, that such report is just a waste of
|
FreeBSD-X.Y. Please fix."</i> Needless to say, that such a report
|
||||||
your time, time of the appropriate developer and network bandwidth.
|
is just a waste of your time, time of the appropriate developer,
|
||||||
At the bare minimum the report should include the following
|
and network bandwidth. At a bare minimum the report should
|
||||||
information:</p>
|
include the following information:</p>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>Exact version of the operating system (usually output of
|
<li><p>Exact version of the operating system (usually output of
|
||||||
<tt>uname -a</tt>).</p></li>
|
<tt>uname -a</tt>).</p></li>
|
||||||
<li><p>List of all packages installed on your system.</p></li>
|
<li><p>List of all packages installed on your system.</p></li>
|
||||||
<li><p>Your environment (output of <tt>/usr/bin/env</tt>).
|
<li><p>Your environment (output of <tt>/usr/bin/env</tt>).
|
||||||
<li><p>If you are building from ports then approximate time when you was
|
<li><p>If you are building from ports then the approximate time
|
||||||
last time updating your ports tree.</p></li>
|
when you last updated your ports tree.</p></li>
|
||||||
<li><p>Information specific for each type of breakage: full log of
|
<li><p>Information specific for each type of breakage: full log of
|
||||||
unsuccessful build in the case when the build of the port is broken,
|
unsuccessful build in the case when the build of the port is
|
||||||
stack trace in the case of core dump, clean and detailed description
|
broken, stack trace in the case of a core dump, clear and
|
||||||
of the problem when application does something unexpected etc. Try
|
detailed description of the problem when the application does
|
||||||
to put yourself into developer's shoes and in each particular case
|
something unexpected, etc. Try to put yourself into the
|
||||||
evaluate what information would be necessary for him to locate the
|
developer's shoes and in each particular case evaluate what
|
||||||
source of the problem, don't just assume that he already knows all
|
information would be necessary for them to locate the source of
|
||||||
about the problem, but is just too lazy to fix it.</p></li>
|
the problem. Do not just assume that they already know all
|
||||||
|
about the problem, but are just too lazy to fix it.</p></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<p>If you have a solution or a workaround for the problem then include
|
<p>If you have a solution or a workaround for the problem then include
|
||||||
it into your report as well, even if you are not quite sure that this
|
it into your report as well, even if you are not quite sure that
|
||||||
is a correct fix, if it is not it could give developer idea about
|
this is a correct fix. If it is not it could still give the
|
||||||
what to look at and save him some time.</p>
|
developer an idea about what to look at; and save them some time.
|
||||||
|
</p>
|
||||||
|
|
||||||
<h2>2. Where to report?</h2>
|
<h2>2. Where to report?</h2>
|
||||||
|
|
||||||
<p>There are several ways to report a bug in GNOME running on a FreeBSD
|
<p>There are several ways to report a bug in GNOME running on a FreeBSD
|
||||||
system: you could send report to the
|
system: you could send a report to the
|
||||||
<a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
|
<a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
|
||||||
list</a>, file a problem report in
|
list</a>, file a problem report in the
|
||||||
<a href="http://www.freebsd.org/support.html#gnats">FreeBSD bug
|
<a href="http://www.freebsd.org/support.html#gnats">FreeBSD bug
|
||||||
reporting system</a>, send your report to the particular GNOME
|
reporting system</a>, send your report to the particular GNOME
|
||||||
developers via their
|
developers via their
|
||||||
<a href="http://bugzilla.gnome.org/">bug tracking system</a> or any
|
<a href="http://bugzilla.gnome.org/">bug tracking system</a>, or
|
||||||
combination of those.<p>
|
any combination of those.<p>
|
||||||
|
|
||||||
<p>It is impossible to define guidelines that will clearly tell you where
|
<p>It is impossible to define guidelines that will clearly tell you
|
||||||
to report in each particular case - you have to use your own common
|
where to report in each particular case - you have to use your own
|
||||||
sense, however some rules follow:</p>
|
common sense, however some rules follow:</p>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>If the problem is FreeBSD-specific and transient (e.g. checksum
|
<li><p>If the problem is FreeBSD-specific and transient (e.g.
|
||||||
mismatch, patch failure, syntax error in port's Makefile etc.) then
|
checksum mismatch, patch failure, syntax error in port's Makefile
|
||||||
report to the freebsd-gnome mailing list.</p></li>
|
etc.) then report to the <a href="mailto:&email;@FreeBSD.org">
|
||||||
<li><p>If the problem is clearly not FreeBSD-specific and you have no
|
freebsd-gnome mailing list</a>.</p></li>
|
||||||
readily available solution then report to the developers of the
|
<li><p>If the problem is clearly not FreeBSD-specific and you have
|
||||||
software directly (for most core GNOME components this means that you
|
no readily available solution then report to the developers of the
|
||||||
need to use their Bugzilla bug tracking system).</p></li>
|
software directly (for most core GNOME components this means that
|
||||||
<li><p>If the problem isn't a FreeBSD-specific, but quite serious and you
|
you need to use their Bugzilla bug tracking system).</p></li>
|
||||||
have a fix available then report both to FreeBSD and authors' bug
|
<li><p>If the problem is not FreeBSD-specific, but quite serious
|
||||||
tracking systems, so that the appropriate port will be patched and
|
and you have a fix available then report both to FreeBSD and
|
||||||
other users of FreeBSD will be able to benefit from your fix, without
|
author's bug tracking systems, so that the appropriate port will
|
||||||
the need to wait for a next vendor's release.</p></li>
|
be patched and other users of FreeBSD will be able to benefit
|
||||||
|
from your fix, without the need to wait for the vendor's next
|
||||||
|
release.</p></li>
|
||||||
</ul>
|
</ul>
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue