GNOME.org
 

[gimp-help-2] Minor changes to chapter 5 primarily for active tense and consistent usage.

commit a835c678b7eb289e525d203be3d7d0985ef09cc6
Author: Andrew Pitonyak <andrew pitonyak org>
Date:   Thu Aug 13 01:51:38 2009 -0400

    Minor changes to chapter 5 primarily for active tense and consistent usage.

 src/concepts/image-types.xml    |   36 +++++----
 src/concepts/images-loading.xml |  168 +++++++++++++++++++++------------------
 src/concepts/images.xml         |   14 ++--
 3 files changed, 115 insertions(+), 103 deletions(-)
---
diff --git a/src/concepts/image-types.xml b/src/concepts/image-types.xml
index bb947a8..528f71d 100644
--- a/src/concepts/image-types.xml
+++ b/src/concepts/image-types.xml
@@ -19,13 +19,13 @@
     It is tempting to think of an <emphasis>image</emphasis> as
     something that corresponds with a single display window, or to a
     single file such as a <link linkend="file-jpeg-load">JPEG</link>
-    file, but really a <acronym>GIMP</acronym> image is a rather complicated
-    structure,
+    file. In reality, however, a <acronym>GIMP</acronym> image is a
+    a complicated structure,
     containing a stack of layers plus several other types of objects:
     a selection mask, a set of channels, a set of paths, an "undo"
-    history, etc.  In this section we are going to take a detailed
-    look at all of the components of an image, and the things you can
-    do with them.
+    history, etc.  In this section we take a detailed
+    look at the components of a <acronym>GIMP</acronym> image,
+    and the things that you can do with them.
   </para>
   <para>
     The most basic property of an image is its
@@ -34,9 +34,8 @@
     for Red-Green-Blue, and indicates that each point in the image
     is represented by a <quote>red</quote> level, a <quote>green</quote>
     level, and a <quote>blue</quote>
-    level.  Because every humanly distinguishable color can be
-    represented as a combination of red, green, and blue, RGB images
-    are full-color.  Each color channel has 256 possible intensity
+    level; representing a full-color image.
+    Each color channel has 256 possible intensity
     levels. More details in <link linkend="glossary-colormodel">
     Color Models</link>
   </para>
@@ -55,8 +54,8 @@
       </imageobject>
       <caption>
         <para>
-          In the RGB Color Model, mixing Red, Green and Blue gives White.
-          That's what happens on your screen.
+          In the RGB Color Model, mixing Red, Green and Blue gives White,
+          which is what happens on your screen.
         </para>
       </caption>
     </mediaobject>
@@ -67,7 +66,7 @@
       <caption>
         <para>
           In the CMY(K) color model, mixing Cyan, Magenta and Yellow gives
-          Black. That's what happens when you print on a white paper. The
+          Black, which is what happens when you print on a white paper. The
           printer will actually use the black cartridge for economical
           reasons and better color rendering.
         </para>
@@ -75,7 +74,7 @@
     </mediaobject>
   </figure>
   <para>
-    Essentially the difference between a grayscale image and an RGB
+    Conceptually, the difference between a grayscale image and an RGB
     image is the number of <quote>color channels</quote>: a grayscale image
     has one; an RGB image has three.  An RGB image can be thought of as
     three superimposed grayscale images, one colored red, one green,
@@ -83,13 +82,16 @@
   </para>
   <para>
     Actually, both RGB and grayscale images have one additional
-    color channel, called the <emphasis>alpha</emphasis> channel,
-    representing opacity.  When the alpha value at a given location
-    in a given layer is zero, the layer is completely transparent,
+    color channel called the <emphasis>alpha</emphasis> channel, which
+    represents opacity.  When the alpha value at a given location
+    in a given layer is zero, the layer is completely transparent
+    (you can see through it),
     and the color at that location is determined by what lies
-    underneath.  When alpha is maximal, the layer is opaque, and the
+    underneath.  When alpha is maximal (255), the layer is opaque
+    (you cannot see through it), and the
     color is determined by the color of the layer.  Intermediate
-    alpha values correspond to varying degrees of translucency:  the
+    alpha values correspond to varying degrees of transparency / opacity:
+    the
     color at the location is a proportional mixture of color from the
     layer and color from underneath.
   </para>
diff --git a/src/concepts/images-loading.xml b/src/concepts/images-loading.xml
index 5bf7878..f3e77da 100644
--- a/src/concepts/images-loading.xml
+++ b/src/concepts/images-loading.xml
@@ -22,36 +22,35 @@
   <sect2 id="gimp-using-open-file">
     <title>Open File</title>
     <para>
