gimp-help-2 r2686 - in trunk/src: . concepts



Author: jhardlin
Date: Mon Jan 12 06:07:29 2009
New Revision: 2686
URL: http://svn.gnome.org/viewvc/gimp-help-2?rev=2686&view=rev

Log:
2009-01-12 Julien hardelin <jm hard wanadoo fr>

        * src/introduction.xml
        * src/key-reference.xml
        * src/gimp.xml
        * src/help-missing.xml
        * src/concepts/color-management.xml
        * src/concepts/docks.xml
        * src/concepts/brushes.xml
        * src/concepts/concepts.xml
        * src/concepts/basic-setup.xml: applied patch from David Richfield who
        proof-read the english language.


Modified:
   trunk/src/concepts/basic-setup.xml
   trunk/src/concepts/brushes.xml
   trunk/src/concepts/color-management.xml
   trunk/src/concepts/concepts.xml
   trunk/src/concepts/docks.xml
   trunk/src/gimp.xml
   trunk/src/help-missing.xml
   trunk/src/introduction.xml
   trunk/src/key-reference.xml

Modified: trunk/src/concepts/basic-setup.xml
==============================================================================
--- trunk/src/concepts/basic-setup.xml	(original)
+++ trunk/src/concepts/basic-setup.xml	Mon Jan 12 06:07:29 2009
@@ -60,11 +60,11 @@
     <listitem>
       <para><emphasis>An image window:</emphasis>
         Each image open in GIMP is displayed in a separate window. Many images
-        can be open at the same time: the limit is set only by the amount of
-        system resources. It is possible to run GIMP without having any images
-        open, but there are not very many useful things to do then. This
-        image window holds the Menu of the main commands of GIMP (File, Edit,
-        Select...), that you can also get by right-clicking on the window.
+	can be open at the same time, only limited by the system resources.
+	Before you can do anything useful in GIMP, you need to have at least
+	one image window open.  The image window holds the Menu of the main
+	commands of GIMP (File, Edit, Select...), which you can also get by
+	right-clicking on the window.
       </para>
     </listitem>
     <listitem>
@@ -87,20 +87,21 @@
   </orderedlist>
   <para>
     This is a minimal setup. There are over a dozen other types of dialogs
-    used by GIMP for various purposes, but users typically create them when
-    they are needed and close them when they are not. Knowledgeable users
+    used by GIMP for various purposes, but users typically open them when
+    they need them and close them when they are done. Knowledgeable users
     generally keep the Toolbox (with Tool Options) and Layers dialog around at
     all times. The Toolbox is essential to many GIMP operations; in fact, if
-    you close it, GIMP will exit. (You are asked to confirm that you want to
-    do this, though.) The Tool Options are actually a separate dialog, shown
+    you close it, GIMP will exit after confirming that that is actually what
+    you want to do. The Tool Options section is actually a separate dialog, shown
     docked to the Main Toolbox in the screenshot. Knowledgeable users almost
-    always have them set up this way: it is very difficult to use tools
+    always have it set up this way: it is very difficult to use tools
     effectively without being able to see how their options are set. The
     Layers dialog comes into play whenever you work with an image that has
     multiple layers: once you advance beyond the very most basic stages of
     GIMP expertise, this means <emphasis>almost always</emphasis>.
-    And finally, of course, the necessity of having images displayed in
-    order to work with them is perhaps obvious.
+    And of course it helps to display the images you're editing on the screen;
+    if you close the image window before saving your work, GIMP will ask you
+    whether you want to close the file.
   </para>
   <note>
     <para>
@@ -116,10 +117,10 @@
   </note>
   <para>
     Unlike some other programs, GIMP does not give you the option of putting
-    everythingâcontrols and image displaysâall into a single comprehensive
-    window. GIMP developers have always felt that this is a poor way of
-    working, because it forces the program to perform a wide range of
-    functions that are much better done by a dedicated window manager. Not
+    all your controls and image displays into a single comprehensive
+    window. The GIMP developers have always felt that this is a poor way of
+    working, because it forces the program to do the work of a
+    dedicated window manager. Not
     only would this waste a lot of programmer time, it is almost impossible to
     do in a way that works correctly across all of the operating systems GIMP
     is intended to run on.

