gimp-help-2 r2797 - in trunk: . po/de/filters src/appendix src/filters/render



Author: ulfehlert
Date: Fri Mar 27 19:07:30 2009
New Revision: 2797
URL: http://svn.gnome.org/viewvc/gimp-help-2?rev=2797&view=rev

Log:
2009-03-27  Ulf-D. Ehlert  <ulfehlert svn gnome org>

	* src/appendix/bibliography.xml
	* src/filters/render/cmlexplorer.xml
	* src/filters/render/diffraction.xml
	* src/filters/render/flame.xml
	* src/filters/render/fractalexplorer.xml
	* src/filters/render/grid.xml
	* src/filters/render/ifsfractal.xml
	* src/filters/render/jigsaw.xml
	* src/filters/render/maze.xml
	* src/filters/render/plasma.xml
	* src/filters/render/qbist.xml
	* src/filters/render/sinus.xml
	* src/filters/render/solid_noise.xml: minor changes, mostly
	standardizations

	* po/de/filters/artistic.po
	* po/de/filters/render.po: updated


Modified:
   trunk/ChangeLog
   trunk/po/de/filters/artistic.po
   trunk/po/de/filters/render.po
   trunk/src/appendix/bibliography.xml
   trunk/src/filters/render/cmlexplorer.xml
   trunk/src/filters/render/diffraction.xml
   trunk/src/filters/render/flame.xml
   trunk/src/filters/render/fractalexplorer.xml
   trunk/src/filters/render/grid.xml
   trunk/src/filters/render/ifsfractal.xml
   trunk/src/filters/render/jigsaw.xml
   trunk/src/filters/render/maze.xml
   trunk/src/filters/render/plasma.xml
   trunk/src/filters/render/qbist.xml
   trunk/src/filters/render/sinus.xml
   trunk/src/filters/render/solid_noise.xml

Modified: trunk/src/appendix/bibliography.xml
==============================================================================
--- trunk/src/appendix/bibliography.xml	(original)
+++ trunk/src/appendix/bibliography.xml	Fri Mar 27 19:07:30 2009
@@ -627,6 +627,15 @@
         </ulink>
       </releaseinfo>
     </biblioentry>
+    <biblioentry id="bibliography-online-wkpd-cellular-automata">
+      <abbrev>WKPD-CA</abbrev>
+      <title>Wikipedia - Cellular Automata</title>
+      <releaseinfo>
+        <ulink url="http://en.wikipedia.org/wiki/Bump_Mapping";>
+          http://en.wikipedia.org/wiki/Cellular_Automata
+        </ulink>
+      </releaseinfo>
+    </biblioentry>
     <biblioentry id="bibliography-online-wkpd-cmyk">
       <abbrev>WKPD-CMYK</abbrev>
       <title>Wikipedia - CMYK</title>

Modified: trunk/src/filters/render/cmlexplorer.xml
==============================================================================
--- trunk/src/filters/render/cmlexplorer.xml	(original)
+++ trunk/src/filters/render/cmlexplorer.xml	Fri Mar 27 19:07:30 2009
@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2009-03-27 ude: use <simplesect> (rather than nested <variablelist>)
+             for option tabs
   2007-11-04 AntI: Added "es"
   2007-05-16 KoSt: added 'no'
   2005-12-07 replaced <simplesect> by <sect3> by lexa
@@ -8,18 +11,8 @@
   2005/09/21 created by axel.wernicke
 -->
 <sect2 id="plug-in-cml-explorer">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>CML Explorer</phrase>
-  </title>
+  <title>CML Explorer</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -28,19 +21,15 @@
   <indexterm>
     <primary>CML Explorer</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>
-          Example for the <quote>CML Explorer</quote> filter
-        </phrase>
-      </title>
+      <title>Example for the <quote>CML Explorer</quote> filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-cmlexplorer.jpg" format="JPG"/>
+          <imagedata  format="JPG"
+            fileref="images/filters/examples/render-taj-cmlexplorer.jpg"/>
         </imageobject>
         <caption>
           <para>
@@ -52,469 +41,449 @@
     <para>
       This filter is the king of texture creating filters. It is extremely
       efficient but very complex. It uses a mathematical method named Cellular