-      The most obvious is to open it using a menu, by choosing
+      The most obvious way to open open an existing image is the menu.
+      Use 
       <menuchoice>
         <guimenu>File</guimenu>
         <guimenuitem>Open</guimenuitem>
       </menuchoice>
-      from an image menu. This brings up a File Browser dialog, allowing you
+      to open the <guilabel>Open Image</guilabel> dialog,allowing you
       to navigate to the file and click on its name. This method works well
-      if you know the name of the file you want to open, and where it is
-      located. It is not so convenient if you want to find the file on the
-      basis of a thumbnail.
+      if you know the name and location of the file you want to open.
+      Although the <guilabel>Open Image</guilabel> dialog does have a
+      preview pane, it is not convenient (easy) to find an image based on
+      a thumbnail.
     </para>
     <note>
       <para>
-        When you open a file, using the File menu or any other method,
-        <acronym>GIMP</acronym>
-        needs to determine what type of file it is. Unless there is no
-        alternative, <acronym>GIMP</acronym>
-        does not simply rely on the extension (such as ".jpg") to determine the
-        file type, because extensions are not reliable: they vary from system to
+        While opening a file, <acronym>GIMP</acronym> must determine the file
+        type. Unfortunately, the file extension, such as ".jpg", is not
+        reliable: file extensions vary from system to
         system; any file can be renamed to have any extension; and there are
-        many reasons why a file name might lack an extension. Instead,
+        many reasons why a file name might lack an extension.
         <acronym>GIMP</acronym>
         first tries to recognize a file by examining its contents: most of the
-        commonly used graphics file formats have "magic headers" that permit
+        commonly used file formats have "magic headers" that permit
         them to be recognized. Only if the magic yields no result does
-        <acronym>GIMP</acronym> resort to using the extension.
+        <acronym>GIMP</acronym> resort to using the extension.        
       </para>
     </note>
     <figure>
-      <title>The <quote>File Open</quote> dialog</title>
+      <title>The <quote>Open Image</quote> dialog</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/using/file-open-dialog.png" format="PNG"/>
@@ -60,27 +59,30 @@
     </figure>
     <para>
       <acronym>GIMP</acronym>
-      2.2 introduced a new File Chooser that provides several features to help
-      you navigate quickly to the file you are looking for. Perhaps the most
-      important is the ability to create <quote>bookmarks</quote>
+      2.2 introduced a new <guilabel>Open Image</guilabel> dialog that
+      provides several features to help
+      you navigate quickly to a file. Perhaps the most
+      important is the ability to create <quote>bookmarks</quote>, or
+      <guilabel>Places</guilabel>, 
       for folders that you use often. Your list of bookmarks appears on the
-      left side of the dialog. The ones at the top ( <quote>Home</quote>,
-      <quote>Desktop</quote>, etc) come automatically; the
-      others you create using the <quote>Add</quote>
-      button at the bottom of the list. Double-clicking on a bookmark takes
-      you straight to that directory.
+      left side of the dialog. The ones at the top, such as
+      <quote>Desktop</quote>, are provided automatically. Use the
+      the <guilabel>Add</guilabel> button to add the current directory to
+      the list. Use the <guilabel>Remove</guilabel> button to remove the
+      selected bookmark. Double-click on a bookmark to navigate directly 
+      to that directory.
     </para>
     <para>
-      At the center of the dialog appears a listing of the contents of the
+      The center of the dialog contains a listing of the contents of the
       selected directory. Subdirectories are shown at the top of the list,
-      files below them. By default all files in the directory are listed, but
+      files below them. By default, all files in the directory are listed, but
       you can restrict the listing to image files of a specific type using the
       File Type selection menu that appears beneath the directory listing.
     </para>
     <para>
-      When you click on a file entry in the listing, if it is an image file, a
-      preview will appear on the right side of the dialog, along with some
-      basic information about the properties of the image. Note that previews
+      When you select an image file entry in the listing, a
+      preview appears on the right side of the dialog, along with some
+      basic information about the image. Note that previews
       are cached when they are generated, and there are some things you can do
       that may cause a preview to be incorrect. If you suspect that this may
       be happening, you can force a new preview to be generated by holding
@@ -90,21 +92,23 @@
       By default, a <guilabel>Location</guilabel> text box is present in the
       File Open dialog. It may be absent: the
       <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo> key
