[gimp-help-2] Corrected minor code errors in src/toolbox/transform/common-features.xml

[Kolbjørn Stuestøl <kolbjoern src gnome org>]

commit 2789403ba5405eadc62270b60bdc1680269ea38f
Author: kolbjoern <kolbjoern git gnome org>
Date:   Thu Apr 18 20:57:21 2013 +0200

    Corrected minor code errors in src/toolbox/transform/common-features.xml

 src/toolbox/transform/common-features.xml | 93 +++++++++++++++++++++++--------
 1 file changed, 71 insertions(+), 22 deletions(-)
---
diff --git a/src/toolbox/transform/common-features.xml b/src/toolbox/transform/common-features.xml
index 7422f33..b90f1f9 100644
--- a/src/toolbox/transform/common-features.xml
+++ b/src/toolbox/transform/common-features.xml
@@ -176,6 +176,14 @@
       <varlistentry>
         <term>Clipping</term>
         <listitem>
+          <indexterm>
+            <primary>Transform</primary>
+            <secondary>Clipping</secondary>
+          </indexterm>
+          <indexterm>
+            <primary>Clipping</primary>
+            <secondary>Transform</secondary>
+          </indexterm>               
           <para>
             After transformation, the image can be bigger. This option will
             clip the transformed image to the original image size.
@@ -333,18 +341,25 @@
             <primary>Preview</primary>
             <secondary>Transformation tools</secondary>
           </indexterm>         
-         <para>
-           If this is marked, which is the default setting, the transformed
-           image will be visible above the original image or layer. There 
-           will also be a slider with which you may select the visibility of 
-           the preview.
-         </para>
+          <para>
+            If this is marked, which is the default setting, the transformed
+            image will be visible on top of the original image or layer. There 
+            will also be a slider with which you may select the preview opacity.
+          </para>
         </listitem>    
       </varlistentry>
       
-      <varlistentry>
+      <varlistentry id="gimp-tool-transform-guides">
         <term>Guides</term>
         <listitem>
+          <indexterm>
+            <primary>Transform</primary>
+            <secondary>Guides</secondary>
+          </indexterm>
+          <indexterm>
+            <primary>Guides</primary>
+            <secondary>Transform</secondary>
+          </indexterm>       
           <para>
             This is a drop down list where you select the type of guide lines 
             which suits your transforming. All the guides uses a frame to mark 
@@ -430,21 +445,55 @@
           </variablelist>
         </listitem>        
       </varlistentry>
-
-      <varlistentry>
-        <term>Opacity</term>
-        <listitem>
-          <para>
-            This slider lets you set the preview opacity.
-          </para>
-        </listitem>
-      </varlistentry>
     </variablelist>
-    <note>
-      <para>
-        When rotating a path, Preview options are not valid: only Outline is
-        active.
-      </para>
-    </note>
   </sect3>
+  <sect3>
+    <title>Transforming Paths</title>
+    <indexterm>
+      <primary>Transform</primary>
+      <secondary>Paths</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>Paths</primary>
+      <secondary>Transform</secondary>
+    </indexterm>
+    <para>
+      If you for some reason want to transform paths, it is possible to do 
+      this using the transform tools. 
+    </para>
+    <figure>
+      <title>Rotating paths</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paths-transform-1.png" format="PNG"/>
+        </imageobject>
+        <caption>
+          <para>Paths dialog</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paths-transform-2.png" format="PNG"/>
+        </imageobject>
+        <caption>
+          <para>Option modus: Path</para>
+        </caption>
+      </mediaobject>                 
+    </figure>    
+    <para>
+      When the path is drawn go to the path dialog and click on the first field 
+      before the path outline in the dialog window to get the eye icon visible.
+      Then choose the transformation tool and in the upper part of the option
+      dialog click on the path icon to tell the tool to act on the path.      
+    </para>
+    <para>
+      Do the transformation the usual way and confirm it when finished. It 
+      could be a good idea to set the Guides to <quote>No guides</quote> to get
+      the path more recognizable. 
+    </para>
+    <para>
+      When the transformation is finished, choose the path tool and click on 
+      the changed path to activate it again for further working on it. 
+    </para>
+  </sect3>    
 </sect2>