[gimp-help] Update mosaic filter

[Julien Hardlin <jhardlin src gnome org>]

commit b95364fee7a9fa2f0783d67447190d01b8c73679
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Dec 23 07:18:21 2018 +0100

    Update mosaic filter

 images/C/filters/distort/mosaic-dialog.png | Bin 0 -> 44157 bytes
 images/C/filters/distort/mosaic.png        | Bin 36890 -> 0 bytes
 src/filters/distort/mosaic.xml             | 106 ++++++++++++++---------------
 3 files changed, 52 insertions(+), 54 deletions(-)
---
diff --git a/images/C/filters/distort/mosaic-dialog.png b/images/C/filters/distort/mosaic-dialog.png
new file mode 100644
index 000000000..bee1ae86b
Binary files /dev/null and b/images/C/filters/distort/mosaic-dialog.png differ
diff --git a/src/filters/distort/mosaic.xml b/src/filters/distort/mosaic.xml
index 019380514..86a142661 100644
--- a/src/filters/distort/mosaic.xml
+++ b/src/filters/distort/mosaic.xml
@@ -2,10 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-08-13 Added Spanish translation by AntI
-  2007-04-24 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050905 de added by axel.wernicke
+  2018-12-22 j.h: update to v2.10
 -->
 <sect2 id="gimp-filter-mosaic">
   <title>Mosaic</title>
@@ -68,29 +65,23 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/distort/mosaic.png"/>
+            fileref="images/filters/distort/mosaic-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel></term>
         <listitem>
-          <!-- changed 2010-05-17 ude: looks like just the opposite is true...
-            Note that the preview displays the whole image, even if the final
-            result will concern a selection.
-          -->
           <para>
-            All your setting changes will appear in the Preview without
-            affecting the image until you click on <guilabel>OK</guilabel>.
-            Note that the preview displays only a part of the whole image if
-            the filter is applied to an selection. Don't keep
-            <guilabel>Preview</guilabel> checked if your computer is too slow.
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Tiling primitives</term>
+        <term>Tile geometry</term>
         <listitem>
           <para>
             This option is self-understanding:
@@ -99,7 +90,7 @@
             <varlistentry>
               <term><guilabel>Squares</guilabel></term>
               <listitem>
-                <para>4 edges</para>
+                <para>Not exactly squares, but 4 edges</para>
               </listitem>
             </varlistentry>
             <varlistentry>
@@ -109,10 +100,9 @@
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term><guilabel>Octagons &amp; squares</guilabel></term>
+              <term><guilabel>Octagons</guilabel></term>
               <listitem>
-                <!--TODO: check: it looks like "squares" is a lie-->
-                <para>8 or 4 edges (octa = 8)</para>
+                <para>8 edges (octa = 8)</para>
               </listitem>
             </varlistentry>
             <varlistentry>
@@ -128,8 +118,8 @@
         <term>Tile size</term>
         <listitem>
           <para>
-            Slider and input box allow you to set the size of tile
-            surface.
+            Average diameter of each tile (in pixels). Slider and input box 
+            allow you to set the size of tile surface (2-1000).
           </para>
         </listitem>
       </varlistentry>
@@ -143,87 +133,95 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Tile spacing</term>
+        <term>Tile neatness</term>
         <listitem>
           <para>
-            That's width of the join between tiles.
+            When set to 1, most of tiles have the same size. With 0
+            value, size is determined at random and this may lead to
+            shape variation.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Tile neatness</term>
+        <term>Tile color variation</term>
         <listitem>
           <para>
-            When set to 1, most of tiles have the same size. With 0
-            value, size is determined at random and this may lead to
-            shape variation.
+            Each tile has only one color. So the number of colors is reduced,
+            compared to the original image. Here you can increase the number
+            of colors a little.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Light direction</term>
+        <term>Color averaging</term>
         <listitem>
           <para>
-            By default light comes from the upper left corner
-            (135°). You can change this direction from 0 to 360
-            (counter clockwise).
+            When this option is unchecked, the image drawing can be
+            recognized inside tiles.  When checked, the colors inside
+            tiles are averaged into a single color.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Color variation</term>
+        <term>Rough tile surface</term>
         <listitem>
           <para>
-            Each tile has only one color. So the number of colors is reduced,
-            compared to the original image. Here you can increase the number
-            of colors a little.
+            With this option tile surface looks pitted.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Antialiasing</term>
+        <term>Allow splitting tiles</term>
         <listitem>
           <para>
-            This option reduces the stepped aspect that may have
-            borders.
+            This option splits tiles in areas with many colors, and
+            so allows a better color gradation and more details in
+            these areas.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Color averaging</term>
+        <term>Tile spacing</term>
         <listitem>
           <para>
-            When this option is unchecked, the image drawing can be
-            recognized inside tiles.  When checked, the colors inside
-            tiles are averaged into a single color.
+            That's width of the join between tiles.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Allow tile splitting</term>
+        <term>Joints/Light color</term>
         <listitem>
           <para>
-            This option splits tiles in areas with many colors, and
-            so allows a better color gradation and more details in
-            these areas.
+            Tiles are lit with the foreground color of the toolbox, and shadow 
+            is colored with the background color. Joins have the background 
+            color. You can change these colors using the color dwells or the 
+            color pickers on the right.
           </para>
-        </listitem>
+          </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Pitted surfaces</term>
+        <term>Light direction</term>
         <listitem>
           <para>
-            With this option tile surface looks pitted.
+            By default light comes from the upper left corner
+            (135°). You can change this direction from 0 to 360.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>FG/BG lighting</term>
+        <term>Antialiasing</term>
+        <listitem>
+          <para>
+            This option reduces the stepped aspect that may have
+            borders.
+          </para>
+        </listitem>
+      </varlistentry>
+       <varlistentry>
+        <term>Random seed</term>
         <listitem>
           <para>
-            When this option is checked, tiles are lit by the
-            foreground color of the toolbox, and shadow is colored by
-            the background color.  Joins have the background color.
+            TODO
           </para>
         </listitem>
       </varlistentry>