[gimp-help-2] QuickMask concepts updates.

[Roman Joost <romanofski src gnome org>]

commit 564a28930f90750b236a78b332dcae4d78949e9b
Author: Andrew Pitonyak <andrew pitonyak org>
Date:   Sun Nov 15 00:26:04 2009 -0500

    QuickMask concepts updates.

 src/concepts/qmask.xml |   73 +++++++++++++++++++++++------------------------
 src/using/qmask.xml    |    6 ++--
 2 files changed, 39 insertions(+), 40 deletions(-)
---
diff --git a/src/concepts/qmask.xml b/src/concepts/qmask.xml
index 6bd5c71..aa058a1 100644
--- a/src/concepts/qmask.xml
+++ b/src/concepts/qmask.xml
@@ -28,21 +28,19 @@
     </mediaobject>
   </figure>
   <para>
-    The <link linkend="gimp-tools-selection">selection tools</link>
-    sometimes show their limits when they have to be used for creating a
-    complex selection. In these cases, using the QuickMask can make
-    things much easier.  Simply put, the QuickMask allows you to paint a
-    selection instead of just tracing its outline.
+    The usual <link linkend="gimp-tools-selection">selection tools</link>
+    involve tracing an outline around an area of interest, which does not
+    work well for some complex selections. The QuickMask, however, allows
+    you to paint a selection instead of just tracing its outline.
   </para>
 
   <sect2 id="gimp-image-window-qmask-overview">
     <title>Overview</title>
     <para>
-      Normally when you create a selection in <acronym>GIMP</acronym>, you see
-      it represented by
-      the "marching ants" that trace along its outline. But really there may
-      be a lot more to a selection than the marching ants show you: in
-      <acronym>GIMP</acronym> a
+      Normally, a selection in <acronym>GIMP</acronym> is represented by
+      "marching ants" that trace the selection outline, but there may
+      be more to a selection than the marching ants show.
+      A <acronym>GIMP</acronym>
       selection is actually a full-fledged grayscale channel, covering the
       image, with pixel values ranging from 0 (unselected) to 255 (fully
       selected). The marching ants are drawn along a contour of half-selected
@@ -50,57 +48,58 @@
       outside the boundary is really just a slice through a continuum.
     </para>
     <para>
-      The QuickMask is <acronym>GIMP</acronym>'s way of showing you the full
-      structure of the
-      selection. Activating it also gives you the ability to interact with the
-      selection in new, and substantially more powerful, ways. To activate the
-      QuickMask, click on the small red-outlined button at the lower left of
-      the image window. The button is a toggle, so clicking it again will
-      return you to normal marching-ant mode. You can also activate the
-      QuickMask by selecting in the image window menu
+      The QuickMask is <acronym>GIMP</acronym>'s way of showing the full
+      structure of the selection.
+      QuickMask also provides the ability to interact with the
+      selection in new, and substantially more powerful, ways.
+      Click the small outlined button at the lower left of the image window to
+      toggle QuickMask on and off. The button switches between QuickMask
+      mode, and marching ants mode.
+      You can also use
       <menuchoice>
         <guimenu>Select</guimenu>
         <guimenuitem>Toggle QuickMask</guimenuitem>
-      </menuchoice>, or by using the
-      <keycombo><keycap>Shift</keycap><keycap>Q</keycap></keycombo>
-      shortcut.
+      </menuchoice>, or
+      <keycombo><keycap>Shift</keycap><keycap>Q</keycap></keycombo>,
+      to toggle between QuickMask and marching ants mode.
     </para>
     <para>
-      Activating the QuickMask shows you the selection as though it were a
+      In QuickMask mode, the selection is shown as a
       translucent screen overlying the image, whose transparency at each pixel
       indicates the degree to which that pixel is selected. By default the
       mask is shown in red, but you can change this if another mask color
-      would be more convenient. The less a pixel is selected, the more it is
+      is more convenient. The less a pixel is selected, the more it is
       obscured by the mask. Fully selected pixels are shown completely clear.
     </para>
     <para>
-      When you are in QuickMask mode, many image manipulations act on the
+      In QuickMask mode, many image manipulations act on the
       selection channel rather than the image itself. This includes, in
-      particular, paint tools. Painting with white causes the painted
-      pixels to be selected; painting with black causes them to be
-      unselected. You can use any of the paint tools, as well as the bucket
+      particular, paint tools. Painting with white selects pixels, and 
+      painting with black unselects pixels.
+      You can use any of the paint tools, as well as the bucket
       fill and gradient fill tools, in this way. Advanced users of
       <acronym>GIMP</acronym> learn that <quote>painting the selection</quote>
-      is the easiest and most effective way to delicately manipulate it.
+      is the easiest and most effective way to delicately manipulate the
+      image.
     </para>
     <tip>
       <para>
-        To save the selection done by the Quickmask to a new channel; Make
-        sure that there is a selection and that Quickmask is not active in
-        the image window. Select in the image menu
+        To save a QuickMask selection to a new channel; Make
+        sure that there is a selection and that QuickMask mode is not
+        active in the image window. Use
         <menuchoice>
           <guimenu>Select</guimenu>
           <guimenuitem>Save to Channel</guimenuitem>
         </menuchoice>.
-        This will create a new channel in the channel dialog called
-        <quote>SelectionMask copy</quote> (if you repeat this command you
-        will create a <quote>..copy#1</quote>, <quote>...copy#2</quote> and
+        to create a new channel in the channel dialog called
+        <quote>SelectionMask copy</quote> (repeating this command
+        creates <quote>..copy#1</quote>, <quote>...copy#2</quote> and
         so on...).
       </para>
     </tip>
     <tip>
       <para>
-        When QuickMask is active, Cut and Paste act on the selection rather
+        In QuickMask mode, Cut and Paste act on the selection rather
         than the image. You can sometimes make use of this as the most
         convenient way of transferring a selection from one image to another.
       </para>
@@ -129,8 +128,8 @@
       </listitem>
       <listitem>
         <para>
-          By choosing <quote>Configure Color and Opacity</quote>, you can
-          bring up a dialog that allows you to set these to values other
+          Use <quote>Configure Color and Opacity</quote> to open
+          a dialog that allows you to set these to values other
           than the defaults, which are red at 50% opacity.
         </para>
       </listitem>
diff --git a/src/using/qmask.xml b/src/using/qmask.xml
index 07c7783..04a6400 100644
--- a/src/using/qmask.xml
+++ b/src/using/qmask.xml
@@ -8,7 +8,7 @@
 -->
 <sect1 id="gimp-using-quickmask">
   <title>
-    <phrase>Using the Quickmask</phrase>
+    <phrase>Using the QuickMask</phrase>
   </title>
   <indexterm>
     <primary>Masks</primary>
@@ -21,7 +21,7 @@
     </step>
     <step>
       <para>
-        Activate the Quickmask using the left-bottom button in the image
+        Activate the QuickMask using the left-bottom button in the image
         window. If a selection is present the mask is initialized with the
         content of the selection.
       </para>
@@ -39,7 +39,7 @@
     </step>
     <step>
       <para>
-        Toggle off the Quickmask using the left-bottom button in the image
+        Toggle off the QuickMask using the left-bottom button in the image
         window: the selection will be displayed with its marching ants.
       </para>
     </step>