-      Automata.
-      <ulink url="http://en.wikipedia.org/wiki/Cellular_Automata";>
-        cellular_automata
-      </ulink>.
+      Automata <xref linkend="bibliography-online-wkpd-cellular-automata"/>.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Starting filter</phrase>
-    </title>
+    <title>Activating the filter</title>
     <para>
       You can find this filter from the image menu through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>CML Explorer</guimenuitem></menuchoice>
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>CML Explorer</guimenuitem>
+      </menuchoice>.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
-    <variablelist>
-      <varlistentry>
-        <term>General Options</term>
-        <listitem>
-          <figure>
-            <title>
-              <phrase><quote>CML Explorer</quote> filter options(Hue)
-              </phrase>
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata fileref="images/filters/options-render-cmlexplorer1.png" format="PNG"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            Filter options are distributed among
-            <guilabel>Hue</guilabel>,<guilabel>Saturation</guilabel>,
-            <guilabel>Value</guilabel>, <guilabel>Advanced</guilabel>,
-            <guilabel>others</guilabel> and <guilabel>Misc.ops</guilabel>
-            tabs.  Some more options are available. They will be described
-            in following section.
-          </para>
-          <variablelist>
-            <varlistentry>
-              <term>Preview</term>
-              <listitem>
-                <para>
-                  This filter offers you a Preview where you can see the
-                  result of your settings before they are applied to the
-                  image.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>
-                New seed; Fix seed; Random seed
-              </term>
-              <listitem>
-                <para>
-                  Random plays a large part in creating patterns. With these
-                  options, you can influence the way random is generated. By
-                  clicking on the <guibutton>New seed</guibutton> button, you
-                  can force random to use a new source of random. The preview
-                  will show you the result.
-                  <guibutton>Fix seed</guibutton> lets you keep the same seed
-                  and so to reproduce the same effect with the filter.
-                  <guibutton>Random seed</guibutton> generates a random seed
-                  at random.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Open; Save</term>
-              <listitem>
-                <para>
-                  With these both command buttons you can save pattern
-                  settings in a file, and to get them back later.
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Hue tab</term>
-        <listitem>
-          <para>
-            This filter works in the <link linkend="glossary-hsv">HSV</link> color model. In this tab, you
-            can set options for Hue.
-          </para>
-          <variablelist>
-            <varlistentry>
-              <term>Function type</term>
-              <listitem>
-                <para>
-                  In this drop-down list, you can select the method that
-                  will be used to treat the current layer. These methods
-                  are:
-                </para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Keep image's values</guilabel>: With this
-                      option, image hue values will be kept.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Keep the first value</guilabel>: With this
-                      option, starting color will be standard cyan.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Fill with k parameter</guilabel>,
-                      <guilabel>k{x(1-x)}^p</guilabel>,
-                      <guilabel>k{x(1-x)}^p stepped</guilabel>,
-                      <guilabel>kx^p</guilabel>,
-                      <guilabel>kx^p stepped</guilabel>,
-                      <guilabel>k(1-x^p)</guilabel>,
-                      <guilabel>k(1-x^p) stepped</guilabel>: pattern look
-                      will depend on <parameter>k</parameter> that you will
-                      set later in options.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Delta function</guilabel>,
-                      <guilabel>Delta function stepped</guilabel>: FIXME
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>sin^p based Function</guilabel>,
-                      <guilabel>sin^p stepped</guilabel>: These options
-                      create wave-like patterns, like aurora borealis or
-                      curtain folds.
-                    </para>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Composition</term>
-              <listitem>
-                <para>
-                  Here, these options concern Hue. You can select:
-                </para>
-                <para><guilabel>None</guilabel>, <guilabel>Max(x, -)</guilabel>,
-                  <guilabel>Max(x+d, -)</guilabel>,
-                  <guilabel>Max(x-d, -)</guilabel>,
-                  <guilabel>Min(x, -)</guilabel>,
-                  <guilabel>Min(x+d, -)</guilabel>,
-                  <guilabel>Min(x-d, -)</guilabel>,
-                  <guilabel>Max(x+d, -), (x &lt; 0,5)</guilabel>,
-                  <guilabel>Max(x+d, -), (0,5 &lt; x)</guilabel>,
-                  <guilabel>Max(x-d, -), (x &lt; 0,5)</guilabel>,
-                  <guilabel>Max(x-d, -), (0,5 &lt; x)</guilabel>,
-                  <guilabel>Min(x+d, -), (x &lt; 0,5)</guilabel>,
-                  <guilabel>Min(x+d, -), (0,5 &lt; x)</guilabel>,
-                  <guilabel>Min(x-d, -), (x &lt; 0,5)</guilabel> and
-                  <guilabel>Min(x-d, -), (0,5 &lt; x)</guilabel>.
-                </para>
-                <para>
-                  A book could be filled with results of all these
-                  functions. Please, experiment!
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Misc. Arrange</term>
-              <listitem>
-                <para>
-                  This drop-down list offers you some other parameters:
-                </para>
-                <para><guilabel>Standard</guilabel>,
-                  <guilabel>Use average value</guilabel>,
-                  <guilabel>Use reverse value</guilabel>,
-                  <guilabel>With random power (0,10)</guilabel>,
-                  <guilabel>With random power (0,1)</guilabel>,
-                  <guilabel>with gradient power (0,1)</guilabel>,
-                  <guilabel>Multiply rand. value (0,1)</guilabel>,
-                  <guilabel>Multiply rand. value (0,2)</guilabel>,
-                  <guilabel>Multiply gradient (0,1)</guilabel> and
-                  <guilabel>With p and random (0,1)</guilabel>.
-                </para>
-                <para>
-                  Also a book would be necessary to explain all
-                  possibilities of these parameters.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Use cyclic range</term>
-              <listitem>
-                <para>
-                  //TODO
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Mod. rate</term>
-              <listitem>
-                <para>
-                  With this slider and the input box, you can set
-                  modification rate from 0.0 to 1.0. Low value results in a
-                  lined pattern.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Env. sensitivity</term>
-              <listitem>
-                <para>
-                  Value is from 0.0 to 1.0
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Diffusion dist.</term>
-              <listitem>
-                <para>
-                  Diffusion distance: from 2 to 10.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term># of subranges</term>
-              <listitem>
-                <para>
-                  Number of sub-rangers: from 1 to 10.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>(P)ower factor</term>
-              <listitem>
-                <para>
-                  With this option you can influence the
-                  <guilabel>Function types</guilabel> using the
-                  <parameter>p</parameter> parameter. Value from 0.0 to 10.0.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>k Parameter</term>
-              <listitem>
-                <para>
-                  With this option you can influence the
-                  <guilabel>Function types</guilabel> using the
-                  <parameter>k</parameter> parameter. Value from 0.0 to 10.0.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Range low</term>
-              <listitem>
-                <para>
-                  Set lower limit of hue that will be used for calculation.
-                  values vary from 0.0 to 1.0.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Range high</term>
-              <listitem>
-                <para>
-                  Set the upper limit of hue that will be used for
-                  calculation. Variations are from 0.0 to 1.0.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Plot a graph of the settings</term>
-              <listitem>
-                <para>
-                  By clicking on this large button, you can open a window
-                  that displays the graph of hue present settings.
-                </para>
-                <figure>
-                  <title>
-                    <phrase>
-                      Function graph of present settings
-                    </phrase>
-                  </title>
-                  <mediaobject>
-                    <imageobject>
-                      <imagedata fileref="images/filters/options-render-cmlexplorer1a.png" format="PNG"/>
-                    </imageobject>
-                  </mediaobject>
-                </figure>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Saturation tab</term>
-        <listitem>
-          <figure>
-            <title>
-              <phrase><quote>CML Explorer</quote> filter options(Saturation)
-              </phrase>
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata fileref="images/filters/options-render-cmlexplorer2.png" format="PNG"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            In this tab, you can set how Saturation component of the HSV
-            color model will be used in pattern calculation.
-          </para>
-          <para>
-            These options are similar to Hue tab options.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Value tab</term>
-        <listitem>
-          <figure>
-            <title>
-              <phrase><quote>CML Explorer</quote> filter options (Value)
-              </phrase>
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata fileref="images/filters/options-render-cmlexplorer3.png" format="PNG"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            In this tab, you can set how the Value (Luminosity) component of
-            the HSV color model will be used in pattern calculation.
-          </para>
-          <para>
-            These options are similar to Hue tab options.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Advanced tab</term>
-        <listitem>
-          <figure>
-            <title>
-              <phrase><quote>CML Explorer</quote> filter options (Advanced)
-              </phrase>
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata fileref="images/filters/options-render-cmlexplorer4.png" format="PNG"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            These tab settings apply to the three HSV channels.
-          </para>
-          <variablelist>
-            <varlistentry>
-              <term>Channel Sensitivity</term>
-              <listitem>
-                <para>// TODO</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Mutation rate</term>
-              <listitem>
-                <para>// TODO</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Mutation distance</term>
-              <listitem>
-                <para>//TODO</para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Others tab</term>
-        <listitem>
-          <figure>
-            <title>
-              <phrase><quote>CML Explorer</quote> filter options (Others)
-              </phrase>
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata fileref="images/filters/options-render-cmlexplorer5.png" format="PNG"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            In this tab, you can find various parameters about image display
-            and random intervention.
-          </para>
-          <variablelist>
-            <varlistentry>
-              <term>Initial value</term>
-              <listitem>
-                <para>// TODO</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Zoom factor</term>
-              <listitem>
-                <para>// TODO</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Start offset</term>
-              <listitem>
-                <para>// TODO</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Seed of random</term>
-              <listitem>
-                <para>// TODO</para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Miscellaneous options tab</term>
-        <listitem>
-          <figure>
-            <title>
-              <phrase><quote>CML Explorer</quote> filter options (Misc.ops)
-              </phrase>
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata fileref="images/filters/options-render-cmlexplorer6.png" format="PNG"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            In this tab you can find various options about copy and loading.
-          </para>
-          <variablelist>
-            <varlistentry>
-              <term>Copy settings</term>
-              <listitem>
-                <para>
-                  These options allow you to transfer information from
-                  one of the HSV channel to another one.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Selective load setting</term>
-              <listitem>
-                <para>
-                  With the <guibutton>Open</guibutton> button of this
-                  filter,  you can load previously loaded settings. If you
-                  don't want to load all of them, you can select a source
-                  and a destination channel here.
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-    </variablelist>
+    <title>Options</title>
+
+    <simplesect>
+      <title>General Options</title>
+      <para>
+        Filter options are distributed among
+        <guilabel>Hue</guilabel>,<guilabel>Saturation</guilabel>,
+        <guilabel>Value</guilabel>, <guilabel>Advanced</guilabel>,
+        <guilabel>others</guilabel> and <guilabel>Misc.ops</guilabel>
+        tabs.  Some more options are available. They will be described
+        in following section.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>Preview</term>
+          <listitem>
+            <para>
+              This filter offers you a Preview where you can see the
+              result of your settings before they are applied to the
+              image.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>New seed; Fix seed; Random seed</term>
+          <listitem>
+            <para>
+              Random plays a large part in creating patterns. With these
+              options, you can influence the way random is generated. By
+              clicking on the <guibutton>New seed</guibutton> button, you
+              can force random to use a new source of random. The preview
+              will show you the result.
+              <guibutton>Fix seed</guibutton> lets you keep the same seed
+              and so to reproduce the same effect with the filter.
+              <guibutton>Random seed</guibutton> generates a random seed
+              at random.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Open; Save</term>
+          <listitem>
+            <para>
+              With these both command buttons you can save pattern
+              settings in a file, and to get them back later.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </simplesect>
+
+    <simplesect>
+      <title><quote>CML Explorer</quote> filter options(Hue)</title>
+      <figure>
+        <title>Hue tab</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/options-render-cmlexplorer1.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        This filter works in the
+        <link linkend="glossary-hsv">HSV</link> color model. In this tab, you
+        can set options for Hue.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>Function type</term>
+          <listitem>
+            <para>
+              In this drop-down list, you can select the method that
+              will be used to treat the current layer. These methods
+              are:
+            </para>
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <guilabel>Keep image's values</guilabel>: With this
+                  option, image hue values will be kept.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Keep the first value</guilabel>: With this
+                  option, starting color will be standard cyan.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Fill with k parameter</guilabel>,
+                  <guilabel>k{x(1-x)}^p</guilabel>,
+                  <guilabel>k{x(1-x)}^p stepped</guilabel>,
+                  <guilabel>kx^p</guilabel>,
+                  <guilabel>kx^p stepped</guilabel>,
+                  <guilabel>k(1-x^p)</guilabel>,
+                  <guilabel>k(1-x^p) stepped</guilabel>: pattern look
+                  will depend on <parameter>k</parameter> that you will
+                  set later in options.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Delta function</guilabel>,
+                  <guilabel>Delta function stepped</guilabel>: FIXME
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>sin^p based Function</guilabel>,
+                  <guilabel>sin^p stepped</guilabel>: These options
+                  create wave-like patterns, like aurora borealis or
+                  curtain folds.
+                </para>
+              </listitem>
+            </itemizedlist>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Composition</term>
+          <listitem>
+            <para>
+              Here, these options concern Hue. You can select:
+            </para>
+            <para>
+              <guilabel>None</guilabel>, <guilabel>Max(x, -)</guilabel>,
+              <guilabel>Max(x+d, -)</guilabel>,
+              <guilabel>Max(x-d, -)</guilabel>,
+              <guilabel>Min(x, -)</guilabel>,
+              <guilabel>Min(x+d, -)</guilabel>,
+              <guilabel>Min(x-d, -)</guilabel>,
+              <guilabel>Max(x+d, -), (x &lt; 0,5)</guilabel>,
+              <guilabel>Max(x+d, -), (0,5 &lt; x)</guilabel>,
+              <guilabel>Max(x-d, -), (x &lt; 0,5)</guilabel>,
+              <guilabel>Max(x-d, -), (0,5 &lt; x)</guilabel>,
+              <guilabel>Min(x+d, -), (x &lt; 0,5)</guilabel>,
+              <guilabel>Min(x+d, -), (0,5 &lt; x)</guilabel>,
+              <guilabel>Min(x-d, -), (x &lt; 0,5)</guilabel> and
+              <guilabel>Min(x-d, -), (0,5 &lt; x)</guilabel>.
+            </para>
+            <para>
+              A book could be filled with results of all these
+              functions. Please, experiment!
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Misc. Arrange</term>
+          <listitem>
+            <para>
+              This drop-down list offers you some other parameters:
+            </para>
+            <para>
+              <guilabel>Standard</guilabel>,
+              <guilabel>Use average value</guilabel>,
+              <guilabel>Use reverse value</guilabel>,
+              <guilabel>With random power (0,10)</guilabel>,
+              <guilabel>With random power (0,1)</guilabel>,
+              <guilabel>with gradient power (0,1)</guilabel>,
+              <guilabel>Multiply rand. value (0,1)</guilabel>,
+              <guilabel>Multiply rand. value (0,2)</guilabel>,
+              <guilabel>Multiply gradient (0,1)</guilabel> and
+              <guilabel>With p and random (0,1)</guilabel>.
+            </para>
+            <para>
+              Also a book would be necessary to explain all
+              possibilities of these parameters.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Use cyclic range</term>
+          <listitem>
+            <para>
+              //TODO
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Mod. rate</term>
+          <listitem>
+            <para>
+              With this slider and the input box, you can set
+              modification rate from 0.0 to 1.0. Low value results in a
+              lined pattern.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Env. sensitivity</term>
+          <listitem>
+            <para>
+              Value is from 0.0 to 1.0
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Diffusion dist.</term>
+          <listitem>
+            <para>
+              Diffusion distance: from 2 to 10.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term># of subranges</term>
+          <listitem>
+            <para>
+              Number of sub-rangers: from 1 to 10.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>(P)ower factor</term>
+          <listitem>
+            <para>
+              With this option you can influence the
+              <guilabel>Function types</guilabel> using the
+              <parameter>p</parameter> parameter. Value from 0.0 to 10.0.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>k Parameter</term>
+          <listitem>
+            <para>
+              With this option you can influence the
+              <guilabel>Function types</guilabel> using the
+              <parameter>k</parameter> parameter. Value from 0.0 to 10.0.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Range low</term>
+          <listitem>
+            <para>
+              Set lower limit of hue that will be used for calculation.
+              values vary from 0.0 to 1.0.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Range high</term>
+          <listitem>
+            <para>
+              Set the upper limit of hue that will be used for
+              calculation. Variations are from 0.0 to 1.0.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Plot a graph of the settings</term>
+          <listitem>
+            <para>
+              By clicking on this large button, you can open a window
+              that displays the graph of hue present settings.
+            </para>
+            <figure>
+              <title>Function graph of present settings</title>
+              <mediaobject>
+                <imageobject>
+                  <imagedata  format="PNG"
+                    fileref="images/filters/options-render-cmlexplorer1a.png"/>
+                </imageobject>
+              </mediaobject>
+            </figure>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </simplesect>
+
+    <simplesect>
+      <title><quote>CML Explorer</quote> filter options(Saturation)</title>
+      <figure>
+        <title>Saturation tab</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata  format="PNG"
+              fileref="images/filters/options-render-cmlexplorer2.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        In this tab, you can set how Saturation component of the HSV
+        color model will be used in pattern calculation.
+      </para>
+      <para>
+        These options are similar to Hue tab options.
+      </para>
+    </simplesect>
+
+    <simplesect>
+      <title><quote>CML Explorer</quote> filter options (Value)</title>
+      <figure>
+        <title>Value tab</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/filters/options-render-cmlexplorer3.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        In this tab, you can set how the Value (Luminosity) component of
+        the HSV color model will be used in pattern calculation.
+      </para>
+      <para>
+        These options are similar to Hue tab options.
+      </para>
+    </simplesect>
+
+    <simplesect>
+      <title><quote>CML Explorer</quote> filter options (Advanced)</title>
+      <figure>
+        <title>Advanced tab</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata  format="PNG"
+              fileref="images/filters/options-render-cmlexplorer4.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        These tab settings apply to the three HSV channels.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>Channel Sensitivity</term>
+          <listitem>
+            <para>// TODO</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Mutation rate</term>
+          <listitem>
+            <para>// TODO</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Mutation distance</term>
+          <listitem>
+            <para>//TODO</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </simplesect>
+
+    <simplesect>
+      <title><quote>CML Explorer</quote> filter options (Others)</title>
+      <figure>
+        <title>Others tab</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata  format="PNG"
+              fileref="images/filters/options-render-cmlexplorer5.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        In this tab, you can find various parameters about image display
+        and random intervention.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>Initial value</term>
+          <listitem>
+            <para>// TODO</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Zoom factor</term>
+          <listitem>
+            <para>// TODO</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Start offset</term>
+          <listitem>
+            <para>// TODO</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Seed of random</term>
+          <listitem>
+            <para>// TODO</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </simplesect>
+
+    <simplesect>
+      <title><quote>CML Explorer</quote> filter options (Misc.ops)</title>
+      <figure>
+        <title>Miscellaneous options tab</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/filters/options-render-cmlexplorer6.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        In this tab you can find various options about copy and loading.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>Copy settings</term>
+          <listitem>
+            <para>
+              These options allow you to transfer information from
+              one of the HSV channel to another one.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Selective load setting</term>
+          <listitem>
+            <para>
+              With the <guibutton>Open</guibutton> button of this
+              filter,  you can load previously loaded settings. If you
+              don't want to load all of them, you can select a source
+              and a destination channel here.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </simplesect>
   </sect3>
 </sect2>

