[gimp-help] Fix issue#40: improve Posterize

[Julien Hardlin <jhardlin src gnome org>]

commit ea24edfe4889715b97ad53309c2572cb942530dc
Author: Julien Hardelin <jhardlin orange fr>
Date:   Thu May 31 08:26:51 2018 +0200

    Fix issue#40: improve Posterize

 images/C/menus/colors/posterize.png | Bin 19582 -> 17481 bytes
 images/C/toolbox/posterize-ex.png   | Bin 53264 -> 0 bytes
 images/C/toolbox/posterize-ex1.png  | Bin 0 -> 57541 bytes
 images/C/toolbox/posterize-ex2.png  | Bin 0 -> 17033 bytes
 src/menus/colors/posterize.xml      |  52 ++++++++++++++++++++----------------
 5 files changed, 29 insertions(+), 23 deletions(-)
---
diff --git a/images/C/menus/colors/posterize.png b/images/C/menus/colors/posterize.png
index 8b34d54f2..497a07d50 100644
Binary files a/images/C/menus/colors/posterize.png and b/images/C/menus/colors/posterize.png differ
diff --git a/images/C/toolbox/posterize-ex1.png b/images/C/toolbox/posterize-ex1.png
new file mode 100644
index 000000000..1acdecd96
Binary files /dev/null and b/images/C/toolbox/posterize-ex1.png differ
diff --git a/images/C/toolbox/posterize-ex2.png b/images/C/toolbox/posterize-ex2.png
new file mode 100644
index 000000000..d059d1ce8
Binary files /dev/null and b/images/C/toolbox/posterize-ex2.png differ
diff --git a/src/menus/colors/posterize.xml b/src/menus/colors/posterize.xml
index ad9bf80fc..a4620ce1a 100755
--- a/src/menus/colors/posterize.xml
+++ b/src/menus/colors/posterize.xml
@@ -4,12 +4,7 @@
 <!-- section history:
   2017-01-29 Posterize is only in Colors menu now, changed id to plug-in-posterize
   2008-01-28 j.h: added example
-  2007-06-06 kost: added 'no'
-  2007-04-15 Added Spanish translation by AntI
-  2006-02-16 en;fr :Posterize Levels modified by j.h
-  2005-12-06 replaced sect3 by sect3 by lexa
-  2005-12-06 replaced informalfigure by figure by lexa
-  050808 de reviewed and restructured by axel.wernicke
+  2006-02-16 Posterize Levels modified by j.h
   -->
 <sect2 id="gimp-filter-posterize">
   <title>Posterize</title>
@@ -50,12 +45,16 @@
       <varlistentry>
         <term>Posterize Levels</term>
         <listitem>
+          <para>
+            Here, <quote>level</quote> means <quote>number of colors per channel
+            </quote>.
+          </para>
           <para>
             This slider and the input boxes with arrow-heads allow you
             to set the number of levels (2-256) in each RGB channel that
-            the tool will use to describe the active layer. The total number
-            of colors is the combination of these levels. A level to 3
-            will give 2<superscript>3</superscript> = 8 colors.
+            the tool will use to describe the active layer. The maximum total 
+            number of colors is the combination of these levels. A level to 3
+            will give 3<superscript>3</superscript> = 27 colors.
           </para>
         </listitem>
       </varlistentry>
@@ -73,19 +72,26 @@
 
   <sect3>
     <title>Example</title>
-    <figure>
-      <title>Example for the <quote>Posterize</quote> tool</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref="images/toolbox/posterize-ex.png" format="PNG"/>
-        </imageobject>
-        <caption>
-          <para>
-            Image posterized in 4 levels. The histogram shows the 4 levels
-            and 10 colors, counting black and white also.
-          </para>
-        </caption>
-      </mediaobject>
-    </figure>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/toolbox/posterize-ex1.png" format="PNG"/>
+      </imageobject>
+      <caption>
+        <para>
+          Original image. The Colorcube Analysis shows a great number of colors.
+        </para>
+      </caption>
+    </mediaobject>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/toolbox/posterize-ex2.png" format="PNG"/>
+      </imageobject>
+      <caption>
+        <para>
+          Original image posterized in 3 levels. The Colorcube Analysis shows 
+          11 colors (less than the possible number 27).
+        </para>
+      </caption>
+    </mediaobject>
   </sect3>
 </sect2>