[gimp-help-2] Minor enhancements of src files



commit 40bb114fdf9905c9c621cd2837e4801c4797299a
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Thu Apr 23 18:41:39 2009 +0200

    Minor enhancements of src files
---
 ChangeLog                      |   10 ++++
 src/filters/map/smalltiles.xml |   93 +++++++++++++++++++--------------------
 src/glossary/glossary.xml      |   69 +++++++++++++++++-------------
 src/introduction.xml           |   22 ++++------
 src/toolbox/tool-transform.xml |    2 +-
 src/toolbox/tool-zoom.xml      |   19 +++-----
 6 files changed, 112 insertions(+), 103 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 94ec20f..65fdb15 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 2009-04-23  Ulf-D. Ehlert  <ulfehlert svn gnome org>
 
+	Minor enhancements of src files:
+
+	* src/introduction.xml
+	* src/filters/map/smalltiles.xml
+	* src/glossary/glossary.xml
+	* src/toolbox/tool-transform.xml
+	* src/toolbox/tool-zoom.xml
+
+2009-04-23  Ulf-D. Ehlert  <ulfehlert svn gnome org>
+
 	Re-format Curves tool examples
 
 	* src/toolbox/tool-curves.xml: Use more sections
diff --git a/src/filters/map/smalltiles.xml b/src/filters/map/smalltiles.xml
index c22e31a..991f25d 100644
--- a/src/filters/map/smalltiles.xml
+++ b/src/filters/map/smalltiles.xml
@@ -1,23 +1,14 @@
 <?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:
   2007-09-05 AntI: added 'es'
   2007-05-07 KoSt: added 'no'
   2005-11-15: created by julien hardelin
 -->
 <sect2 id="plug-in-small-tiles">
-  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2005-11-15</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>
-  <title>
-    <phrase>Small Tiles</phrase>
-  </title>
+  <title>Small Tiles</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Map</secondary>
@@ -26,19 +17,15 @@
   <indexterm>
     <primary>Small Tiles</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>
-          Example for the <quote>Small Tiles</quote> filter
-        </phrase>
-      </title>
+      <title>Example for the <quote>Small Tiles</quote> filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/taj_orig.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
         </imageobject>
         <caption>
           <para>Original image</para>
@@ -46,7 +33,8 @@
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/map-taj-smalltile.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/map-taj-smalltile.jpg"/>
         </imageobject>
         <caption/>
       </mediaobject>
@@ -56,36 +44,36 @@
       displays it in many copies inside the original image.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Activate the filter</phrase>
-    </title>
+    <title>Activate the filter</title>
     <para>
       You can find this filter through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Map</guisubmenu><guimenuitem>Small Tiles</guimenuitem></menuchoice>.
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Map</guisubmenu>
+        <guimenuitem>Small Tiles</guimenuitem>
+      </menuchoice>.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Small Tiles</quote> filter options</phrase>
-      </title>
+      <title><quote>Small Tiles</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/options-map-smalltiles.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/options-map-smalltiles.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>
-          <phrase>Number of Segments</phrase>
-        </term>
+        <term>Number of Segments</term>
         <listitem>
-          <para><guilabel>n²</guilabel> means <quote>the image into n to
+          <para>
+            <guilabel>n²</guilabel> means <quote>the image into n to
             the power of two tiles</quote>, where <quote>n</quote> is the
             number  you set with the slider or its input box. n = 3 will
             make nine tiles in the image.
@@ -93,9 +81,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>
-          <phrase>Opacity</phrase>
-        </term>
+        <term>Opacity</term>
         <listitem>
           <para>
             With this slider and its input box, you can set the opacity of
@@ -105,9 +91,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>
-          <phrase>Flip</phrase>
-        </term>
+        <term>Flip</term>
         <listitem>
           <para>
             You can flip tiles according to the
@@ -117,14 +101,27 @@
           </para>
           <para>
             You can also decide which tiles will be flipped:
-            <itemizedlist><listitem><para><guilabel>All tiles</guilabel>: no comment.
-                </para></listitem><listitem><para><guilabel>Alternate tiles</guilabel>: only odd tiles will
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <guilabel>All tiles</guilabel>: no comment.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Alternate tiles</guilabel>: only odd tiles will
                   be flipped.
-                </para></listitem><listitem><para><guilabel>Explicit tile</guilabel>: you can define, a
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Explicit tile</guilabel>: you can define, a
                   particular tile by using both <guilabel>Line</guilabel>
                   and <guilabel>Column</guilabel> input boxes. This tile
                   will be marked with a box in Preview.