Modified: trunk/src/filters/render/diffraction.xml
==============================================================================
--- trunk/src/filters/render/diffraction.xml	(original)
+++ trunk/src/filters/render/diffraction.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-05 AntI: Added "es"
   2007-05-18 KoSt: added 'no'
@@ -7,56 +8,35 @@
   050919 de added by axel.wernicke
 -->
 <sect2 id="plug-in-diffraction">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Diffraction Patterns</phrase>
-  </title>
+  <title>Diffraction Patterns</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
     <tertiary>Diffraction</tertiary>
   </indexterm>
   <indexterm>
-    <primary>Diffraction patterns
-      Filter)</primary>
+    <primary>Diffraction patterns (filter)</primary>
   </indexterm>
-  <mediaobject>
-    <imageobject>
-      <imagedata fileref="images/filters/filters-render-diffraction.png" format="PNG"/>
-    </imageobject>
-  </mediaobject>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Two examples of diffraction patterns.</phrase>
-      </title>
+      <title>Two examples of diffraction patterns</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/diffraction1.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/diffraction1.png"/>
         </imageobject>
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/diffraction2.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/diffraction2.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>Diffraction Patterns</guimenuitem></menuchoice>.
-    </para>
-    <para>
       This filter lets you make diffraction or wave interference textures.
       You can change the Frequency, Contours and Sharp Edges for each of the
       RGB  channels. You can also set Brightness, Scattering and Polarization
