[gimp-help-2] Minor improvements(?) to new filter docs

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

commit 0aff138046ba8fc592ee6a9bee4e31799b651a37
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Wed May 5 20:28:49 2010 +0200

    Minor improvements(?) to new filter docs

 src/concepts/layer-modes.xml             |    4 ++--
 src/filters/artistic/clothify.xml        |    5 ++++-
 src/filters/artistic/weave.xml           |   29 ++++++++++++++++-------------
 src/filters/render/circuit.xml           |   10 ++++++----
 src/filters/render/difference-clouds.xml |   23 +++++++++++++----------
 5 files changed, 41 insertions(+), 30 deletions(-)
---
diff --git a/src/concepts/layer-modes.xml b/src/concepts/layer-modes.xml
index b6f3dea..30ec627 100644
--- a/src/concepts/layer-modes.xml
+++ b/src/concepts/layer-modes.xml
@@ -270,7 +270,7 @@
       </listitem>
     </varlistentry>
 
-    <varlistentry>
+    <varlistentry id="layer-mode-multiply">
       <term>Multiply</term>
       <listitem>
         <indexterm>
@@ -862,7 +862,7 @@
       </listitem>
     </varlistentry>
 
-    <varlistentry>
+    <varlistentry id="layer-mode-difference">
       <term>Difference</term>
       <listitem>
         <indexterm>
diff --git a/src/filters/artistic/clothify.xml b/src/filters/artistic/clothify.xml
index 03d5bd0..571b4e5 100644
--- a/src/filters/artistic/clothify.xml
+++ b/src/filters/artistic/clothify.xml
@@ -34,6 +34,8 @@
     <para>
       <guimenuitem>Clothify</guimenuitem> command is a script which
       adds a cloth-like texture to the selected region or alpha.
+    </para>
+    <para>
       If the image is in indexed colors, this menu entry is grayed out
       and unavailable.
     </para>
@@ -50,7 +52,8 @@
       <step>
         <para>
           Reproduce a layer from the recently added layer and set the mode of
-          the upper layer to <quote>Multiply</quote>.
+          the upper layer to
+          <link linkend="layer-mode-multiply">Multiply</link>.
         </para>
       </step>
       <step>
diff --git a/src/filters/artistic/weave.xml b/src/filters/artistic/weave.xml
index 8a91f1c..e962b2c 100644
--- a/src/filters/artistic/weave.xml
+++ b/src/filters/artistic/weave.xml
@@ -35,13 +35,16 @@
       which creates a new layer filled with a weave effect and adds it to
       the image as an overlay or bump map.  The result of the image looks
       as if it were printed over woven ribbons of paper, thin wooden sheet,
-      or stripped bamboo.  If the image is in indexed colors, this menu
-      entry is grayed out and unavailable.
+      or stripped bamboo.
+    </para>
+    <para>
+      If the image is in indexed colors, this menu entry is grayed out and
+      unavailable.
     </para>
     <para>
       This filter adds a <quote>Multiply</quote> mode layer upon the layer
-      where you activate this command.
-      The weave texture is rendered in gray levels.
+      where you activate this command. The weave texture is rendered in gray
+      levels.
     </para>
   </sect3>
 
@@ -164,21 +167,21 @@
         <caption>
           <para>
             Narrower the ribbon width, wider the ribbon spacing, and
-            filled with the <quote>Wood #1</quote> pattern.
+            filled with the <quote>Wood&nbsp;#1</quote> pattern.
           </para>
         </caption>
       </mediaobject>
     </figure>
     <para>
       This texture can be a lattice that you can see the original image
-      through its mesh holes.  Add a layer over the original image for the
-      lattice, and apply this filter.  Select a black regular square in the
-      texture layer by clicking with the By Color Select Tool, then delete
-      black squares in selection on the texture layer to be chink holes.
-      Reverse the selection, and add layer mask to the lattice layer from
-      the reversed selection.  Activate the upper layer so that you can
-      fill the lattice surface with a pattern, then drag and drop your
-      favorite pattern over the image window.
+      through its mesh holes.  Add a new, transparent layer over the active
+      layer for the lattice, and apply this filter.  Select a black regular
+      square in the texture layer using the
+      <link linkend="gimp-tool-by-color-select">Select By Color</link> tool,
+      then delete black squares in selection on the texture layer to be chink
+      holes.  Reverse the selection, and activate the transparent layer so
+      that you can fill the lattice surface with a pattern, then drag and drop
+      your favorite pattern over the image window.
     </para>
   </sect3>
 </sect2>
diff --git a/src/filters/render/circuit.xml b/src/filters/render/circuit.xml
index f523ab5..8851f29 100644
--- a/src/filters/render/circuit.xml
+++ b/src/filters/render/circuit.xml
@@ -31,10 +31,12 @@
       </mediaobject>
     </figure>
     <para>
-      <guimenuitem>Circuit</guimenuitem> command is a script that fills
-      the selected region (or alpha) with traces like those on a circuit
-      board.  The result looks a little like the back of an old circuit
-      board.  It looks even better when gradmapped with a suitable gradient.
+      <guimenuitem>Circuit</guimenuitem> command is a script that fills the
+      selected region (or alpha) with traces like those on the back of an old
+      circuit board. It looks even better when gradmapped with a suitable
+      gradient.
+    </para>
+    <para>
       If the image is in indexed colors, this menu entry is grayed out
       and unavailable.
     </para>
diff --git a/src/filters/render/difference-clouds.xml b/src/filters/render/difference-clouds.xml
index 1beb586..0e140af 100644
--- a/src/filters/render/difference-clouds.xml
+++ b/src/filters/render/difference-clouds.xml
@@ -31,18 +31,22 @@
       </mediaobject>
     </figure>
 
+    <!-- Difference layer mode:  E:=|I-M| -->
     <para>
-      <guimenuitem>Difference Clouds</guimenuitem> command inverts colors
-      partially as random spots in the image.  This filter renders
+      <guimenuitem>Difference Clouds</guimenuitem> command changes colors
+      partially in cloud-like areas: The filter renders
       <link linkend="plug-in-solid-noise">Solid Noise</link> cloud in an
       automatically created new layer, and sets the layer mode to
-      <quote>Difference</quote>, then merges this layer over the specified
-      image.  If the image is in indexed colors, this menu entry is grayed
-      out and unavailable.
+      <link linkend="layer-mode-difference">Difference</link>,
+      then merges this layer over the specified image.
     </para>
     <para>
-      Before merging the layer, this script opens the dialog of the
-      Solid Noise plug-in which allows to control its effect.
+      Before merging the layer, this script opens the dialog of the Solid
+      Noise plug-in which allows to control its effect.
+    </para>
+    <para>
+      If the image is in indexed colors, this menu entry is grayed out and
+      unavailable.
     </para>
   </sect3>
 
@@ -62,9 +66,8 @@
   <sect3>
     <title>Options</title>
     <para>
-      This script does not have its own dialogs but invokes the
-      <link linkend="plug-in-solid-noise">Solid Noise</link>
-      filter's dialog.
+      This script does not have its own dialog window but invokes the
+      <link linkend="plug-in-solid-noise">Solid Noise</link> filter's dialog.
     </para>
   </sect3>
 </sect2>