Modified: trunk/src/concepts/brushes.xml
==============================================================================
--- trunk/src/concepts/brushes.xml	(original)
+++ trunk/src/concepts/brushes.xml	Mon Jan 12 06:07:29 2009
@@ -47,7 +47,7 @@
   <para>
     A <emphasis>brush</emphasis>
     is a pixmap or set of pixmaps used for painting. GIMP includes a set of 10
-    "paint tools", which not only perform operations that you would think of
+    "paint tools", which not only perform operations that you would normally think of
     as painting, but also operations such as erasing, copying, smudging,
     lightening or darkening, etc. All of the paint tools, except the ink tool,
     use the same set of brushes. The brush pixmaps represent the marks that
@@ -64,7 +64,7 @@
     symbol there is one way of activating the Brushes dialog.
   </para>
   <para>
-    When you install GIMP, it comes presupplied with a number of basic
+    When you install GIMP, it comes with a number of basic
     brushes, plus a few bizarre ones that serve mainly to give you examples of
     what is possible (i. e., the "green pepper" brush in the illustration).
     You can also create new brushes, or download them and install them so that
@@ -72,7 +72,7 @@
   </para>
   <para>
     GIMP can use several different types of brushes. All of them, however, are
-    used in the same way, and for most purposes you don't need to be aware of
+    used in the same way, and for most purposes you don't need to worry about
     the differences when you paint with them. Here are the available types of
     brushes:
   </para>
@@ -108,25 +108,25 @@
           <secondary>Color</secondary>
         </indexterm>
         <para>
-          Brushes in this category are represented by colored images in
-          the Brushes dialog. They can be a text. When you paint with them,
-          the colors are used as shown; the current foreground color does
-          not come into play.  Otherwise they work the same way as ordinary
-          brushes.
+	  Brushes in this category are represented by colored images in the
+	  Brushes dialog. They can be pictures or text.  When you paint with
+	  them, the colors are used as shown; the current foreground color
+	  does not come into play.  Otherwise they work the same way as
+	  ordinary brushes.
         </para>
         <para>
-          To create such a brush: Create a small RGBA image. For this, open
-          New Image, select RGB for image type and Transparent for fill type.
-          Draw your image and save it first to .xcf file to keep its
-          properties. Then save it to <emphasis>.gbr</emphasis> format. Click
-          on <emphasis>Refresh</emphasis> button in Brush Dialog to get your
-          brush without it being necessary to restart GIMP.
+	  To create such a brush: Create a small RGBA image. For this, open
+	  New Image, select RGB for image type and Transparent for fill type.
+	  Draw your image and and firs save it as a .xcf file to keep its
+	  properties. Then save it in <emphasis>.gbr</emphasis> format. Click
+	  on the <emphasis>Refresh</emphasis> button in Brush Dialog to get
+	  your brush without it being necessary to restart GIMP.
         </para>
         <tip>
           <para>
             When you do a Copy or a Cut on a selection, you see the contents
-            of the clipboard (that is the selection) on first position in the
-            brushes dialog.   And you can use it for painting.
+	    of the clipboard (that is the selection) at the first position in
+	    the brushes dialog.  And you can use it for painting.
           </para>
         </tip>
         <figure>
@@ -155,7 +155,7 @@
         </indexterm>
         <para>
           Brushes in this category can make more than one kind of mark on an
-          image. They are indicated by small red triangles at th lower right
+          image. They are indicated by small red triangles at the lower right
           corner of the brush symbol in the Brushes dialog. They are sometimes
           called "animated brushes" because the marks change as you trace out
           a brushstroke. In principle, image hose brushes can be very
@@ -190,8 +190,8 @@
     </varlistentry>
   </variablelist>
   <para>
-    Now, all brushes have a variable height. In fact, in the option box of all
-    painting tools there is a slider to enlarge or reduce the height of the
+    Now, all brushes have a variable size. In fact, in the option box of all
+    painting tools there is a slider to enlarge or reduce the size of the
     active brush. You can do this directly in the image window if you have
     set correctly your mouse wheel; see
     <link linkend="gimp-using-variable-size-brush">Varying brush size</link>.

Modified: trunk/src/concepts/color-management.xml
==============================================================================
--- trunk/src/concepts/color-management.xml	(original)
+++ trunk/src/concepts/color-management.xml	Mon Jan 12 06:07:29 2009
@@ -83,15 +83,15 @@
       </listitem>
     </orderedlist>
     <para>