@@ -78,4 +58,30 @@
       interesting results.
     </para>
   </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Diffraction Patterns</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Diffraction Patterns</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/filters-render-diffraction.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+  </sect3>
 </sect2>

Modified: trunk/src/filters/render/flame.xml
==============================================================================
--- trunk/src/filters/render/flame.xml	(original)
+++ trunk/src/filters/render/flame.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-14 AntI: Added "es"
   2007-05-18 KoSt: added 'no'
@@ -8,18 +9,8 @@
   2005-09-19 de added by axel.wernicke
 -->
 <sect2 id="plug-in-flame">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Flame</phrase>
-  </title>
+  <title>Flame</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -28,22 +19,21 @@
   <indexterm>
     <primary>Flame</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Example of a rendered Flame.</phrase>
-      </title>
+      <title>Example of a rendered Flame</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/flame1.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/flame1.png"/>
         </imageobject>
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-flame.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-flame.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Flame</quote> applied</para>
@@ -51,34 +41,13 @@
       </mediaobject>
     </figure>
     <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Nature</guisubmenu><guimenuitem>Flame</guimenuitem></menuchoice>
-    </para>
-    <para>
       With the Flame filter, you can create stunning, randomly
       generated fractal patterns. You can't control the fractals as
       you can with the <link linkend="plug-in-ifsfractal">Ifs
-        Compose</link> filter, but you can steer the
+      Compose</link> filter, but you can steer the
       random generator in a certain direction, and choose from
       variations of a theme you like.
     </para>