-                </para></listitem></itemizedlist>
+                </para>
+              </listitem>
+            </itemizedlist>
           </para>
         </listitem>
       </varlistentry>
diff --git a/src/glossary/glossary.xml b/src/glossary/glossary.xml
index ac507a9..4fa9f03 100644
--- a/src/glossary/glossary.xml
+++ b/src/glossary/glossary.xml
@@ -166,6 +166,7 @@
       </para>
     </glossdef>
   </glossentry>
+
   <glossentry id="glossary-bitmap">
     <glossterm>
       <phrase>Bitmap</phrase>
@@ -174,26 +175,26 @@
       <para>
         From
         <emphasis>
-          The Free On-line Dictionary of Computing (13 Mar 01)
+          The Free Online Dictionary of Computing (13 Mar 01)
         </emphasis>:
         <blockquote><para>
-            bitmap â?? A data file or structure which corresponds bit for bit
-            with an image displayed on a screen, probably in the same format
-            as it would be stored in the display's video memory or maybe as a
-            device independent bitmap. A bitmap is characterised by the width
-            and height of the image in pixels and the number of bits per pixel
-            which determines the number of shades of grey or colours it can
-            represent. A bitmap representing a coloured image (a
-            <quote>pixmap</quote>
-            ) will usually have pixels with between one and eight bits for
-            each of the red, green, and blue components, though other colour
-            encodings are also used. The green component sometimes has more
-            bits than the other two to cater for the human eye's greater
-            discrimination in this component.
+            bitmap &mdash; A data file or structure which corresponds bit for
+            bit with an image displayed on a screen, probably in the same
+            format as it would be stored in the display's video memory or
+            maybe as a device independent bitmap. A bitmap is characterised by
+            the width and height of the image in pixels and the number of bits
+            per pixel which determines the number of shades of grey or colours
+            it can represent. A bitmap representing a coloured image (a
+            <quote>pixmap</quote>) will usually have pixels with between one
+            and eight bits for each of the red, green, and blue components,
+            though other colour encodings are also used. The green component
+            sometimes has more bits than the other two to cater for the human
+            eye's greater discrimination in this component.
           </para></blockquote>
       </para>
     </glossdef>
   </glossentry>
+
   <glossentry id="glossary-bmp">
     <glossterm>
       <anchor id="file-bmp-load" xreflabel="BMP"/>
@@ -408,6 +409,7 @@
       </para>
     </glossdef>
   </glossentry>
+
   <glossentry id="glossary-colordepth">
     <glossterm>
       <phrase>Color depth</phrase>
@@ -420,15 +422,18 @@
     </indexterm>
     <glossdef>
       <para>
-        Color Depth is simply the number of bits used to represent a color
+        Color depth is simply the number of bits used to represent a color
         (bits per pixel : bpp). There are 3 channels for a pixel (for Red,
         Green and Blue). <acronym>GIMP</acronym> can supprt 8 bits per
-        channel, referred as <emphasis>eight-bit color</emphasis>. So, GIMP
-        color depth is 8 * 3 = 24, which allows 256 * 256 * 256 =  16,777,216
-        possible colors (8 bits allow 256 colors).
+        channel, referred as <emphasis>eight-bit color</emphasis>. So,
+        <acronym>GIMP</acronym> color depth is 8&nbsp;*&nbsp;3&nbsp;=&nbsp;24,
+        which allows
+        256&nbsp;*&nbsp;256&nbsp;*&nbsp;256&nbsp;=&nbsp;16,777,216 possible
+        colors (8 bits allow 256 colors).
       </para>
     </glossdef>
   </glossentry>
+
   <glossentry id="glossary-colormodel">
     <glossterm>
       <phrase>Color model</phrase>
@@ -1290,24 +1295,28 @@
         You can view and manage the layers of the image through the
         <link linkend="gimp-layer-dialog">Layers dialog</link>.
       </para>
-      <para>Representation of an image with layers:</para>
-      <para>
-        <inlinemediaobject>
+      <figure>
+        <title>Example image with layers</title>
+        <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/layers_overview.png" format="PNG"/>
+            <imagedata format="PNG"
+              fileref="images/dialogs/layers_overview.png"/>
           </imageobject>
