[gimp-help-2] Some changes in concepts

[Julien Hardlin <jhardlin src gnome org>]

commit dca5eb3f1d2a7bbb5771f0893196a3da6407b25f
Author: Julien Hardelin <jm hard wanadoo fr>
Date:   Sat May 12 14:59:08 2012 +0200

    Some changes in concepts

 src/concepts/basic-setup.xml     |    6 ++--
 src/concepts/docks.xml           |   22 ++++++++-------
 src/concepts/imagewindow.xml     |   55 ++++++++++++++++++--------------------
 src/concepts/layer-groups.xml    |   33 ++++++++++++++---------
 src/concepts/text-management.xml |    6 ++--
 src/concepts/tools-presets.xml   |    2 +
 6 files changed, 66 insertions(+), 58 deletions(-)
---
diff --git a/src/concepts/basic-setup.xml b/src/concepts/basic-setup.xml
index f1c9aa4..cf1026e 100755
--- a/src/concepts/basic-setup.xml
+++ b/src/concepts/basic-setup.xml
@@ -187,11 +187,11 @@ id="gimp-concepts-main-windows">
               <para>
                 When several images are open, a new bar appears above the image
                 window, with a tab for every image. You can navigate between
-                images either using
+                images by clicking on tabs or either using
                 <keycombo><keycap>Ctrl</keycap><keycap>PageUp or
                 PageDown</keycap></keycombo> or
-                <keycombo><keycap>Alt</keycap><keycap>0-1</keycap></keycombo>.
-                <quote>0-1</quote> represent tab number; you must use the number
+<keycombo><keycap>Alt</keycap><keycap>Number</keycap></keycombo>.
+                <quote>Number</quote> is tab number; you must use the number
                 keys of the upper line of your keyboard, not that of keypad
                 (Alt-shift necessary for some national keyboards).
               </para>
diff --git a/src/concepts/docks.xml b/src/concepts/docks.xml
index e48fb5a..56e696e 100755
--- a/src/concepts/docks.xml
+++ b/src/concepts/docks.xml
@@ -121,7 +121,7 @@
       </mediaobject>
     </figure>
     <para>
-      More simpler: the <command>Add tab</command> command in the Tab menu <xref
+      More simple: the <command>Add tab</command> command in the Tab menu <xref
       linkend="gimp-dockable-menu"/>.
     </para>
 
@@ -134,9 +134,10 @@
         </imageobject>
         <caption>
           <para>
-            The Histogram dialog dragged to the left vertical docking bar and
-            the result: the dialog anchored to the left border of the
-            Layers-Undo dock (this dialog now belongs to the right panel).
+            The Histogram dialog dragged to the left vertical docking bar of
+            the right panel and the result: the dialog anchored to
+            the left border of the right panel. This dialog now belongs to the
+            right panel.
           </para>
           <para>
             So, you can arrange dialogs in a <emphasis>multi-column</emphasis>
@@ -177,11 +178,11 @@
       </mediaobject>
     </figure>
     <para>
-      In each dialog, you can access a special menu of tab-related operations
-      by pressing the Tab Menu button, as highlighted in the figure above.
-      Exactly which commands are shown in the menu varies a bit from
-      dialog to dialog, but they always include operations for creating new
-      tabs, or closing or detaching tabs.
+      In each dialog, you can access a special menu of tab-related operations by
+      pressing the Tab Menu button, as highlighted in the figure above. Exactly
+      which commands are shown in the menu depends on the active dialog, but
+      they always include operations for creating new tabs, closing or
+      detaching tabs.
     </para>
     <figure>
       <title>The Tab menu of the Layers dialog.</title>
@@ -440,7 +441,8 @@
                   <para>
                     Use
                     <keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>
-                    to open the list search field.
+                    to open the list search field. An item must be selected for
+                    this command to be effective.
                   </para>
                 </caption>
               </mediaobject>
diff --git a/src/concepts/imagewindow.xml b/src/concepts/imagewindow.xml
index dc2aade..29768d1 100755
--- a/src/concepts/imagewindow.xml
+++ b/src/concepts/imagewindow.xml
@@ -107,7 +107,7 @@
       <!--2-->
       <para>
         <emphasis>Image Menu:</emphasis>