-    <para>
-      In the main window, you can set Rendering and Camera
-      parameters. The first three parameters in the Render display are
-      Brightness, Contrast and Gamma. The result of these options is
-      visible in the Preview window, but it's generally better to
-      stick to the default values, and correct the rendered image
-      later with Image/Colors.
-    </para>
-    <para>
-      The other three parameters affect the rendering process and
-      don't show in the preview window. Sample Density, which controls
-      the resolution of the rendered pattern, is the most important of
-      these. The Camera parameters allow
-      you to zoom and offset the flame pattern, until you're happy
-      with what you see in the preview window. Flame also offers the
-      possibility to store and load your favorite patterns.
-    </para>
     <warning>
       <para>
         Unfortunately it turned out, that this filter is not working properly
@@ -98,32 +67,58 @@
       </para>
     </note>
   </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      You can find this filter through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Nature</guisubmenu>
+        <guimenuitem>Flame</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Flame</quote> filter options
-        </phrase>
-      </title>
+      <title><quote>Flame</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/filters-render-flame.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/filters-render-flame.png"/>
         </imageobject>
       </mediaobject>
     </figure>
+    <para>
+      In the main window, you can set Rendering and Camera
+      parameters. The first three parameters in the Render display are
+      Brightness, Contrast and Gamma. The result of these options is
+      visible in the Preview window, but it's generally better to
+      stick to the default values, and correct the rendered image
+      later with Image/Colors.
+    </para>
+    <para>
+      The other three parameters affect the rendering process and
+      don't show in the preview window. Sample Density, which controls
+      the resolution of the rendered pattern, is the most important of
+      these. The Camera parameters allow
+      you to zoom and offset the flame pattern, until you're happy
+      with what you see in the preview window. Flame also offers the
+      possibility to store and load your favorite patterns.
+    </para>
     <variablelist>
       <varlistentry>
         <term>Edit</term>
         <listitem>
           <figure>
-            <title>
-              <phrase>The Edit Flame dialog</phrase>
-            </title>
+            <title>The Edit Flame dialog</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/filters-render-flame-edit.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/filters-render-flame-edit.png"/>
               </imageobject>
             </mediaobject>
           </figure>

Modified: trunk/src/filters/render/fractalexplorer.xml
==============================================================================
--- trunk/src/filters/render/fractalexplorer.xml	(original)
+++ trunk/src/filters/render/fractalexplorer.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-14 AntI:Added "es"
   2007-05-18 KoSt: added 'no'
@@ -8,9 +9,8 @@
   2005/10/23 en;fr and adds-on by julien hardelin
 -->
 <sect2 id="plug-in-fractalexplorer">
-  <title>
-    <phrase>Fractal Explorer</phrase>
-  </title>
+  <title>Fractal Explorer</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -19,19 +19,15 @@
   <indexterm>
     <primary>Fractal Explorer</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>
-          Example for the Fractal Explorer filter
-        </phrase>
-      </title>
+      <title>Example for the Fractal Explorer filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-fractalexplorer.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-fractalexplorer.jpg"/>
         </imageobject>
         <caption>
           <para>
@@ -42,38 +38,41 @@
     </figure>
     <para>
       With this filter, you can create fractals and multicolored pictures
-      verging to chaos. Unlike the <link linkend="plug-in-ifsfractal">IFS Compose</link> filter, with which you
+      verging to chaos. Unlike the
+      <link linkend="plug-in-ifsfractal">IFS Compose</link> filter, with which you
       can fix the fractal structure precisely, this filter lets you perform
       fractals simply.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Starting filter</phrase>
-    </title>
+    <title>Starting filter</title>
     <para>
       You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guimenuitem>Fractal Explorer</guimenuitem></menuchoice>
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guimenuitem>Fractal Explorer</guimenuitem>
+      </menuchoice>.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
       <title>
-        <phrase><quote>Parameters</quote> options for Fractal Explorer filter
-        </phrase>
+        <quote>Parameters</quote> options for Fractal Explorer filter
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/options-render-fractalexplorer1.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/options-render-fractalexplorer1.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview domain</term>
+        <term>Realtime preview</term>
         <listitem>
           <para>
             Uncheck the <guilabel>Real time preview</guilabel> only if your
@@ -184,7 +183,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/options-render-fractalexplorer2.png" format="PNG"/>
+                <imagedata  format="PNG"
+                  fileref="images/filters/options-render-fractalexplorer2.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -214,12 +214,11 @@
                   If this option is checked, the band effect is smoothed.
                 </para>
                 <figure>
-                  <title>
-                    <phrase>Loglog smoothing example</phrase>
-                  </title>
+                  <title>Loglog smoothing example</title>
                   <mediaobject>
                     <imageobject>
-                      <imagedata fileref="images/filters/examples/render-fractalexpl.png" format="PNG"/>
+                      <imagedata  format="PNG"
+                        fileref="images/filters/examples/render-fractalexpl.png"/>
                     </imageobject>
                   </mediaobject>
                 </figure>
@@ -247,22 +246,26 @@
                 </para>
                 <itemizedlist>
                   <listitem>
-                    <para><guilabel>Sinus</guilabel>: Color variations will be
+                    <para>
+                      <guilabel>Sinus</guilabel>: Color variations will be
                       modulated according to the sinus function.
                     </para>
                   </listitem>
                   <listitem>
-                    <para><guilabel>Cosinus</guilabel>: Color densities will
+                    <para>
+                      <guilabel>Cosinus</guilabel>: Color densities will
                       vary according to cosinus function.
                     </para>
                   </listitem>
                   <listitem>
-                    <para><guilabel>None</guilabel>: Color densities will vary
+                    <para>
+                      <guilabel>None</guilabel>: Color densities will vary
                       linearly.
                     </para>
                   </listitem>
                   <listitem>
-                    <para><guilabel>Inversion</guilabel>: if you check this
+                    <para>
+                      <guilabel>Inversion</guilabel>: if you check this
                       option, function values will be inverted.
                     </para>
                   </listitem>
@@ -278,13 +281,15 @@
                 </para>
                 <itemizedlist>
                   <listitem>
-                    <para><guilabel>As specified above</guilabel>: Color values
+                    <para>
+                      <guilabel>As specified above</guilabel>: Color values
                       will be taken from the <guilabel>Color density
                       </guilabel> options.
                     </para>
                   </listitem>
                   <listitem>
-                    <para><guilabel>Apply active gradient to final image
+                    <para>
+                      <guilabel>Apply active gradient to final image
                       </guilabel>: used colors will be that of active
                       gradient. You should be able to select another gradient
                       by clicking on the gradient source button.
@@ -300,13 +305,11 @@
         <term>Fractals tab</term>
         <listitem>
           <figure>
