gimp-help-2 r2778 - in trunk: . src/toolbox

[ulfehlert svn gnome org]

Author: ulfehlert
Date: Thu Mar 12 17:14:34 2009
New Revision: 2778
URL: http://svn.gnome.org/viewvc/gimp-help-2?rev=2778&view=rev

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

	* src/toolbox/tool-iscissors.xml: added Shift modifier description
	(bug #572673)


Modified:
   trunk/ChangeLog
   trunk/src/toolbox/tool-iscissors.xml

Modified: trunk/src/toolbox/tool-iscissors.xml
==============================================================================
--- trunk/src/toolbox/tool-iscissors.xml	(original)
+++ trunk/src/toolbox/tool-iscissors.xml	Thu Mar 12 17:14:34 2009
@@ -1,6 +1,8 @@
 <?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-12 ude: added Shift modifier description (bug #572673)
   2008-12-07 j.h : fixed bug #562448
   2008-03-23 JPL : rewied fr & en for Gimp 2.4
   2008-01-29 Dust : added 'ko'
@@ -15,23 +17,18 @@
   050519 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-iscissors">
-  <title>
-    <phrase>Scissors</phrase>
-  </title>
+  <title>Intelligent Scissors</title>
+
   <indexterm>
     <primary>Tools</primary>
     <secondary>Scissors</secondary>
   </indexterm>
   <indexterm>
-    <primary>Scissors Tool</primary>
+    <primary>Scissors tool</primary>
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>
-        Intelligent Scissors tool icon in the Toolbox.
-      </phrase>
-    </title>
+    <title>Intelligent Scissors tool icon in the Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-scissor.png" format="PNG"/>
@@ -73,9 +70,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the tool</phrase>
-    </title>
+    <title>Activating the tool</title>
     <para>
       You can access to the Intelligent Scissors Tool in different ways:
     </para>
@@ -87,14 +82,20 @@
             <guimenu>Tools</guimenu>
             <guisubmenu>Selection Tools</guisubmenu>
             <guimenuitem>Intelligent Scissors</guimenuitem>
-          </menuchoice>;
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
           By clicking on the tool icon
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-rect-select-22.png"/></imageobject></inlinemediaobject></guiicon>
-          in the ToolBox;
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject>
+                <imagedata fileref="images/toolbox/stock-tool-rect-select-22.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon>
+          in the ToolBox.
         </para>
       </listitem>
       <listitem>
@@ -106,27 +107,46 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
-    <para>
-      The Scissor tool does not have any special key modifiers, only the ones
-      that affect all selection tools in the same way. See
-      <xref linkend="gimp-tool-select"/> for help with these.
+    <title>Key modifiers</title>
+    <para>
+      The default behavior of the <keycap>Shift</keycap>,
+      <keycap>Ctrl</keycap>, and  <keycap>Alt</keycap> keys is described in
+      <xref linkend="gimp-tools-select-modifiers"/> for all selection tools.
+    </para>
+    <para>
+      There is, however, one key modifier that has a special behavior if you
+      use it while editing a selection, that is <emphasis>after</emphasis> you
+      have added the first node:
     </para>
+    <variablelist>
+      <varlistentry>
+        <term><keycap>Shift</keycap></term>
+        <listitem>
+          <para>
+            By default, the <emphasis>auto-edge snap feature</emphasis> is
+            enabled: whenever you click and drag the mouse pointer, the
+            Scissors tool finds the point of the maximal gradient (where the
+            color change is maximal) for placing a new control node or moving
+            an existing node.
+          </para>
+          <para>
+            Holding down this key while clicking and dragging disables this
+            feature, and the control node will be placed at the position of
+            the mouse pointer.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Tool handling</phrase>
-    </title>
+    <title>Tool handling</title>
     <figure>
-      <title>
-        <phrase>Using Intelligent Scissors.</phrase>
-      </title>
+      <title>Using Intelligent Scissors</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/iscissors-selection.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/toolbox/iscissors-selection.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -136,13 +156,31 @@
       can move each one by clicking and dragging, except the first and the last
       one. The selection is closed when you are clicking the last point over
       the first one. When the selection is closed the pointer shape
-      changes according to its position:  inside
-      <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/cissors-mouse.png"/></imageobject></inlinemediaobject></guiicon>
-      , on the boundary
-      <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/cissors-plus.png"/></imageobject></inlinemediaobject></guiicon>
+      changes according to its position: inside
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="images/toolbox/cissors-mouse.png"/>
+          </imageobject>
+        </inlinemediaobject>
+      </guiicon>,
+      on the boundary
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="images/toolbox/cissors-plus.png"/>
+          </imageobject>
+        </inlinemediaobject>
+      </guiicon>,
       and outside
-      <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/cissors-bad.png"/></imageobject></inlinemediaobject></guiicon>
-      . You can adjust the selection creating new points by clicking on the
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="images/toolbox/cissors-bad.png"/>
+          </imageobject>
+        </inlinemediaobject>
+      </guiicon>.
+      You can adjust the selection creating new points by clicking on the
       boundary or by moving each control points (merged first and last
       point). The selection is validated when you click inside.
     </para>
@@ -169,16 +207,13 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Tool Options for the Intelligent Scissors</phrase>
-      </title>
+      <title>Tool Options for the Intelligent Scissors</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-scissor.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/toolbox/tool-options-scissor.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -187,9 +222,7 @@
 
     <variablelist>
       <varlistentry>
-        <term>
-          Modes; Antialiasing; Feather edges
-        </term>
+        <term>Modes; Antialiasing; Feather edges</term>
         <listitem>
           <xi:include href="about-common-select-options.xml"/>
         </listitem>
@@ -200,13 +233,13 @@
         <term>Interactive boundary</term>
         <listitem>
           <para>
-          If this option is enabled, dragging a control node during
-          placement will indicate the path that will be taken by the
-          selection boundary. If it is not enabled, the node will be shown
-          connected to the previous node by a straight line while you are
-          dragging it around, and you won't see the resulting path until you
-          release the pointer button. On slow systems, if your control nodes
-          are far apart, this may give a bit of a speed-up.
+            If this option is enabled, dragging a control node during
+            placement will indicate the path that will be taken by the
+            selection boundary. If it is not enabled, the node will be shown
+            connected to the previous node by a straight line while you are
+            dragging it around, and you won't see the resulting path until you
+            release the pointer button. On slow systems, if your control nodes
+            are far apart, this may give a bit of a speed-up.
         </para>
         </listitem>
       </varlistentry>