-        Directly below the Title Bar appears the Image Menu (unless it has
+        Directly below the Title Bar appears the Menu bar (unless it has
         been suppressed). The Image Menu provides access to nearly every
         operation you can perform on an image. You can also right-click
         on an image to display a pop-up image menu,
@@ -318,29 +318,6 @@
       </para>
     </listitem>
   </orderedlist>
-  
-  <para>
-    <anchor id="dotted-strips"/>
-    <indexterm>
-      <primary>Dotted strips</primary>
-    </indexterm>
-
-    <emphasis>Dotted strips</emphasis>:
-
-    <mediaobject>
-      <imageobject>
-        <imagedata format="PNG"
-            fileref="images/using/left-vertical-line.png"/>
-      </imageobject>
-    </mediaobject>
-    
-    In single-window mode,
-    depending on your system and gtk theme, you can notice these small dotted
-    strips, or nothing, on the left and the right side of the image. They
-    mark the limit between the image area and the panels, from top to bottom. 
-    When the mouse pointer passes over this limit, it turns to a double-arrow.
-    Then, click-and-drag to move the limit between image area and panels.
-  </para>
     
   <tip>
     <para>
@@ -348,10 +325,30 @@
       open the image in its own Image window or tab.
     </para>
     <para>
-      In multi-window mode, dragging an image into an existing Image window, 
-      adds it to the currently open image in a new layer. This feature 
-      is not available in single-window mode but you can, of course, drop the 
-      image in the Layers dialog.
+      Dragging an image file into the Layer dialog adds it to the image as a
+      new layer.
     </para>
-  </tip>  
+  </tip>
+
+  <para>
+    Image size and image window size can be different. You can make image fit
+    window, and vice versa, using two keyboard shortcuts:
+    <itemizedlist>
+      <listitem>
+        <para>
+          <keycombo><keycap>Ctrl</keycap><keycap>J</keycap></keycombo>: this
+          command keeps the zoom level; it adapts window size to image size.
+          The Shrink Wrap command does the same.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap>
+          <keycap>J</keycap></keycombo>: this command modifies the zoom level
+          to adapt the image display to the window.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </para>
+   
 </sect2>
diff --git a/src/concepts/layer-groups.xml b/src/concepts/layer-groups.xml
index 8fe818a..8983660 100755
--- a/src/concepts/layer-groups.xml
+++ b/src/concepts/layer-groups.xml
@@ -15,8 +15,7 @@
 
   <para>
     You can group layers that have similarities in a tree-like way. So, the
-    layer list becomes easier to manage. You can merge layer modes to the
-    group and make new creative effect possible.
+    layer list becomes easier to manage.
   </para>
 
   <mediaobject>
@@ -45,8 +44,11 @@
         </para>
         <para>
           This empty layer group appears just above the current layer. It is
-          important to name it (double-click on the name to edit it), else
-          you will get confused when several ones are created.
+          important to give it an evocative name (double-click or
+          <keycap>F2</keycap> on the name, or use <command>Edit Layer
+          Attributes</command> in the context menu you get by right clicking the
+          Layer dialog, to edit it), else you will get confused when several
+          ones are created.
         </para>
         <para>
           You can create several layer groups and you can
@@ -138,10 +140,11 @@
           bottom of the layer dialog).
         </para>
         <para>
-          You can also <emphasis role="bold">move and duplicate a layer group
-          inside the canvas</emphasis>: chain all layers in the layer group,
-          activate the Move tool, click-and-drag an element of the layer
-          group in the image. That's a way to multiply objects in an image.
+          You can also <emphasis role="bold">move a layer group to the
+          canvas</emphasis>: this duplicates the group <emphasis>in</emphasis>
+          the group. Chain all layers in the duplicated layer group, activate
+          the Move tool, then, in the image, move the layer. That's a way to
+          multiply multi-layer objects in an image.
         </para>
       </listitem>
     </varlistentry>
@@ -158,7 +161,7 @@
     </varlistentry>
 
     <varlistentry>
-      <term>Embedd Layer Groups</term>
+      <term>Embed Layer Groups</term>
       <listitem>
         <para>
           When a layer group is activated, you can add another group inside
@@ -173,8 +176,9 @@
       <term>Layer Modes and Groups</term>
       <listitem>
         <para>
-          A layer inside a layer group acts on layers that are in this group
-          only. A layer above a layer group acts on all layers underneath,
+          A layer mode applied to a layer group acts on layers that are in this
+          group only. A layer mode above a layer group acts on all layers
+underneath,
           outside and inside the layer groups.
         </para>
         <mediaobject>
@@ -233,8 +237,9 @@
       <term>Layer Mask</term>
       <listitem>
         <para>
-          As with normal layers, you can add a layer mask to a layer in the
-          group to mask a part of the image.
+           You cannot add a layer mask to a layer group (the corresponding
+           option is grayed out. But, as with normal layers, you can add a layer
+           mask to a layer in the group to mask a part of the layer.
         </para>
         <mediaobject>
           <imageobject>
@@ -252,3 +257,5 @@
   </variablelist>
 
 </sect1>
+
+
diff --git a/src/concepts/text-management.xml b/src/concepts/text-management.xml
index 6116021..52cfcec 100755
--- a/src/concepts/text-management.xml
+++ b/src/concepts/text-management.xml
@@ -76,9 +76,9 @@
   </para>
   <para>
     You can also <emphasis role="bold">enlarge the text box</emphasis> by
-    click-and-dragging, as you do with selections, before starting typing
-    text. Note that box mode turns to "Fixed". You also have to press
-    <keycap>Enter</keycap> to add a new line.
+    click-and-dragging, as you do with selections. Note that box mode
+    turns to "Fixed". You also have to press <keycap>Enter</keycap> to add
+    a new line.
   </para>
   <para>
     To <emphasis role="bold">edit text</emphasis>, you must, first, select the
diff --git a/src/concepts/tools-presets.xml b/src/concepts/tools-presets.xml
index fb1ebcc..9f031c7 100755
--- a/src/concepts/tools-presets.xml
+++ b/src/concepts/tools-presets.xml
@@ -46,6 +46,8 @@
 </sect1>
 
 
+
+
     
 
   
\ No newline at end of file