-            <title>
-              <phrase><quote>Fractal tab</quote> options
-              </phrase>
-            </title>
+            <title><quote>Fractal tab</quote> options</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/options-render-fractalexplorer3.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/options-render-fractalexplorer3.png"/>
               </imageobject>
             </mediaobject>
           </figure>

Modified: trunk/src/filters/render/grid.xml
==============================================================================
--- trunk/src/filters/render/grid.xml	(original)
+++ trunk/src/filters/render/grid.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-06 AntI: Added "es"
   2007-05-18 KoSt: added 'no'
@@ -8,18 +9,8 @@
   2005/06/20 en updated - default color
 -->
 <sect2 id="plug-in-grid">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-11-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Grid</phrase>
-  </title>
+  <title>Grid</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -29,17 +20,15 @@
     <primary>Grid</primary>
     <secondary>Grid filter</secondary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Applying example for the Grid filter</phrase>
-      </title>
+      <title>Applying example for the Grid filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/taj_orig.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
         </imageobject>
         <caption>
           <para>Original image</para>
@@ -47,17 +36,15 @@
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-grid.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-grid.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Grid</quote> applied</para>
         </caption>
       </mediaobject>
     </figure>
-    <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>Grid</guimenuitem></menuchoice>.
-    </para>
+
     <para>
       It renders a Cartesian grid in the active layer, on top of the existing
       contents. The width, spacing, offsets, and colors of the grid lines can
@@ -72,18 +59,28 @@
       </para>
     </tip>
   </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Grid</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Grid</quote> filter options
-        </phrase>
-      </title>
+      <title><quote>Grid</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/filters-render-grid.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/filters-render-grid.png"/>
         </imageobject>
       </mediaobject>
     </figure>

Modified: trunk/src/filters/render/ifsfractal.xml
==============================================================================
--- trunk/src/filters/render/ifsfractal.xml	(original)
+++ trunk/src/filters/render/ifsfractal.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-14 AntI: Added "es"
   2007-05-13 KoSt: added 'no'
@@ -8,18 +9,8 @@
   2005-09-19 de added by axel.wernicke
 -->
 <sect2 id="plug-in-ifsfractal">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>IFS Fractal</phrase>
-  </title>
+  <title>IFS Fractal</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -28,22 +19,15 @@
   <indexterm>
     <primary>IFS Fractal</primary>
   </indexterm>
-  <mediaobject>
-    <imageobject>
-      <imagedata fileref="images/filters/filters-render-ifsfractal.png" format="PNG"/>
-    </imageobject>
-  </mediaobject>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Applying example for the IFS Compose filter</phrase>
-      </title>
+      <title>Applying example for the IFS Compose filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-ifscompose.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-ifscompose.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>IFS Fractal</quote> applied</para>
@@ -51,10 +35,6 @@
       </mediaobject>
     </figure>
     <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Nature</guisubmenu><guimenuitem>IFS fractal</guimenuitem></menuchoice>
-    </para>
-    <para>
       This fractal-based plug-in is truly wonderful! With this
       versatile instrument, you can create amazingly naturalistic
       organic shapes, like leaves, flowers, branches, or even whole
@@ -83,10 +63,31 @@
       Practice</citetitle><xref linkend="bibliography-books-foley01"/>.
     </para>
   </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Nature</guisubmenu>
+        <guimenuitem>IFS fractal</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
+    <figure>
+      <title><quote>IFS fractal</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/filters-render-ifsfractal.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
     <variablelist>
       <varlistentry>
         <term>The Main Interface</term>
@@ -109,8 +110,8 @@
             <guibutton>Move</guibutton>,
             <guibutton>Rotate</guibutton>, <guibutton>Stretch</guibutton>,
             <guibutton>New</guibutton>,
-            <guibutton>Delete</guibutton>, <guibutton>Undo</guibutton>
-            , <guibutton>Redo</guibutton>,
+            <guibutton>Delete</guibutton>, <guibutton>Undo</guibutton>,
+            <guibutton>Redo</guibutton>,
             <guibutton>Select All</guibutton>.
             You can see others, if your window is not wide enough, by
             clicking on the drop-down list button on the right of tool bar:
@@ -186,13 +187,11 @@
         <term>Color transformation</term>
         <listitem>
           <figure>
-            <title>
-              <phrase><quote>Color transformation</quote> tab options
-              </phrase>
-            </title>
+            <title><quote>Color transformation</quote> tab options</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/options-render-ifscompose2.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/options-render-ifscompose2.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -244,10 +243,9 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>A Brief Tutorial</phrase>
-    </title>
+    <title>A Brief Tutorial</title>
     <para>
       This is a rather complex plug-in, so to help you understand it, we'll
       guide you through an example where you'll create a leaf or branch.
@@ -264,9 +262,16 @@
       <listitem>
         <para>
           Before invoking the filter: Select
-          <menuchoice><guimenu>File</guimenu><guimenuitem>New Image</guimenuitem></menuchoice>
+          <menuchoice>
+            <guimenu>File</guimenu>
+            <guimenuitem>New Image</guimenuitem>
+          </menuchoice>.
           Add a transparent layer with
-          <menuchoice><guimenu>Layers</guimenu><guisubmenu>Layers and Channels</guisubmenu><guimenuitem>New Layer</guimenuitem></menuchoice>
+          <menuchoice>
+            <guimenu>Layers</guimenu>
+            <guisubmenu>Layers and Channels</guisubmenu>
+            <guimenuitem>New Layer</guimenuitem>
+          </menuchoice>.
           Set the foreground color in the toolbox to black, and
           set the background to white.
         </para>
@@ -277,15 +282,17 @@
           so that they point upward. You'll now be able to see the outline of
           what's going to be the tip and sides of the leaf. (If you have
           problems, it may help to know that the three vertices of a triangle
-          are not equivalent.)<indexterm><primary>Docks</primary><secondary>Add tab</secondary></indexterm>
+          are not equivalent.)
+          <indexterm>
+            <primary>Docks</primary><secondary>Add tab</secondary>
+          </indexterm>
         </para>
         <figure>
-          <title>
-            <phrase>Tutorial Step 2</phrase>
-          </title>
+          <title>Tutorial Step 2</title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/filters/examples/ifscompose-tut1.png" format="PNG"/>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/ifscompose-tut1.png"/>
             </imageobject>
             <caption>
               <para>
@@ -316,12 +323,11 @@
           new fractal to make it look convincing.
         </para>
         <figure>
-          <title>
-            <phrase>Tutorial Step 3</phrase>
-          </title>
+          <title>Tutorial Step 3</title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/filters/examples/ifscompose-tut2.png" format="PNG"/>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/ifscompose-tut2.png"/>
             </imageobject>
             <caption>
               <para>
@@ -343,12 +349,11 @@
           and rotate the entire leaf.
         </para>
         <figure>
