[gimp-help-2] Minor changes to filter docs



commit 7d7d7297995b77273897a9bf1f3569b3180b3fa8
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Fri Apr 23 20:12:24 2010 +0200

    Minor changes to filter docs
    
    * Bugfix: include "Weave" filter in artistic.xml.
    * Sort "Artistic" and "Render" filters according to GIMP's submenus.
    * Use <procedure> for describing a procedure ;-)
      (and use imperative rather than infinitive for consistency reason).
    * Fix some minor spelling errors etc.

 src/filters/artistic.xml                 |   14 ++++---
 src/filters/artistic/clothify.xml        |   62 ++++++++++++++---------------
 src/filters/artistic/weave.xml           |    2 +-
 src/filters/render.xml                   |   18 +++++++--
 src/filters/render/difference-clouds.xml |    6 +-
 5 files changed, 56 insertions(+), 46 deletions(-)
---
diff --git a/src/filters/artistic.xml b/src/filters/artistic.xml
index 063904c..9473a31 100644
--- a/src/filters/artistic.xml
+++ b/src/filters/artistic.xml
@@ -4,21 +4,23 @@
 <!-- section history:
   2007-08-08 ude: moved Van Gogh (LIC) from map filters
   2007-04-28 KoSt: added 'no'
-  050903 de added by axel.wernicke
+  2005-09-03 de added by axel.wernicke
 -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-artistic">
   <title>Artistic Filters</title>
   <xi:include href="artistic/introduction.xml"/>
+  <xi:include href="artistic/applycanvas.xml"/>
   <xi:include href="artistic/cartoon.xml"/>
   <xi:include href="artistic/clothify.xml"/>
-  <xi:include href="artistic/photocopy.xml"/>
+  <xi:include href="artistic/cubism.xml"/>
   <xi:include href="artistic/GIMPressionist.xml"/>
+  <!-- TODO: check: shouldn't GIMPressionist include orientmap & sizemap? -->
   <xi:include href="artistic/GIMPressionist-orientmap.xml"/>
   <xi:include href="artistic/GIMPressionist-sizemap.xml"/>
-  <xi:include href="artistic/cubism.xml"/>
-  <xi:include href="artistic/applycanvas.xml"/>
+  <xi:include href="artistic/oilify.xml"/>
+  <xi:include href="artistic/photocopy.xml"/>
   <xi:include href="artistic/predator.xml"/>
-  <xi:include href="artistic/vangogh-lic.xml"/>
   <xi:include href="artistic/softglow.xml"/>
-  <xi:include href="artistic/oilify.xml"/>
+  <xi:include href="artistic/vangogh-lic.xml"/>
+  <xi:include href="artistic/weave.xml"/>
 </sect1>
diff --git a/src/filters/artistic/clothify.xml b/src/filters/artistic/clothify.xml
index 5ab8b8e..f48adf8 100644
--- a/src/filters/artistic/clothify.xml
+++ b/src/filters/artistic/clothify.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2010-01-26 liangtai: created initial version
+  2010-04-21 liangtai: created initial version
 -->
 <sect2 id="script-fu-clothify">
   <title>Clothify</title>
@@ -38,49 +38,47 @@
       and unavailable.
     </para>
     <para>
-      This script is achieved by the following steps.
+      This effect is achieved by the following steps:
     </para>
-    <orderedlist>
-      <listitem>
+    <procedure>
+      <step>
         <para>
-          Creating an image in the same size as the original image,
-          or selection or region in alpha if it is given, then adds a
-          layer to this image filled with white and
+          Create an image in the same size as the original image, or selection
+          or region in alpha if it is given, then add a layer to this image
+          filled with white and
           <link linkend="plug-in-rgb-noise">noisified</link> strongly.
         </para>
-      </listitem>
-      <listitem>
+      </step>
+      <step>
         <para>
-          Reproducing a layer from the recently added layer and set
-          the mode of the upper layer to <quote>Multiply</quote>.
+          Reproduce a layer from the recently added layer and set the mode of
+          the upper layer to <quote>Multiply</quote>.
         </para>
-      </listitem>
-      <listitem>
+      </step>
+      <step>
         <para>
-          Applying
-          <link linkend="plug-in-gauss">Gaussian blur</link> in
-          different directions, horizontally on the lower layer by the
-          given parameter <guilabel>Blur X</guilabel> as the radius, and
-          vertically on the upper layer with <guilabel>Blur Y</guilabel>.
+          Apply <link linkend="plug-in-gauss">Gaussian blur</link> in
+          different directions, horizontally on the lower layer by the given
+          parameter <guilabel>Blur X</guilabel> as the radius, and vertically
+          on the upper layer with <guilabel>Blur Y</guilabel>.
         </para>