-        </inlinemediaobject>
-      </para>
-      <para>The final image:</para>
-      <para>
-        <inlinemediaobject>
+          <caption>
+            <para>Representation of an image with layers</para>
+          </caption>
+        </mediaobject>
+        <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/layers_example.png" format="PNG"/>
+            <imagedata format="PNG"
+              fileref="images/dialogs/layers_example.png"/>
           </imageobject>
-        </inlinemediaobject>
-      </para>
+          <caption><para>The final image</para></caption>
+        </mediaobject>
+      </figure>
     </glossdef>
   </glossentry>
+
   <glossentry id="glossary-marching-ants">
     <glossterm>
       <phrase>Marching Ants</phrase>
diff --git a/src/introduction.xml b/src/introduction.xml
index 94d7497..6e6d10c 100644
--- a/src/introduction.xml
+++ b/src/introduction.xml
@@ -12,21 +12,14 @@
   2005-11-01 Addition en;fr in Language by julien hardelin
 -->
 <sect1 id="introduction-gimp">
-  <!--sect1info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2005-11-01</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect1info-->
   <title>Welcome to GIMP</title>
+
   <indexterm>
     <primary>GIMP</primary>
     <secondary>Introduction</secondary>
   </indexterm>
-  <para><acronym>GIMP</acronym> is a multi-platform photo
+  <para>
+    <acronym>GIMP</acronym> is a multi-platform photo
     manipulation tool. <acronym>GIMP</acronym> is an acronym for
     <acronym>GNU</acronym> Image Manipulation Program. The
     <acronym>GIMP</acronym> is suitable for a variety of image
@@ -56,11 +49,12 @@
     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>
+
   <sect2 id="authors">
     <title>Authors</title>
     <para>
@@ -73,6 +67,7 @@
       <acronym>GIMP</acronym>-Team.
     </para>
   </sect2>
+
   <sect2 id="introduction-help">
     <title>The GIMP Help system</title>
     <para>
@@ -81,7 +76,7 @@
       how to use <acronym>GIMP</acronym>. The User Manual is
       an important part of this help. The current version is on
       the <ulink url="http://docs.gimp.org";>web site</ulink> of the
-      Documenation Team in HTML format. The HTML version is also available
+      Documentation Team in HTML format. The HTML version is also available
       as context sensitive help (if you installed it)
       while using <acronym>GIMP</acronym> by pressing the
       <keycap>F1</keycap> key. Help on specific menu items can be accessed
@@ -90,6 +85,7 @@
       <acronym>GIMP</acronym> journey.
     </para>
   </sect2>
+
   <sect2 id="introduction-features">
     <title>Features and Capabilities</title>
     <para>
diff --git a/src/toolbox/tool-transform.xml b/src/toolbox/tool-transform.xml
index 12f97b3..b0ffe27 100644
--- a/src/toolbox/tool-transform.xml
+++ b/src/toolbox/tool-transform.xml
@@ -61,7 +61,7 @@
           </para>
           <note>
             <para>
-              Remind that the Transform option persists when you quit the
+              Remember that the Transform option persists when you quit the
               tool.
             </para>
           </note>
diff --git a/src/toolbox/tool-zoom.xml b/src/toolbox/tool-zoom.xml
index e7e42be..daa3946 100644
--- a/src/toolbox/tool-zoom.xml
+++ b/src/toolbox/tool-zoom.xml
@@ -1,5 +1,6 @@
 <?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-04-04 j.h: review for v2.6. Magnify -> Zoom
   2008-02-28 j.h: added Ctrl+mouse wheel en;fr
@@ -47,7 +48,7 @@
     <itemizedlist>
       <listitem>
         <para>
-          You can get to the Tool Tool from the image-menu through :
+          You can get to the Zoom Tool from the image-menu through :
           <menuchoice>
             <guimenu>Tools</guimenu>
             <guisubmenu>Zoom</guisubmenu>
@@ -68,14 +69,10 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
-        <term>
-          <keycap>Ctrl</keycap>
-        </term>
+        <term><keycap>Ctrl</keycap></term>
         <listitem>
           <para>
             Holding <keycap>Ctrl</keycap> when clicking on a point of your
@@ -88,8 +85,7 @@
         <term>
           <keycombo>
             <keycap>Ctrl</keycap>
-            <keycap>Mouse
-              wheel</keycap>
+            <keycap>Mouse wheel</keycap>
           </keycombo>
         </term>
         <listitem>
@@ -108,7 +104,8 @@
       <title>Zoom tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-zoom.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/toolbox/tool-options-zoom.png"/>
         </imageobject>
       </mediaobject>
     </figure>



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