-          <title>
-            <phrase>Tutorial Step 4</phrase>
-          </title>
+          <title>Tutorial Step 4</title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/filters/examples/ifscompose-tut3.png" format="PNG"/>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/ifscompose-tut3.png"/>
             </imageobject>
             <caption>
               <para>
@@ -369,12 +374,11 @@
           select to choose a color.
         </para>
         <figure>
-          <title>
-            <phrase>Tutorial Step 5</phrase>
-          </title>
+          <title>Tutorial Step 5</title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/filters/examples/ifscompose-tut4.png" format="PNG"/>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/ifscompose-tut4.png"/>
             </imageobject>
             <caption>
               <para>

Modified: trunk/src/filters/render/jigsaw.xml
==============================================================================
--- trunk/src/filters/render/jigsaw.xml	(original)
+++ trunk/src/filters/render/jigsaw.xml	Fri Mar 27 19:07:30 2009
@@ -1,23 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-05-18 KoSt: added 'no'
   2005-12-08 <simplesect> replaced by <sect3> by lexa
   2005/09/20 de added by axel.wernicke
 -->
 <sect2 id="plug-in-jigsaw">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Jigsaw</phrase>
-  </title>
+  <title>Jigsaw</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -26,21 +17,15 @@
   <indexterm>
     <primary>Jigsaw</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
-    <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>Jigsaw</guimenuitem></menuchoice>
-    </para>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Jigsaw filter example</phrase>
-      </title>
+      <title>Jigsaw filter example</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/taj_orig.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
         </imageobject>
         <caption>
           <para>Original image</para>
@@ -48,7 +33,8 @@
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-jigsaw.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-jigsaw.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Jigsaw</quote> applied</para>
@@ -65,23 +51,34 @@
         If you want to be able to easily select individual puzzle-piece
         areas,  render the jigsaw pattern on a
         separate layer filled with solid white, and set the layer mode