-      </listitem>
-      <listitem>
+      </step>
+      <step>
         <para>
-          Merging these two layers into an image and making its contrast
-          <link linkend="plug-in-c-astretch">expanded as possibly</link>,
-          then slightly noisifying again on this working image.
+          Merge these two layers into an image and make its contrast
+          <link linkend="plug-in-c-astretch">expanded as possibly</link>, then
+          slightly noisify again on this working image.
         </para>
-      </listitem>
-      <listitem>
+      </step>
+      <step>
         <para>
-          Finally doing
-          <link linkend="plug-in-bump-map">bump map</link> on the original
-          image by the working image with parameters
-          <guilabel>Azimuth</guilabel>, <guilabel>Elevation</guilabel>,
-          and <guilabel>Depth</guilabel>.
+          Finally do <link linkend="plug-in-bump-map">bump map</link> on the
+          original image by the working image with parameters
+          <guilabel>Azimuth</guilabel>, <guilabel>Elevation</guilabel>, and
+          <guilabel>Depth</guilabel>.
         </para>
-      </listitem>
-    </orderedlist>
+      </step>
+    </procedure>
   </sect3>
 
   <sect3>
diff --git a/src/filters/artistic/weave.xml b/src/filters/artistic/weave.xml
index c1b7daf..fecf6fe 100644
--- a/src/filters/artistic/weave.xml
+++ b/src/filters/artistic/weave.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2010-02-23 liangtai: created initial version
+  2010-04-21 liangtai: created initial version
 -->
 <sect2 id="script-fu-weave">
   <title>Weave</title>
diff --git a/src/filters/render.xml b/src/filters/render.xml
index 81f1304..9188029 100644
--- a/src/filters/render.xml
+++ b/src/filters/render.xml
@@ -9,20 +9,30 @@
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-render">
   <title>Rendering Filters</title>
   <xi:include href="render/introduction.xml"/>
+  <!-- Clouds -->
+  <xi:include href="render/difference-clouds.xml"/>
+  <!--TODO xi:include href="render/fog.xml"/-->
   <xi:include href="render/plasma.xml"/>
   <xi:include href="render/solid_noise.xml"/>
-  <xi:include href="render/difference-clouds.xml"/>
+  <!-- Nature -->
   <xi:include href="render/flame.xml"/>
   <xi:include href="render/ifsfractal.xml"/>
-  <xi:include href="render/diffraction.xml"/>
+  <!-- Pattern -->
+  <xi:include href="render/checkerboard.xml"/>
   <xi:include href="render/cmlexplorer.xml"/>
+  <xi:include href="render/diffraction.xml"/>
   <xi:include href="render/grid.xml"/>
-  <xi:include href="render/maze.xml"/>
   <xi:include href="render/jigsaw.xml"/>
+  <xi:include href="render/maze.xml"/>
   <xi:include href="render/qbist.xml"/>
-  <xi:include href="render/checkerboard.xml"/>
   <xi:include href="render/sinus.xml"/>
+  <!-- -->
+  <!--TODO xi:include href="render/cd-label.xml"/-->
+  <!--TODO xi:include href="render/circuit.xml"/-->
   <xi:include href="render/fractalexplorer.xml"/>
   <xi:include href="render/gfig.xml"/>
+  <!--TODO xi:include href="render/lava.xml"/-->
+  <!--TODO xi:include href="render/line-nova.xml"/-->
   <xi:include href="render/spheredesigner.xml"/>
+  <!--TODO xi:include href="render/spyrogimp.xml"/-->
 </sect1>
diff --git a/src/filters/render/difference-clouds.xml b/src/filters/render/difference-clouds.xml
index 0dc06e6..1beb586 100644
--- a/src/filters/render/difference-clouds.xml
+++ b/src/filters/render/difference-clouds.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2010-01-22 liangtai: created initial version
+  2010-04-21 liangtai: created initial version
 -->
 <sect2 id="script-fu-difference-clouds">
   <title>Difference Clouds</title>
@@ -26,14 +26,14 @@
             fileref="images/filters/examples/render-taj-diffcloud.jpg"/>
         </imageobject>
         <caption>
-          <para>Filter <quote>Differnce Clouds</quote> applied</para>
+          <para>Filter <quote>Difference Clouds</quote> applied</para>
         </caption>
       </mediaobject>
     </figure>
 
     <para>
       <guimenuitem>Difference Clouds</guimenuitem> command inverts colors
-      partially as random spots in the image.  This is a script renders
+      partially as random spots in the image.  This 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



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]