-      The main purpose of color management is do avoid such problems. The
-      approach taken to do so involves the addition of an description of the
+      The main purpose of color management is to avoid such problems. The
+      approach taken to do so involves the addition of a description of the
       color characteristic to an image or devices.
     </para>
     <para>
       These descriptions are called <emphasis>color profile</emphasis>. A
       color profile is basically a look-up table to translate the specific
       color characteristic of a device to a device-independent color space -
-      the so called working-space. All the image manipulation is the done to
+      the so called working-space. All the image manipulation is then done to
       images in the working-space. In addition to that the color profile of a
       device can be used to simulate how colors would look on that device.
     </para>
@@ -151,13 +151,13 @@
         <phrase>Display</phrase>
       </title>
       <para>
-        To get best results, you need a color profile for your monitor. If a
+        For the best results, you need a color profile for your monitor. If a
         monitor profile is configured, either system-wide or in the Color
         Management section of the GIMP Preferences dialog, the image colors
         will be displayed most accurately.
       </para>
       <para>
-        One of the most important GIMP commands to work with the color
+        One of the most important GIMP commands to work with color
         management is described in
         <xref linkend="gimp-display-filter-dialog"/>.
       </para>

Modified: trunk/src/concepts/concepts.xml
==============================================================================
--- trunk/src/concepts/concepts.xml	(original)
+++ trunk/src/concepts/concepts.xml	Mon Jan 12 06:07:29 2009
@@ -48,8 +48,7 @@
           layers, a <acronym>GIMP</acronym> image may contain a selection
           mask, a set of channels, and a set of paths. In fact,
           <acronym>GIMP</acronym> provides a mechanism for attaching arbitrary
-          pieces of data to an image, as which are called
-          <quote>parasites</quote>
+          pieces of data, called <quote>parasites</quote>, to an image.
         </para>
         <para>
           In <acronym>GIMP</acronym>, it is possible to have many images open
@@ -57,8 +56,8 @@
           megabytes of memory, but <acronym>GIMP</acronym> uses a
           sophisticated tile-based memory management system that allows it to
           handle even very large images gracefully.  There are, however,
-          limits, and it is usually beneficial when working with images to put
-          as much memory into your system as possible.
+          limits, and having more memory available can help to improve the
+	  performance of the system.
         </para>
       </listitem>
     </varlistentry>
@@ -81,7 +80,7 @@
       <term>Channels</term>
       <listitem>
         <para>
-          In <acronym>GIMP</acronym> Channels are the smallest units of
+          In <acronym>GIMP</acronym>, Channels are the smallest units of
           subdivision in the stack of layers from which the image is
           constructed. Every Channel in a layer has exactly the same size as
           the layer it belongs to and consequently consists of the same
@@ -91,7 +90,7 @@
           <acronym>RGB</acronym> color model the value in the
           <emphasis>R</emphasis>-channel means the amount of red which is
           added to the colour of the different pixels, in the selection
-          channel the value denotes how strong the pixels are selected and in
+          channel the value denotes how strongly the pixels are selected and in
           the alpha channel the values denote how transparent the
           corresponding pixels are.
         </para>
@@ -125,7 +124,7 @@
           it: an assortment of selection-making tools, a menu of selection
           operations, and the ability to switch to Quick Mask mode, in which
           you can treat the selection channel as though it were a color
-          channel, thereby <quote>painting the selection</quote>
+          channel, thereby <quote>painting the selection</quote>.
         </para>
       </listitem>
     </varlistentry>
@@ -158,19 +157,19 @@
           Many, probably most, of the things you do to an image in
           <acronym>GIMP</acronym> are done by the <acronym>GIMP</acronym>
           application itself. However, <acronym>GIMP</acronym> also makes
-          extensive use of <quote>plug-ins</quote> which are external programs
+          extensive use of <quote>plug-ins</quote>, which are external programs
           that interact very closely with <acronym>GIMP</acronym>, and are
           capable of manipulating images and other <acronym>GIMP</acronym>
           objects in very sophisticated ways. Many important plug-ins come
           packaged together with <acronym>GIMP</acronym>, but there are also
-          many available by other means. In fact, the ability to write
+          many available by other means. In fact, writing
           plug-ins (and scripts) is the easiest way for people not on the
           <acronym>GIMP</acronym> development team to add new capabilities to
           <acronym>GIMP</acronym>.
         </para>
         <para>
           All of the commands in the Filters menu, and a substantial number of
-          commands in other menus, are actually implemented by plug-ins.
+          commands in other menus, are actually implemented as plug-ins.
         </para>
       </listitem>
     </varlistentry>
