home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / gimp / 2.0 / help / en / apbs02.html next >
Encoding:
Extensible Markup Language  |  2008-05-03  |  9.0 KB  |  212 lines
  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  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">
  4.   <head>
  5.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  6.     <title>2.¬† Reporting the Bug</title>
  7.     <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
  8.     <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
  9.     <link rel="stylesheet" href="gimp-help-custom.css" type="text/css" />
  10.     <link rel="alternate stylesheet" href="gimp22.css" type="text/css" title="gimp22" />
  11.     <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
  12.     <link rel="start" href="index.html" title="GNU Image Manipulation Program" />
  13.     <link rel="up" href="gimp-introduction-bugs.html" title="Appendix¬†B.¬† Reporting Bugs and Requesting Enhancements" />
  14.     <link rel="prev" href="gimp-introduction-bugs.html" title="Appendix¬†B.¬† Reporting Bugs and Requesting Enhancements" />
  15.     <link rel="next" href="apbs03.html" title="3.¬† What Happens to a Bug Report after you Submit it" />
  16.   </head>
  17.   <body>
  18.     <div class="navheader">
  19.       <table width="100%" summary="Navigation header">
  20.         <tr>
  21.           <th colspan="3" align="center">2.¬†
  22.       <span lang="en" xml:lang="en">Reporting the Bug</span>
  23.     </th>
  24.         </tr>
  25.         <tr>
  26.           <td width="20%" align="left"><a accesskey="p" href="gimp-introduction-bugs.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  27.           <th width="60%" align="center">Appendix¬†B.¬†
  28.     <span lang="en" xml:lang="en">Reporting Bugs and Requesting Enhancements</span>
  29.   </th>
  30.           <td width="20%" align="right">¬†<a accesskey="n" href="apbs03.html"><img src="../images/next.png" alt="Next" /></a></td>
  31.         </tr>
  32.       </table>
  33.       <hr />
  34.     </div>
  35.     <div class="sect1" lang="en" xml:lang="en">
  36.       <div class="titlepage">
  37.         <div>
  38.           <div>
  39.             <h2 class="title" style="clear: both"><a id="id2807038"></a>2.¬†
  40.       <span lang="en" xml:lang="en">Reporting the Bug</span>
  41.     </h2>
  42.           </div>
  43.         </div>
  44.       </div>
  45.       <p>
  46.       Okay, so you have done everything you could to make sure, and you still
  47.       think it's probably a bug. You should then go ahead and file a bug
  48.       report. To do this, begin by going to
  49.       http://bugzilla.gnome.org/enter_bug.cgi, and go down the page until you
  50.       can select the component ‚Äú<span class="quote">GIMP</span>‚Äù.
  51.     </p>
  52.       <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
  53.         <table border="0" summary="Note">
  54.           <tr>
  55.             <td rowspan="2" align="center" valign="top" width="25">
  56.               <img alt="[Note]" src="../images/note.png" />
  57.             </td>
  58.             <th align="left">Note</th>
  59.           </tr>
  60.           <tr>
  61.             <td align="left" valign="top">
  62.               <p>
  63.         The first time you file a bug report, you will be asked to create a
  64.         Bugzilla account. The process is easy and painless, and you probably
  65.         won't even get any spam as a result.
  66.       </p>
  67.             </td>
  68.           </tr>
  69.         </table>
  70.       </div>
  71.       <p>
  72.       This takes you to the bug report form, which you should fill out
  73.       as follows.  Note that most of the information you enter can be
  74.       changed later by the developers if you get it wrong, so try to get
  75.       it right but don't be obsessive about it.
  76.     </p>
  77.       <div class="variablelist">
  78.         <dl>
  79.           <dt>
  80.             <span class="term">Summary</span>
  81.           </dt>
  82.           <dd>
  83.             <p>
  84.             Give a one-sentence summary that is descriptive enough so that
  85.             somebody searching for similar bugs would find your bug report on
  86.             the basis of the words this summary contains.
  87.           </p>
  88.           </dd>
  89.           <dt>
  90.             <span class="term">Steps to reproduce the bug</span>
  91.           </dt>
  92.           <dd>
  93.             <p>
  94.             Follow the directions. Be as specific as you can, and include all
  95.             information that you think might possibly be relevant. The classic
  96.             totally useless bug report is,
  97.             ‚Äú<span class="quote">GIMP crashes. This program sucks</span>‚Äù.
  98.             There is no hope that the developers can solve a problem if they
  99.             can't tell what it is. If at all possible, give a procedure that
  100.             will reliably reproduce the buggy behavior, and give it in enough
  101.             detail so that a moron could follow it.
  102.           </p>
  103.           </dd>
  104.           <dt>
  105.             <span class="term">Component</span>
  106.           </dt>
  107.           <dd>
  108.             <p>
  109.             Set this to the part of <acronym class="acronym">GIMP</acronym> that the bug
  110.             affects. You have to pick something here, but if you aren't
  111.             sure, make a guess and don't worry about it.
  112.           </p>
  113.           </dd>
  114.           <dt>
  115.             <span class="term">Severity</span>
  116.           </dt>
  117.           <dd>
  118.             <p>
  119.             In most cases you should either leave this as
  120.             ‚Äú<span class="quote">Normal</span>‚Äù or set it to ‚Äú<span class="quote">Enhancement</span>‚Äù,
  121.             if it is an enhancement request rather than a
  122.             malfunction. The maintainers will adjust the severity if they
  123.             think it is warranted.
  124.           </p>
  125.           </dd>
  126.           <dt>
  127.             <span class="term">Priority</span>
  128.           </dt>
  129.           <dd>
  130.             <p>
  131.             In most cases you should leave this at ‚Äú<span class="quote">Normal</span>‚Äù,
  132.             and allow the maintainers to adjust it. Setting the priority to
  133.             ‚Äú<span class="quote">Immediate</span>‚Äù or ‚Äú<span class="quote">Urgent</span>‚Äù usually just
  134.             manages to annoy people.
  135.           </p>
  136.           </dd>
  137.           <dt>
  138.             <span class="term">Version</span>
  139.           </dt>
  140.           <dd>
  141.             <p>
  142.             Set this to the version of <acronym class="acronym">GIMP</acronym> that you are
  143.             using. Leave the Gnome version unspecified.
  144.           </p>
  145.           </dd>
  146.           <dt>
  147.             <span class="term">Operating System</span>
  148.           </dt>
  149.           <dd>
  150.             <p>
  151.             Set this to your OS unless you have a very good reason for
  152.             thinking that the bug applies to all operating systems.
  153.           </p>
  154.           </dd>
  155.         </dl>
  156.       </div>
  157.       <p>
  158.       You can ignore the rest. When you have filled out all of these things,
  159.       press the ‚Äú<span class="quote">Commit</span>‚Äù button and your bug report will be
  160.       submitted. It will
  161.       be assigned a number, which you may want to make note of; you will,
  162.       however, be emailed any time somebody makes a comment on your bug report
  163.       or otherwise alters it, so you will receive reminders in any case. You
  164.       can see the current state of your bug report at any time by going to
  165.       http://bugzilla.gnome.org and, at the bottom of the page, in the
  166.       ‚Äú<span class="quote">Actions:</span>‚Äù area, entering the bug number and pressing
  167.       the ‚Äú<span class="quote">Find</span>‚Äù button.
  168.     </p>
  169.       <p>
  170.       Sometimes it is very helpful to augment a bug report with a screenshot
  171.       or some other type of data. If you need to do this, go to the web page
  172.       for your bug report, click on the link
  173.       ‚Äú<span class="quote">Create a New Attachment</span>‚Äù, and
  174.       follow the directions. But please don't do this unless you think the
  175.       attachment is really going to be useful‚Äìand if you need to attach a
  176.       screenshot, don't make it any larger than necessary. Bug reports are
  177.       likely to remain on the system for years, so there is no sense in
  178.       wasting memory.
  179.     </p>
  180.     </div>
  181.     <div class="navfooter">
  182.       <hr />
  183.       <table width="100%" summary="Navigation footer">
  184.         <tr>
  185.           <td width="40%" align="left"><a accesskey="p" href="gimp-introduction-bugs.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  186.           <td width="20%" align="center">
  187.             <a accesskey="u" href="gimp-introduction-bugs.html">
  188.               <img src="../images/up.png" alt="Up" />
  189.             </a>
  190.           </td>
  191.           <td width="40%" align="right">¬†<a accesskey="n" href="apbs03.html"><img src="../images/next.png" alt="Next" /></a></td>
  192.         </tr>
  193.         <tr>
  194.           <td width="40%" align="left" valign="top"><a accesskey="p" href="gimp-introduction-bugs.html">Appendix¬†B.¬†
  195.     <span lang="en" xml:lang="en">Reporting Bugs and Requesting Enhancements</span>
  196.   </a>¬†</td>
  197.           <td width="20%" align="center">
  198.             <a accesskey="h" href="index.html">
  199.               <img src="../images/home.png" alt="Home" />
  200.             </a>
  201.           </td>
  202.           <td width="40%" align="right" valign="top">¬†<a accesskey="n" href="apbs03.html">3.¬†
  203.       <span lang="en" xml:lang="en">
  204.         What Happens to a Bug Report after you Submit it
  205.       </span>
  206.     </a></td>
  207.         </tr>
  208.       </table>
  209.     </div>
  210.   </body>
  211. </html>
  212.