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 / gimp-introduction-bugs.html < prev    next >
Encoding:
Extensible Markup Language  |  2008-05-03  |  12.4 KB  |  291 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>Appendix¬†B.¬† Reporting Bugs and Requesting Enhancements</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="index.html" title="GNU Image Manipulation Program" />
  14.     <link rel="prev" href="gimp-introduction-history-2-2.html" title="5.¬† What's New in GIMP 2.2?" />
  15.     <link rel="next" href="apbs02.html" title="2.¬† Reporting the Bug" />
  16.   </head>
  17.   <body>
  18.     <div class="navheader">
  19.       <table width="100%" summary="Navigation header">
  20.         <tr>
  21.           <th colspan="3" align="center">Appendix¬†B.¬†
  22.     <span lang="en" xml:lang="en">Reporting Bugs and Requesting Enhancements</span>
  23.   </th>
  24.         </tr>
  25.         <tr>
  26.           <td width="20%" align="left"><a accesskey="p" href="gimp-introduction-history-2-2.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  27.           <th width="60%" align="center">¬†</th>
  28.           <td width="20%" align="right">¬†<a accesskey="n" href="apbs02.html"><img src="../images/next.png" alt="Next" /></a></td>
  29.         </tr>
  30.       </table>
  31.       <hr />
  32.     </div>
  33.     <div class="appendix" lang="en" xml:lang="en">
  34.       <div class="titlepage">
  35.         <div>
  36.           <div>
  37.             <h2 class="title"><a id="gimp-introduction-bugs"></a>Appendix¬†B.¬†
  38.     <span lang="en" xml:lang="en">Reporting Bugs and Requesting Enhancements</span>
  39.   </h2>
  40.           </div>
  41.         </div>
  42.       </div>
  43.       <div class="toc">
  44.         <p>
  45.           <b>Table of Contents</b>
  46.         </p>
  47.         <dl>
  48.           <dt>
  49.             <span class="sect1">
  50.               <a href="gimp-introduction-bugs.html#id2806752">1. 
  51.       <span lang="en" xml:lang="en">Making sure it's a Bug</span>
  52.     </a>
  53.             </span>
  54.           </dt>
  55.           <dt>
  56.             <span class="sect1">
  57.               <a href="apbs02.html">2. 
  58.       <span lang="en" xml:lang="en">Reporting the Bug</span>
  59.     </a>
  60.             </span>
  61.           </dt>
  62.           <dt>
  63.             <span class="sect1">
  64.               <a href="apbs03.html">3. 
  65.       <span lang="en" xml:lang="en">
  66.         What Happens to a Bug Report after you Submit it
  67.       </span>
  68.     </a>
  69.             </span>
  70.           </dt>
  71.         </dl>
  72.       </div>
  73.       <a id="id2806646" class="indexterm"></a>
  74.       <a id="id2806659" class="indexterm"></a>
  75.       <p>
  76.     Sad to say, no version of <acronym class="acronym">GIMP</acronym>
  77.     has yet been absolutely perfect. Even sadder, it is likely that no version
  78.     ever will be. In spite of all efforts to make everything work, a program
  79.     as complicated as <acronym class="acronym">GIMP</acronym>
  80.     is bound to screw things up occasionally, or even crash.
  81.   </p>
  82.       <p>
  83.     But the fact that bugs are unavoidable does not mean that they should be
  84.     passively accepted. If you find a bug in <acronym class="acronym">GIMP</acronym>, the
  85.     developers would like to know about it so they can at least try to fix it.
  86.   </p>
  87.       <p>
  88.     Suppose, then, that you have found a bug, or at least think you have: you
  89.     try to do something, and the results are not what you expect. What should
  90.     you do? How should you report it?
  91.   </p>
  92.       <div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
  93.         <table border="0" summary="Tip">
  94.           <tr>
  95.             <td rowspan="2" align="center" valign="top" width="25">
  96.               <img alt="[Tip]" src="../images/tip.png" />
  97.             </td>
  98.             <th align="left">Tip</th>
  99.           </tr>
  100.           <tr>
  101.             <td align="left" valign="top">
  102.               <p>
  103.       The procedure for making an <span class="emphasis"><em>enhancement
  104.       request</em></span>‚Äìthat is, for asking the developers to add a
  105.       missing feature‚Äìis nearly the same as the procedure for
  106.       reporting a bug.  The only thing you do differently is to mark the
  107.       report as an ‚Äú<span class="quote">enhancement</span>‚Äù at the appropriate stage, as
  108.       described below.
  109.     </p>
  110.             </td>
  111.           </tr>
  112.         </table>
  113.       </div>
  114.       <p>
  115.     In common with many other free software projects,
  116.     <acronym class="acronym">GIMP</acronym> uses a bug-reporting mechanism called
  117.     <span class="emphasis"><em>Bugzilla</em></span>.
  118.     This is a very powerful web-based system, capable of managing thousands
  119.     of bug reports without losing track. In fact, <acronym class="acronym">GIMP</acronym>
  120.     shares its Bugzilla database with the entire Gnome project. At the time
  121.     this is being written, Gnome Bugzilla contains 148632 bug reports‚Äìno, make
  122.     that 148633.
  123.   </p>
  124.       <div class="sect1" lang="en" xml:lang="en">
  125.         <div class="titlepage">
  126.           <div>
  127.             <div>
  128.               <h2 class="title" style="clear: both"><a id="id2806752"></a>1.¬†
  129.       <span lang="en" xml:lang="en">Making sure it's a Bug</span>
  130.     </h2>
  131.             </div>
  132.           </div>
  133.         </div>
  134.         <p>
  135.       The first thing you should do, before reporting a bug, is to make
  136.       an effort to verify that what you are seeing really
  137.       <span class="emphasis"><em>is</em></span> a bug.  It is hard to give a method for
  138.       doing this that applies to all situations, but reading the
  139.       documentation will often be useful, and discussing the question on
  140.       IRC or a mailing list may also be quite helpful.  If you are
  141.       seeing a <span class="emphasis"><em>crash</em></span>, as opposed to mere
  142.       misbehavior, the odds that it is a true bug are pretty high: well
  143.       written software programs are not designed to crash under
  144.       <span class="emphasis"><em>any</em></span> circumstances.  In any case, if you have
  145.       made an conscientious effort to decide whether it is really a bug,
  146.       and at the end still aren't sure, then please go ahead and report
  147.       it:  the worst that can happen is that you will waste a bit of
  148.       time for the development team.
  149.     </p>
  150.         <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
  151.           <table border="0" summary="Note">
  152.             <tr>
  153.               <td rowspan="2" align="center" valign="top" width="25">
  154.                 <img alt="[Note]" src="../images/note.png" />
  155.               </td>
  156.               <th align="left">Note</th>
  157.             </tr>
  158.             <tr>
  159.               <td align="left" valign="top">
  160.                 <p>
  161.         Actually there are a few things that are known to cause
  162.         <acronym class="acronym">GIMP</acronym> to
  163.         crash but have turned out to be too inconvenient to be worth
  164.         fixing.  One of them is asking <acronym class="acronym">GIMP</acronym> to do
  165.         something that requires vast amounts of memory, such as creating an
  166.         image one million pixels on a side.
  167.       </p>
  168.               </td>
  169.             </tr>
  170.           </table>
  171.         </div>
  172.         <p>
  173.       You should also make sure that you are using an up-to-date version
  174.       of <acronym class="acronym">GIMP</acronym>: reporting bugs that have already been
  175.       fixed is just a waste of everybody's time.  (<acronym class="acronym">GIMP</acronym> 1
  176.       is no longer maintained, so if you use it and find bugs, either
  177.       upgrade to <acronym class="acronym">GIMP</acronym> 2 or live with
  178.       them.)  Particularly if you are using the development version of
  179.       <acronym class="acronym">GIMP</acronym>, make sure that you can see the bug in the
  180.       latest release before filing a report.
  181.     </p>
  182.         <p>
  183.       If after due consideration you still think you have a legitimate
  184.       bug report or enhancement request, the next step is to go to
  185.       <acronym class="acronym">GIMP</acronym>'s bugzilla query page
  186.       (http://bugzilla.gnome.org/query.cgi),
  187.       and try to see whether somebody else has already reported the same
  188.       thing.  The query page allows you to search the bug database in a
  189.       variety of ways.  Unfortunately this page is a bit more
  190.       complicated to use than it really ought to be, but here is
  191.       basically what you should do:
  192.     </p>
  193.         <div class="variablelist">
  194.           <dl>
  195.             <dt>
  196.               <span class="term">Summary:</span>
  197.             </dt>
  198.             <dd>
  199.               <p>
  200.             Set this to ‚Äú<span class="quote">contains any of the words/strings</span>‚Äù.
  201.           </p>
  202.             </dd>
  203.             <dt>
  204.               <span class="term">(the adjoining entry area)</span>
  205.             </dt>
  206.             <dd>
  207.               <p>
  208.             Give one or more words that somebody would be likely to use in
  209.             writing a one-sentence summary of a bug similar to yours. For
  210.             example, if the problem is that zooming too much causes
  211.             <acronym class="acronym">GIMP</acronym> to
  212.             crash, the word ‚Äú<span class="quote">zoom</span>‚Äù would be good.
  213.           </p>
  214.             </dd>
  215.             <dt>
  216.               <span class="term">Product:</span>
  217.             </dt>
  218.             <dd>
  219.               <p>Set this to ‚Äú<span class="quote">GIMP</span>‚Äù</p>
  220.             </dd>
  221.             <dt>
  222.               <span class="term">Component:, Version:, Target:</span>
  223.             </dt>
  224.             <dd>
  225.               <p>Don't do anything for these.</p>
  226.             </dd>
  227.             <dt>
  228.               <span class="term">Text information:</span>
  229.             </dt>
  230.             <dd>
  231.               <p>
  232.             For now, leave this alone. If your search does not turn up
  233.             anything, it might be worth entering your search terms in the
  234.             ‚Äú<span class="quote">comment</span>‚Äù area here, but this often turns out to
  235.             give you either great masses of stuff or nothing.
  236.           </p>
  237.             </dd>
  238.             <dt>
  239.               <span class="term">Status:</span>
  240.             </dt>
  241.             <dd>
  242.               <p>
  243.             This field encodes the status of a bug report: whether it is still
  244.             open, has been resolved, etc. You want to see all relevant bug
  245.             reports, regardless of status, so you should hold down the mouse
  246.             and sweep it across all entries. Leaving it alone will not work.
  247.           </p>
  248.             </dd>
  249.           </dl>
  250.         </div>
  251.         <p>
  252.       When you have set these things up, click on the ‚Äú<span class="quote">Search</span>‚Äù
  253.       button at
  254.       either the top or bottom; they both do the same thing. The result is
  255.       either a list of bug reports‚Äìhopefully not too long‚Äìor a message saying
  256.       ‚Äú<span class="quote">Zarro boogs found</span>‚Äù. If you don't find a related bug
  257.       report by doing
  258.       this, it may be worth trying another search with different terms. If in
  259.       spite of your best efforts, you file a bug report and it ends up being
  260.       resolved as ‚Äú<span class="quote">Duplicate</span>‚Äù, don't be too upset: it has
  261.       happened repeatedly to the author of this documentation, who works with
  262.       <acronym class="acronym">GIMP</acronym> Bugzilla nearly every day.
  263.     </p>
  264.       </div>
  265.     </div>
  266.     <div class="navfooter">
  267.       <hr />
  268.       <table width="100%" summary="Navigation footer">
  269.         <tr>
  270.           <td width="40%" align="left"><a accesskey="p" href="gimp-introduction-history-2-2.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  271.           <td width="20%" align="center">¬†</td>
  272.           <td width="40%" align="right">¬†<a accesskey="n" href="apbs02.html"><img src="../images/next.png" alt="Next" /></a></td>
  273.         </tr>
  274.         <tr>
  275.           <td width="40%" align="left" valign="top"><a accesskey="p" href="gimp-introduction-history-2-2.html">5.¬†
  276.     <span lang="en" xml:lang="en">What's New in GIMP 2.2?</span>
  277.   </a>¬†</td>
  278.           <td width="20%" align="center">
  279.             <a accesskey="h" href="index.html">
  280.               <img src="../images/home.png" alt="Home" />
  281.             </a>
  282.           </td>
  283.           <td width="40%" align="right" valign="top">¬†<a accesskey="n" href="apbs02.html">2.¬†
  284.       <span lang="en" xml:lang="en">Reporting the Bug</span>
  285.     </a></td>
  286.         </tr>
  287.       </table>
  288.     </div>
  289.   </body>
  290. </html>
  291.