-        to Multiply.  You can then select puzzle pieces using the <link linkend="gimp-tool-fuzzy-select">magic wand</link> (fuzzy
+        to Multiply.  You can then select puzzle pieces using the
+        <link linkend="gimp-tool-fuzzy-select">magic wand</link> (fuzzy
         select) tool on the new jigsaw layer.
       </para>
     </tip>
   </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Jigsaw</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Jigsaw</quote> filter options
-        </phrase>
-      </title>
+      <title><quote>Jigsaw</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/options-render-jigsaw.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/options-render-jigsaw.png"/>
         </imageobject>
       </mediaobject>
     </figure>

Modified: trunk/src/filters/render/maze.xml
==============================================================================
--- trunk/src/filters/render/maze.xml	(original)
+++ trunk/src/filters/render/maze.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-09 AntI: Added "es"
   2007-05-18 KoSt: added 'no'
@@ -7,18 +8,8 @@
   2005/09/20 de added by axel.wernicke
 -->
 <sect2 id="plug-in-maze">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-18</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Maze</phrase>
-  </title>
+  <title>Maze</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -27,17 +18,15 @@
   <indexterm>
     <primary>Maze</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>An example of a rendered maze.</phrase>
-      </title>
+      <title>An example of a rendered maze. </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-maze.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-maze.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Maze</quote> applied</para>
@@ -45,20 +34,28 @@
       </mediaobject>
     </figure>
     <para>
-      You can find this filter in the image menu through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>Maze</guimenuitem></menuchoice>
-    </para>
-    <para>
       This filter generates a random black and white maze
       pattern.  The result completely overwrites the previous
       contents of the active layer.  A typical example is shown
       below.  Can you find the route from the center to the edge?
     </para>
   </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Maze</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
       <title>
         <phrase><quote>Maze</quote> filter options
@@ -66,7 +63,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/options-render-maze.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/options-render-maze.png"/>
         </imageobject>
       </mediaobject>
     </figure>

Modified: trunk/src/filters/render/plasma.xml
==============================================================================
--- trunk/src/filters/render/plasma.xml	(original)
+++ trunk/src/filters/render/plasma.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-02 AntI: Added "es"
   2007-05-18 KoSt: added 'no'
@@ -7,18 +8,8 @@
   2005/09/21 de added by axel.wernicke
 -->
 <sect2 id="plug-in-plasma">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-18</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Plasma</phrase>
-  </title>
+  <title>Plasma</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -27,17 +18,15 @@
   <indexterm>
     <primary>Plasma</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Example of a rendered plasma.</phrase>
-      </title>
+      <title>Example of a rendered plasma</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-plasma.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-plasma.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Plasma</quote> applied</para>
@@ -45,10 +34,6 @@
       </mediaobject>
     </figure>
     <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Clouds</guisubmenu><guimenuitem>Plasma</guimenuitem></menuchoice>
-    </para>
-    <para>
       All of the colors produced by Plasma are completely saturated.
       Sometimes the strong colors may be distracting, and a more
       interesting surface will appear when you desaturate the image
@@ -64,18 +49,28 @@
       </para>
     </note>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Clouds</guisubmenu>
+        <guimenuitem>Plasma</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Plasma</quote> filter options
-        </phrase>
-      </title>
+      <title><quote>Plasma</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/filters-render-plasma.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/filters-render-plasma.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -83,7 +78,8 @@
       <varlistentry>
         <term>Random Seed</term>
         <listitem>
-          <para><guilabel>Random Seed</guilabel> controls the randomization
+          <para>
+            <guilabel>Random Seed</guilabel> controls the randomization
             element. The <guibutton>Randomize</guibutton> check-button will
             set the seed using the hardware clock of the computer.
             There is no reason to use anything else unless you want to

Modified: trunk/src/filters/render/qbist.xml
==============================================================================
--- trunk/src/filters/render/qbist.xml	(original)
+++ trunk/src/filters/render/qbist.xml	Fri Mar 27 19:07:30 2009
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-11-02 AntI: Added "es"
   2007-05-18 KoSt: added 'no'
@@ -7,18 +8,8 @@
   2005/09/21 de added by axel.wernicke
 -->
 <sect2 id="plug-in-qbist">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-19</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Qbist</phrase>
-  </title>
+  <title>Qbist</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -27,82 +18,78 @@
   <indexterm>
     <primary>Qbist</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Applying example for the Qbist filter</phrase>
-      </title>
+      <title>Applying examples for the Qbist filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-qbist.jpg" format="JPG"/>
-        </imageobject>
-        <caption>
-          <para>Filter <quote>Qbist</quote> applied</para>
-        </caption>
-      </mediaobject>
-    </figure>
-    <para>
-      You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>Qbist</guimenuitem></menuchoice>
-    </para>
-    <para>
-      The Qbist filter generates random textures.  A starting texture
-      is displayed in the middle square, and different variations
-      surround it. If you like one of the alternative textures, click
-      on it. The chosen texture now turns up in the middle, and
-      variations on that specific theme are displayed around it. When
-      you have found the texture you want, click on it and then click
-      OK. The texture will now appear on the currently active layer,
-      completely replacing its previous contents.
-    </para>
-    <figure>
-      <title>
-        <phrase>
-          Three more or less random examples of qbist renderings.
-        </phrase>
-      </title>
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref="images/filters/examples/qbist1.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/qbist1.png"/>
         </imageobject>
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/qbist2.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/qbist2.png"/>
         </imageobject>
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/qbist3.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/qbist3.png"/>
         </imageobject>
       </mediaobject>
     </figure>
+    <para>
+      The Qbist filter generates random textures containing geometric figures
+      and color gradients.
+    </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Qbist</guimenuitem>
+      </menuchoice>
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Qbist</quote> filter options
-        </phrase>
-      </title>
+      <title><quote>Qbist</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/filters-render-qbist.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/filters-render-qbist.png"/>
         </imageobject>
       </mediaobject>
     </figure>
+
+    <para>
+      The Qbist filter generates random textures. A starting texture is
+      displayed in the middle square, and different variations surround it. If
+      you like one of the alternative textures, click on it. The chosen
+      texture now turns up in the middle, and variations on that specific
+      theme are displayed around it. When you have found the texture you want,
+      click on it and then click OK. The texture will now appear on the
+      currently active layer, completely replacing its previous contents.
+    </para>
+
     <variablelist>
       <varlistentry>
         <term>Antialiasing</term>
         <listitem>
           <para>
-            If you check this, it will make edges appear smooth rather
-            than stair-step-like.
+            If you check this, it will make edges appear smooth rather than
+            stair-step-like.
           </para>
         </listitem>
       </varlistentry>
@@ -110,10 +97,9 @@
         <term>Open/Save</term>
         <listitem>
           <para>
-            These buttons allow you to save and reload your
-            textures. This is quite handy because it's almost
-            impossible to re-create a good pattern by just clicking
-            around.
+            These buttons allow you to save and reload your textures. This is
+            quite handy because it's almost impossible to re-create a good
+            pattern by just clicking around.
           </para>
         </listitem>
       </varlistentry>

Modified: trunk/src/filters/render/sinus.xml
==============================================================================
--- trunk/src/filters/render/sinus.xml	(original)
+++ trunk/src/filters/render/sinus.xml	Fri Mar 27 19:07:30 2009
@@ -1,23 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-05-18 KoSt: added 'no'
   2005-12-08 <simplesect> replaced by <sect3> by lexa
   2005/09/21 de added by axel.wernicke
 -->
 <sect2 id="plug-in-sinus">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-19</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Sinus</phrase>
-  </title>
+  <title>Sinus</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -26,17 +17,15 @@
   <indexterm>
     <primary>Sinus</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Applying example for the Sinus filter</phrase>
-      </title>
+      <title>Applying example for the Sinus filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-sinus.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-sinus.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Sinus</quote> applied</para>
@@ -45,7 +34,12 @@
     </figure>
     <para>
       You can find this filter from the image menu through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Pattern</guisubmenu><guimenuitem>Sinus</guimenuitem></menuchoice>
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Sinus</guimenuitem>
+      </menuchoice>.
     </para>
     <para>
       The Sinus filter lets you make sinusoidally based textures,
@@ -61,18 +55,15 @@
       repetition in the pattern.  An example is shown below.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Sinus</quote> filter options (Settings)
-        </phrase>
-      </title>
+      <title><quote>Sinus</quote> filter options (Settings)</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/options-render-sinus1.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/options-render-sinus1.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -103,7 +94,8 @@
             <varlistentry>
               <term>Random Seed</term>
               <listitem>
-                <para><guilabel>Random Seed</guilabel> controls the random
+                <para>
+                  <guilabel>Random Seed</guilabel> controls the random
                   behaviour of the filter. If the same random seed in the
                   same situation is used, the filter produces exactly the
                   same results. A different random seed produces different
@@ -147,13 +139,11 @@
         <term>Color settings</term>
         <listitem>
           <figure>
-            <title>
-              <phrase><quote>Sinus</quote> filter options (Color)
-              </phrase>
-            </title>
+            <title><quote>Sinus</quote> filter options (Color)</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/options-render-sinus2.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/options-render-sinus2.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -180,14 +170,11 @@
         <term>Blend settings</term>
         <listitem>
           <figure>
-            <title>
-              <phrase>
-                Sinus filter options (Blend)
-              </phrase>
-            </title>
+            <title>Sinus filter options (Blend)</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/options-render-sinus3.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/options-render-sinus3.png"/>
               </imageobject>
             </mediaobject>
           </figure>

Modified: trunk/src/filters/render/solid_noise.xml
==============================================================================
--- trunk/src/filters/render/solid_noise.xml	(original)
+++ trunk/src/filters/render/solid_noise.xml	Fri Mar 27 19:07:30 2009
@@ -1,23 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2007-05-15 KoSt: added 'no'
   2005-12-08 <simplesect> replaced by <sect3> by lexa
   2005/09/21 de added by axel.wernicke
 -->
 <sect2 id="plug-in-solid-noise">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-12-19</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Solid Noise</phrase>
-  </title>
+  <title>Solid Noise</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Render</secondary>
@@ -26,17 +17,15 @@
   <indexterm>
     <primary>Solid noise</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>Example of turbulent solid noise.</phrase>
-      </title>
+      <title>Example of turbulent solid noise</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/render-taj-solidnoise.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-solidnoise.jpg"/>
         </imageobject>
         <caption>
           <para>Filter <quote>Solid noise</quote> applied</para>
@@ -44,10 +33,6 @@
       </mediaobject>
     </figure>
     <para>
-      You can find this filter from the image menu through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Render</guisubmenu><guisubmenu>Clouds</guisubmenu><guimenuitem>Solid noise</guimenuitem></menuchoice>
-    </para>
-    <para>
       Solid Noise is a great texture maker. Note that this noise is
       always gray, even if you applied it to a very colorful image (it
       doesn't matter what the original image looks like -- this filter
@@ -59,18 +44,28 @@
       clouds.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Clouds</guisubmenu>
+        <guimenuitem>Solid noise</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Solid Noise</quote> filter options
-        </phrase>
-      </title>
+      <title><quote>Solid Noise</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/solid-noise-options.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/solid-noise-options.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -78,7 +73,8 @@
       <varlistentry>
         <term>Random Seed</term>
         <listitem>
-          <para><guilabel>Random Seed</guilabel> controls random behaviour of the
+          <para>
+            <guilabel>Random Seed</guilabel> controls random behaviour of the
             filter. If the same random seed in the same situation is used, the
             filter produces exactly the same results. A different random seed
             produces different results. Random seed can be entered manually or



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