-      combination toggles this text box.
+      combination toggles this text box. Alternatively, you can click on
+      the icon of the paper and pencil in the upper left corner to toggle the
+      text box.
     </para>
     <note>
       <para>
-        In the great majority of cases, if you select a file name from the
+        If you select a file name from the
         list, and click the <quote>Open</quote> button in the lower right
-        corner or the dialog, <acronym>GIMP</acronym> will automatically
+        corner or the dialog, it is almost always true that 
+        <acronym>GIMP</acronym> will automatically
         determine the file type for you.  On rare occasions, mainly if the
         file type is unusual and the name lacks a meaningful extension,
-        this may fail. If this happens, you can tell
-        <acronym>GIMP</acronym> specifically what type of file it is by
-        expanding the <quote>Select File Typ</quote> option at the bottom
-        of the dialog, and choosing an entry from the list that appears.
+        <acronym>GIMP</acronym> may fail to correctly identify the file
+        type. Use <guilabel>Select File Type</guilabel> at the bottom
+        of the dialog to manually specify the file type if this is required.
         More commonly, though, if <acronym>GIMP</acronym> fails to open an
-        image file, it is either corrupt or not in a supported format.
+        image file, it is either corrupt or not a supported format.
       </para>
     </note>
   </sect2>
@@ -141,30 +145,28 @@
   <sect2 id="gimp-using-open-recent">
     <title>Open Recent</title>
     <para>
-      If the image is one that you previously created using
-      <acronym>GIMP</acronym>,
-      perhaps the easiest way to open it is from the menu, using
+      The easiest way to open an image that was recently open in
+      <acronym>GIMP</acronym>, may be using
       <menuchoice>
         <guimenu>File</guimenu>
         <guimenuitem>Open Recent</guimenuitem>
       </menuchoice>.
-      This gives you a scrollable list of the images you
-      have most recently worked on in, with icons beside them.
-      You need only select the one you want, and it will be
-      opened.
+      This displays a scrollable list of the mostly recently opened
+      images with icons beside them.
+      Select and open the desired image.
     </para>
   </sect2>
 
   <sect2 id="gimp-using-external-programs">
     <title>Using External Programs</title>
     <para>
-      <acronym>GIMP</acronym> uses plugins for reading and writing graphics
+      <acronym>GIMP</acronym> uses plugins for reading and writing all
       file formats except XCF. These plugins may use external libraries or
-      programs. For example, <acronym>GIMP</acronym> does not support
-      <link linkend="glossary-postscript">PostScript</link> directly. Instead,
+      programs. For example, <acronym>GIMP</acronym> does not directly support
+      <link linkend="glossary-postscript">PostScript</link>. Instead,
       for reading (or writing) PostScript files (file extension
       <filename class="extension">.ps</filename> or
-      <filename class="extension">.eps</filename>) <acronym>GIMP</acronym>
+      <filename class="extension">.eps</filename>), <acronym>GIMP</acronym>
       requires a powerful free software program called
       <application>Ghostscript</application>.
     </para>
@@ -202,7 +204,7 @@
         </listitem>
         <listitem>
           <para>
-            Start the executable and follow the instructions of the
+            Start the executable and follow the instructions for the
             installation procedure.
           </para>
         </listitem>
@@ -228,66 +230,74 @@
   <sect2 id="gimp-using-file-manager">
     <title>File Manager</title>
     <para>
-      If you have associated the file type of the image with
+      If you have associated an image file type with
       <acronym>GIMP</acronym>,
       either when you installed <acronym>GIMP</acronym> or later, then you
       can navigate to the file using a file manager (such as Nautilus or
       Konqueror in Linux, or Windows Explorer in Windows), and once you
-      have found it, double-click on the icon.  If things are set up
-      properly, this will cause the image to open in
-      <acronym>GIMP</acronym>.
+      have found it, double-click on the the.  If properly configured,
+      the image will open in <acronym>GIMP</acronym>.
     </para>
   </sect2>
 
   <sect2 id="gimp-using-drag-and-drop">
     <title>Drag and Drop</title>
     <para>
-      Alternatively, once you have found the file, you can click on
-      its icon and drag it into the  <acronym>GIMP</acronym> Toolbox.
-      (If instead you drag it into an existing  <acronym>GIMP</acronym>
-      image, it will be added to that image as a new layer or set of
-      layers).
+      Drag and drop a file onto the <acronym>GIMP</acronym> Toolbox
+      to open the file. Drag an image into an open
+      <acronym>GIMP</acronym> image to add dropped file as a new
+      layer, or set of layers, to the already open image.
     </para>
     <para>
