[gimp-help-2] Add Fog (Render) filter

[Ulf-D. Ehlert <ulfehlert src gnome org>]

commit a00586b679b0a512850604c445b79df8edbdb67b
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Mon Nov 29 20:03:32 2010 +0100

    Add Fog (Render) filter

 src/filters/render/fog.xml |   34 +++++++++++++++++++---------------
 1 files changed, 19 insertions(+), 15 deletions(-)
---
diff --git a/src/filters/render/fog.xml b/src/filters/render/fog.xml
index 9c2237a..20384a1 100644
--- a/src/filters/render/fog.xml
+++ b/src/filters/render/fog.xml
@@ -38,10 +38,9 @@
     </figure>
 
     <para>
-      <!--
-        Describe what the filter does, which algorithms it uses.
-        Give the user an idea what to use the filter for
-       -->
+      This filter adds a new layer with some clouds to the image that look
+      like fog or smoke. The clouds are created with the
+      <link linkend="plug-in-plasma">Plasma</link> texture.
     </para>
   </sect3>
 
@@ -61,13 +60,6 @@
 
   <sect3>
     <title>Options</title>
-    <para>
-      <!--
-        Describe how the filter options are organized in general.
-        This part is optional, but helps if the filter options dialog is a bit
-        more complex e.g. has some tabs etc.
-       -->
-    </para>
     <figure>
       <title><quote>Fog</quote> options</title>
       <mediaobject>
@@ -79,11 +71,17 @@
     </figure>
 
     <variablelist>
+      <para>
+        Among the few filter options, only <quote>Turbulence</quote> is
+        somewhat important, because you can't change it later and have to undo
+        and repeat the filter if the result doesn't fit your desire.
+      </para>
       <varlistentry>
         <term>Layer name</term>
         <listitem>
           <para>
-            TODO
+            The name of the layer. You can change it later in the
+            <link linkend="gimp-layer-attributes">Layers Dialog</link>.
           </para>
         </listitem>
       </varlistentry>
@@ -91,7 +89,9 @@
         <term>Fog color</term>
         <listitem>
           <para>
-            TODO
+            Defaults to some kind of sandy brown (240, 180, 70). Click on the
+            color button to change this if you think that is not the natural
+            color of fog.
           </para>
         </listitem>
       </varlistentry>
@@ -99,7 +99,10 @@
         <term>Turbulence</term>
         <listitem>
           <para>
-            TODO
+            This is actually the Turbulence option of the
+            <link linkend="plug-in-plasma">Plasma</link> filter: it controls
+            the complexity of the clouds, from soft (low values) to hard (high
+            values).
           </para>
         </listitem>
       </varlistentry>
@@ -107,7 +110,8 @@
         <term>Opacity</term>
         <listitem>
           <para>
-            TODO
+            The opacity of the layer. You can change it later in the <link
+            linkend="gimp-layer-dialog-opacity-scale">Layers Dialog</link>.
           </para>
         </listitem>
       </varlistentry>