@@ -181,7 +180,7 @@
           In addition to plug-ins, which are programs written in the C
           language, GIMP can also make use of scripts. The largest number of
           existing scripts are written in a language called Script-Fu, which
-          is special to GIMP (for those who care, it is a dialect of the
+          is unique to GIMP (for those who care, it is a dialect of the
           Lisp-like language called Scheme). It is also possible to write GIMP
           scripts in Python or Perl. These languages are more flexible and
           powerful than Script-Fu; their disadvantage is that they depend on

Modified: trunk/src/concepts/docks.xml
==============================================================================
--- trunk/src/concepts/docks.xml	(original)
+++ trunk/src/concepts/docks.xml	Mon Jan 12 06:07:29 2009
@@ -72,7 +72,7 @@
       over the drag handle area. To dock a dialog, you simply click on its
       drag handle area, and drag it onto one of the docking bars in a dock:
       the dialog will be added to the aimed window. If you drag it onto the
-      aimed window itself, then it will be added as a tab.
+      aimed window itself, it will be added as a tab.
     </para>
     <figure id="figure-docked-dialogs">
       <title>
@@ -86,7 +86,7 @@
         </imageobject>
         <caption>
           <para>
-            This screenshot shows the area that allows to take a dialog off
+            This screenshot shows the area that can be used to take a dialog off
             the dock.
           </para>
         </caption>
@@ -159,7 +159,6 @@
     <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 on the
-
       right. 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.
@@ -245,7 +244,7 @@
             This entry detaches the dialog from the dock, creating a new dock
             with the detached dialog as its only member. It has the same
             effect as dragging the tab out of the dock and releasing it at a
-            random location.
+            location where it cannot be docked.
           </para>
         </listitem>
       </varlistentry>
@@ -279,7 +278,7 @@
             Many, but not all, dialogs have Tab menus containing a
             <guilabel>Preview Size</guilabel>
             option, which opens into a submenu giving a list of sizes for the
-            items in the dialog (cp.
+            items in the dialog (cf.
             <xref linkend="figure-gimp-dock-preview-size"/>
             ). For example, the Brushes dialog shows pictures of all available
             brushes: the Preview Size determines how large the pictures are.
@@ -308,7 +307,7 @@
           <para>
             This entry is available when multiple dialogs are in the same
             dock: it opens into a submenu allowing you to choose how the tabs
-            at the top will appear (cp.
+            at the top will appear (cf.
             <xref linkend="figure-gimp-dock-tab-style"/>
             ). There are five choices, not all of which will be available for
             all types of dialogs:
@@ -394,7 +393,7 @@
           <para>
             This is a toggle. If it is checked, then an Image Menu is shown at
             the top of the dock. It is not available for dialogs docked below
-            the Toolbox. Don't confuse this menu for the Image Menu, that is
+            the Toolbox. Don't confuse this menu with the Image Menu, that is
             the menu of the active image on your screen.
           </para>
         </listitem>

Modified: trunk/src/gimp.xml
==============================================================================
--- trunk/src/gimp.xml	(original)
+++ trunk/src/gimp.xml	Mon Jan 12 06:07:29 2009
@@ -108,8 +108,8 @@
         how to make screenshots.
       </para>
       <para><!-- new: 2007-03-15 -->
-        But in the first place we want to introduce you to the general
-        structure of images in GIMP.
+        But first we want to introduce you to the general structure of images
+        in GIMP.
       </para>
       <xi:include href="concepts/image-types.xml"/>
       <xi:include href="concepts/images.xml"/>

Modified: trunk/src/help-missing.xml
==============================================================================
--- trunk/src/help-missing.xml	(original)
+++ trunk/src/help-missing.xml	Mon Jan 12 06:07:29 2009
@@ -25,7 +25,8 @@
     Feel free to join us and fill the gap by writing documentation for
     the <acronym>GIMP</acronym>. For more information, visit our project
     page on <ulink url="http://wiki.gimp.org/gimp/GimpDocs";>the
-    <acronym>GIMP</acronym> Wiki</ulink>. There is also a <ulink url="https://lists.xcf.berkeley.edu/mailman/listinfo/gimp-docs/";>Mailing
+    <acronym>GIMP</acronym> Wiki</ulink>. There is also a
+    <ulink url="https://lists.xcf.berkeley.edu/mailman/listinfo/gimp-docs/";>Mailing
     list</ulink> available. Generally, it's a good idea to check the
     <ulink url="http://www.gimp.org";><acronym>GIMP</acronym> project
     page</ulink>.

Modified: trunk/src/introduction.xml
==============================================================================
--- trunk/src/introduction.xml	(original)
+++ trunk/src/introduction.xml	Mon Jan 12 06:07:29 2009
@@ -35,12 +35,14 @@
     image construction.
   </para>
   <para>
-    It has many capabilities. It can be used as a simple paint program, an
+    <acronym>GIMP</acronym> has many capabilities. It can be used as a
+    simple paint program, an
     expert quality photo retouching program, an online batch processing
     system, a mass production image renderer, an image format converter, etc.
   </para>
   <para>
-    GIMP is expandable and extensible. It is designed to be augmented with
+    <acronym>GIMP</acronym> is expandable and extensible. It is designed
+    to be augmented with
     plug-ins and extensions to do just about anything. The advanced scripting
     interface allows everything from the simplest task to the most complex
     image manipulation procedures to be easily scripted.
@@ -55,7 +57,8 @@
     or Apple's <productname>Mac OS X</productname>
     (<application>Darwin</application>). The <acronym>GIMP</acronym>
     is a Free Software application covered by the General Public License (
-    <ulink url="http://www.fsf.org/licensing/licenses/gpl.html";><acronym>GPL</acronym> license</ulink>). The <acronym>GPL</acronym>
+    <ulink url="http://www.fsf.org/licensing/licenses/gpl.html";><acronym>GPL</acronym> license</ulink>).
+    The <acronym>GPL</acronym>
     provides users with the freedom to access and alter the source code that
     makes up computer programs.
   </para>
@@ -69,7 +72,7 @@
       have contributed more recently, and thousands have provided support and
       testing. <acronym>GIMP</acronym>
       releases are currently being orchestrated by Sven Neumann and Mitch
-      Natterer and many other people called the
+      Natterer and the other members of the
       <acronym>GIMP</acronym>-Team.
     </para>
   </sect2>
@@ -146,14 +149,14 @@
       </listitem>
       <listitem>
         <para>
-          File formats supported include GIF, JPEG, PNG, XPM, TIFF, TGA, MPEG,
-          PS, PDF, PCX, BMP and many others
+	  Support for a wide range of file formats, including GIF, JPEG, PNG,
+	  XPM, TIFF, TGA, MPEG, PS, PDF, PCX, BMP and many others
         </para>
       </listitem>
       <listitem>
         <para>
-          Selection tools including rectangle, ellipse, free, fuzzy, bezier
-          and intelligent
+          Selection tools, including rectangle, ellipse, free, fuzzy, bezier
+          and intelligent scissors
         </para>
       </listitem>
       <listitem>

Modified: trunk/src/key-reference.xml
==============================================================================
--- trunk/src/key-reference.xml	(original)
+++ trunk/src/key-reference.xml	Mon Jan 12 06:07:29 2009
@@ -233,7 +233,7 @@
         </varlistentry>
       </variablelist>
       <note>
-        <para>Double click on the tool buttons opens the Tool Options dialog.</para>
+        <para>Double click on the tool buttons to open the Tool Options dialog.</para>
       </note>
       <variablelist>
         <title>Context</title>
@@ -494,7 +494,7 @@
       </variablelist>
       <note>
         <para> 
-          These open a new dialog window if it wasn't open yet,
+          These open a new dialog window if it isn't open yet,
           otherwise the corresponding dialog gets focus.
         </para>
       </note>
@@ -702,7 +702,7 @@
         </varlistentry>
       </variablelist>
       <note>
-        <para>This fits the windows to the image size.</para>
+        <para>This fits the window to the image size.</para>
       </note>
       <variablelist>
         <title>Scrolling (panning)</title>
@@ -780,7 +780,7 @@
       <note>
         <para>
           Drag off the horizontal or vertical ruler to create a new
-          guideline. Drag a guideline onto the ruler to delete it.
+          guideline. Drag a guideline off the image to delete it.
         </para>
       </note>
     </refsect1>
@@ -879,7 +879,7 @@
         </varlistentry>
       </variablelist>
       <note>
-        <para>This places a copy of the selection to the GIMP clipboard.</para>
+        <para>This puts a copy of the selection on the GIMP clipboard.</para>
       </note>
       <variablelist>
         <title>Fill</title>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]