-      For many applications, you can click on a displayed image (a
-      full image, not just a thumbnail) and drag it into the
-      <acronym>GIMP</acronym>
-      toolbox.
+      Many applications support dragging and dropping an image into
+      <acronym>GIMP</acronym>; for example, drag an image from
+      <application>Firefox</application> and drop it onto
+      <acronym>GIMP</acronym>'s toolbox.
     </para>
   </sect2>
 
   <sect2 id="gimp-using-open-copy-and-paste">
     <title>Copy and Paste</title>
     <para>
-      For some applications, if the application gives you a
-      way of copying the image to the clipboard (on some systems, the
-      <keycap>Print Screen</keycap> key lets you copy the screen into
-      the clipboard), you can then open
-      the image in <acronym>GIMP</acronym> by choosing
+      Use
       <menuchoice>
         <guimenu>File</guimenu>
         <guisubmenu>Create</guisubmenu>
-        <guimenuitem>From Clipboard</guimenuitem></menuchoice>
-      from the image menu.  Support for this is somewhat
-      variable, however, so your best bet is to try it and see
-      whether it works.
+        <guimenuitem>From Clipboard</guimenuitem>
+      </menuchoice>
+      to create a new image from the clipboard; alternatively, you can use
+      <menuchoice>
+        <guimenu>Edit</guimenu>
+        <guisubmenu>Past as</guisubmenu>
+        <guimenuitem>New image</guimenuitem>
+      </menuchoice>.
+      Many applications support copying an image to the clipboard that can
+      then be pasted into <acronym>GIMP</acronym>. Many operating systems
+      support copying screens to the clipboard. 
+      <keycap>Print Screen</keycap> typically copies the screen to the
+      clipboard, and
+      <keycombo><keycap>ALT</keycap><keycap>Print Screen</keycap></keycombo>
+      copies only the active window. Print screen is not universally
+      supported, and just because your operating system can copy an image to
+      the clipboard, does not mean that <acronym>GIMP</acronym> can use
+      the image from the clipboard. Your best bet is to try it and see
+      if it works.
     </para>
   </sect2>
 
   <sect2  id="gimp-using-image-browser">
     <title>Image Browser</title>
     <para>
-      In Linux, you might want to take a look at a program called
-      <application>gThumb</application>, an image-management
-      application that in several ways nicely complements
-      <acronym>GIMP</acronym>.  In <application>gThumb</application>,
-      you can cause an image to open in <acronym>GIMP</acronym>
-      either by right-clicking on the icon and selecting
-      <acronym>GIMP</acronym> from among the list of options, or by
-      dragging the icon into the GIMP toolbox.
+      Linux supports an image-management application named
+      <application>gThumb</application>. Besides being an excellent
+      image browser, you can right click an image, choose 
+      <guilabel>Open with</guilabel>, then select
+      <acronym>GIMP</acronym> from the list of options. You can also
+      drag an image from <application>gThumb</application> onto the
+      <acronym>GIMP</acronym> toolbox.
       See the gThumb home page <xref linkend="bibliography-online-gthumb"/>
       for more information. Other similar applications are : GQview
-      <xref linkend="bibliography-online-gqview"/>, XnView
+      <xref linkend="bibliography-online-gqview"/>, and XnView
       <xref linkend="bibliography-online-xnview"/>.
     </para>
   </sect2>
diff --git a/src/concepts/images.xml b/src/concepts/images.xml
index ee52ce1..a9d2fbc 100644
--- a/src/concepts/images.xml
+++ b/src/concepts/images.xml
@@ -20,15 +20,15 @@
     <secondary>New image</secondary>
   </indexterm>
   <para>
-    You can create new files in <acronym>GIMP</acronym> by using the
-    following menuitem:
+    Use
     <menuchoice>
       <guimenu>File</guimenu>
       <guimenuitem>New</guimenuitem>
-    </menuchoice>.
-    This opens the <guilabel>Create a new image</guilabel> dialog,
-    where you can modify the initial width and height of the file or
-    using the standard values. More information about this dialog can
-    be found in <xref linkend="gimp-file-new"/>.
+    </menuchoice>
+    to opens the <guilabel>Create a new image</guilabel> dialog.
+    Modify the initial width and height of the file or
+    use the standard values, then create a new image file.
+    More information about the <guilabel>Create a new image</guilabel> dialog
+    can be found in <xref linkend="gimp-file-new"/>.
   </para>
 </sect1>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]