[gimp-help-2] Fix description for despeckle filter

[Mikael Magnusson <mikachu src gnome org>]

commit fb65a46daee645d704423ee5613820ef53f433dd
Author: Mikael Magnusson <mikachu gmail com>
Date:   Sun Oct 9 16:25:17 2011 +0200

    Fix description for despeckle filter

 src/filters/enhance/despeckle.xml |   24 ++++++++++++------------
 1 files changed, 12 insertions(+), 12 deletions(-)
---
diff --git a/src/filters/enhance/despeckle.xml b/src/filters/enhance/despeckle.xml
index 36af8cf..2ed1c6f 100644
--- a/src/filters/enhance/despeckle.xml
+++ b/src/filters/enhance/despeckle.xml
@@ -17,10 +17,12 @@
   <sect3>
     <title>Overview</title>
     <para>
-      It is used to remove small defects due to dust, or scratches, on a
-      scanned image, and also moirà effect on image scanned from a magazine.
-      You ought to select isolated defects before applying this filter, in
-      order to avoid unwanted changes in other areas of your image.
+      This filter is used to remove small defects due to dust, or scratches,
+      on a scanned image, and also moirà effects on image scanned from a
+      magazine.  You should select isolated defects before applying this
+      filter, in order to avoid unwanted changes in other areas of your image.
+      The filter replaces each pixel with the median value of the pixels within
+      the specified radius.
     </para>
   </sect3>
 
@@ -65,10 +67,10 @@
               <term><guilabel>Adaptive</guilabel></term>
               <listitem>
                 <para>
-                  Adapts radius to image or selection content (using
-                  Histogram). If this option is checked, radius slider is not
-                  efficient. It renders a result smoother than with radius
-                  alone.
+                  Adapts the radius to image or selection content by
+                  analyzing the histogram of the region around the target
+                  pixel. The adapted radius will always be equal to or
+                  smaller than the specified radius.
                 </para>
               </listitem>
             </varlistentry>
@@ -95,19 +97,17 @@
       </varlistentry>
       <varlistentry>
         <term>Black level</term>
-        <!-- TODO: check range (-1-255) -->
         <listitem>
           <para>
-            Removes pixels darker than set value (0-255).
+            Only include pixels brighter than the set value in the histogram (-1-255).
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>White level</term>
-        <!-- TODO: check range (0-256) -->
         <listitem>
           <para>
-            Removes pixels whiter than set value (0-255).
+            Only include pixels darker than the set value in the histogram (0-256).
           </para>
         </listitem>
       </varlistentry>