[gimp-help-2] Minor changes to tools docs
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Minor changes to tools docs
- Date: Sun, 7 Mar 2010 13:03:02 +0000 (UTC)
commit a9686f3edcbc74808cf21a10e789e2a5ed5e8abb
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Tue Mar 2 21:00:49 2010 +0100
Minor changes to tools docs
... like adding links, etc.
src/toolbox/color/brightness-contrast.xml | 4 ++-
src/toolbox/color/colorize.xml | 12 +++++---
src/toolbox/color/curves.xml | 9 +++---
src/toolbox/color/levels.xml | 11 +++++---
src/toolbox/selection-tools.xml | 11 +++++++
src/toolbox/selection/common-features.xml | 8 -----
src/toolbox/tool-airbrush.xml | 8 +++--
src/toolbox/tool-brush.xml | 42 +++++++++++++++-------------
src/toolbox/tool-ink.xml | 18 +++++++++++-
src/toolbox/tools-painting.xml | 7 +++--
src/toolbox/transform-tools.xml | 15 ++++++++++
src/toolbox/transform/common-features.xml | 13 ---------
12 files changed, 96 insertions(+), 62 deletions(-)
---
diff --git a/src/toolbox/color/brightness-contrast.xml b/src/toolbox/color/brightness-contrast.xml
index 4ca7e83..2a39a71 100644
--- a/src/toolbox/color/brightness-contrast.xml
+++ b/src/toolbox/color/brightness-contrast.xml
@@ -11,11 +11,13 @@
2005-05-31 en revised Bill Skaggs
-->
<sect2 id="gimp-tool-brightness-contrast">
- <title>Brightness-Contrast tool</title>
+ <title>Brightness-Contrast</title>
+
<indexterm>
<primary>Tools</primary>
<secondary>Brightness-Contrast</secondary>
</indexterm>
+
<para>
The Brightness-Contrast tool adjusts the brightness and contrast levels
for the active layer or selection. This tool is easy to use, but
diff --git a/src/toolbox/color/colorize.xml b/src/toolbox/color/colorize.xml
index c3fff03..0648de3 100644
--- a/src/toolbox/color/colorize.xml
+++ b/src/toolbox/color/colorize.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-03-11 j.h: revised for v2.6. Added Presets
2008-01-16 j.h: updated to v2.4
@@ -12,6 +13,7 @@
-->
<sect2 id="gimp-tool-colorize">
<title>Colorize</title>
+
<indexterm>
<primary>Tools</primary>
<secondary>Colorize</secondary>
@@ -23,16 +25,18 @@
<indexterm>
<primary>Colorize</primary>
</indexterm>
+
<para>
The Colorize tool renders the active layer or selection into a greyscale
- image seen through a colored glass. You can use it to give a <quote>
- Sepia</quote> effect to your image. See
+ image seen through a colored glass. You can use it to give a
+ <quote>Sepia</quote> effect to your image. See
<xref linkend="glossary-colormodel"/> for Hue, Saturation, Luminosity.
</para>
+
<sect3>
<title>Activating tool</title>
<para>
- You can get to the Colorize tool in two ways :
+ You can get to the Colorize tool in two ways:
</para>
<itemizedlist>
<listitem>
diff --git a/src/toolbox/color/curves.xml b/src/toolbox/color/curves.xml
index dfda113..d6731e1 100644
--- a/src/toolbox/color/curves.xml
+++ b/src/toolbox/color/curves.xml
@@ -57,7 +57,7 @@
fileref="images/toolbox/stock-tool-curves-22.png"/>
</guiicon>
in Toolbox, if this tool has been installed there (see
- <link linkend="gimp-tools-dialog">Tools dialog</link>.
+ <link linkend="gimp-tools-dialog">Tools dialog</link>).
</para>
</listitem>
</itemizedlist>
@@ -297,9 +297,10 @@
<variablelist>
<title>Tool Options dialog</title>
<para>
- Although this tool is not present in Tool box, nevertheless it has a
- Tool Option Dialog under the Toolbox. These options are described
- here:
+ Although this tool is not present in the Toolbox by default (see
+ <xref linkend="gimp-tools-dialog"/> if you want to add it),
+ nevertheless it has a Tool Option Dialog under the Toolbox. These
+ options are described here:
</para>
<varlistentry>
<term>Histogram Scale</term>
diff --git a/src/toolbox/color/levels.xml b/src/toolbox/color/levels.xml
index f94437d..6030691 100644
--- a/src/toolbox/color/levels.xml
+++ b/src/toolbox/color/levels.xml
@@ -39,8 +39,9 @@
</indexterm>
<para>
- The Level tool provides features similar to the Histogram tool but can
- also change the intensity range of the active layer or selection in every
+ The Level tool provides features similar to the
+ <link linkend="gimp-histogram-dialog">Histogram</link> dialog but can also
+ change the intensity range of the active layer or selection in every
channel. This tool is used to make an image lighter or darker, to change
contrast or to correct a predominant color cast.
</para>
@@ -524,8 +525,10 @@
</figure>
</para>
<para>
- Although this tool is not present in Tool box, nevertheless it has a
- Tool Option Dialog under the Toolbox. These options are described here:
+ Although this tool is not present in the Toolbox by default (see
+ <xref linkend="gimp-tools-dialog"/> if you want to add it),
+ nevertheless it has a Tool Option Dialog under the Toolbox. These
+ options are described here:
</para>
<varlistentry>
<term>Histogram Scale</term>
diff --git a/src/toolbox/selection-tools.xml b/src/toolbox/selection-tools.xml
index d5ecfa1..6802239 100644
--- a/src/toolbox/selection-tools.xml
+++ b/src/toolbox/selection-tools.xml
@@ -1,8 +1,19 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
+
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tools-selection">
<title>Selection Tools</title>
+
+ <figure>
+ <title>The Selection tools</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/selection-tools.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
<xi:include href="selection/common-features.xml"/>
<xi:include href="selection/rectangle.xml"/>
<xi:include href="selection/ellipse.xml"/>
diff --git a/src/toolbox/selection/common-features.xml b/src/toolbox/selection/common-features.xml
index ba533f4..0ea7adf 100644
--- a/src/toolbox/selection/common-features.xml
+++ b/src/toolbox/selection/common-features.xml
@@ -21,14 +21,6 @@
<secondary>Common Features</secondary>
</indexterm>
- <figure>
- <title>The Selection tools</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/selection-tools.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
<para>
Selection tools are designed to select regions from the active layer so
you can work on them without affecting the unselected areas. Each tool has
diff --git a/src/toolbox/tool-airbrush.xml b/src/toolbox/tool-airbrush.xml
index 6e59a97..ee56ce6 100644
--- a/src/toolbox/tool-airbrush.xml
+++ b/src/toolbox/tool-airbrush.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-03-16 j.h: reviewed for v2.6. No change
2008-04-07 JPL reviewed fr
@@ -12,7 +13,8 @@
050522 de reviewed by axel.wernicke
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-airbrush">
- <title>Airbrush Tool</title>
+ <title>Airbrush</title>
+
<indexterm>
<primary>Airbrush</primary>
</indexterm>
@@ -29,11 +31,11 @@
</imageobject>
</mediaobject>
</figure>
-
<para>
The Airbrush tool emulates a traditional airbrush. This tool is suitable
for painting soft areas of color.
</para>
+
<sect3>
<title>Activating the Tool</title>
<para>You can activate the Airbrush tool in several ways :</para>
diff --git a/src/toolbox/tool-brush.xml b/src/toolbox/tool-brush.xml
index 5903eb8..cf29e88 100644
--- a/src/toolbox/tool-brush.xml
+++ b/src/toolbox/tool-brush.xml
@@ -136,19 +136,21 @@
</itemizedlist>
<para>
- The advantages of using GIMP with a tablet instead of a mouse
- probably show up more clearly for brush tools than anywhere else:
- the gain in fine control is invaluable. These tools also have
- special <quote>Pressure sensitivity</quote> options that are only usable
- with a tablet.
+ The advantages of using <acronym>GIMP</acronym> with a tablet instead of a
+ mouse probably show up more clearly for brush tools than anywhere else:
+ the gain in fine control is invaluable. These tools also have special
+ <quote>Pressure sensitivity</quote> options that are only usable with a
+ tablet.
</para>
<para>
In addition to the more common <quote>hands-on</quote> method, it is
- possible to apply brush tools in an automated way, by creating a
- selection or path and then <quote>stroking</quote> it. You can choose to
- stroke with any of the brush tools, including nonstandard ones
- such as the Eraser, Smudge tool, etc., and any options you set for
- the tool will be applied. See the section on <link linkend="gimp-selection-stroke">Stroking</link> for more information.
+ possible to apply brush tools in an automated way, by creating a selection
+ or path and then <quote>stroking</quote> it. You can choose to stroke
+ with any of the brush tools, including nonstandard ones such as the
+ Eraser, Smudge tool, etc., and any options you set for the tool will be
+ applied. See the section on
+ <link linkend="gimp-selection-stroke">Stroking</link> for more
+ information.
</para>
<sect3 id="gimp-tools-brush-modifiers">
@@ -160,14 +162,14 @@
</term>
<listitem>
<para>
- Holding down the <keycap>Ctrl</keycap> key has a special effect
- on every brush tool <!--except the ink tool-->. For the Pencil,
- Paintbrush, Airbrush, Ink Tool, and Eraser tools, it
- switches them into <quote>color picker</quote> mode, so that
- clicking on an image pixel causes GIMP's foreground to be set
- to the active layer's color at that point (or, for the Eraser,
- GIMP's background color). For the Clone tool, the
- <keycap>Ctrl</keycap> key switches it into a mode where
+ Holding down the <keycap>Ctrl</keycap> key has a special effect on
+ every brush tool. For the Pencil, Paintbrush, Airbrush, Ink Tool,
+ and Eraser tools, it switches them into <quote>color
+ picker</quote> mode, so that clicking on an image pixel causes
+ <acronym>GIMP</acronym>'s foreground to be set to the active
+ layer's color at that point (or, for the Eraser,
+ <acronym>GIMP</acronym>'s background color). For the Clone tool,
+ the <keycap>Ctrl</keycap> key switches it into a mode where
clicking sets the reference point for copying. For the Convolve
tool, the <keycap>Ctrl</keycap> key switches between blur and
sharpen modes; for the Dodge/Burn tool, it switches between
@@ -295,8 +297,8 @@
<para>
The brush determines how much of the image is affected by the
tool, and how it is affected, when you trace out a brushstroke
- with the pointer. GIMP allows you to use several different types
- of brushes, which are described in the
+ with the pointer. <acronym>GIMP</acronym> allows you to use
+ several different types of brushes, which are described in the
<link linkend="gimp-concepts-brushes">Brushes</link>
section. The same brush choices are available for all brush tools
except the Ink tool, which uses a unique type of procedurally
diff --git a/src/toolbox/tool-ink.xml b/src/toolbox/tool-ink.xml
index fe20130..edd1760 100644
--- a/src/toolbox/tool-ink.xml
+++ b/src/toolbox/tool-ink.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-03-16 j.h: reviwed for v2.6. No change
2008-04-07 JPL reviewed fr
@@ -13,6 +14,7 @@
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-ink">
<title>Ink</title>
+
<indexterm>
<primary>Tools</primary>
<secondary>Ink</secondary>
@@ -68,7 +70,19 @@
<sect3>
<title>Key modifiers (Defaults)</title>
- <para>This tool has no special modifier keys.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <keycap>Ctrl</keycap>
+ </term>
+ <listitem>
+ <para>
+ This key changes the nib to a
+ <link linkend="gimp-tool-color-picker">Color Picker</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect3>
<sect3>
diff --git a/src/toolbox/tools-painting.xml b/src/toolbox/tools-painting.xml
index 10b145d..ffc2c09 100644
--- a/src/toolbox/tools-painting.xml
+++ b/src/toolbox/tools-painting.xml
@@ -66,9 +66,10 @@
<para>
Holding down the <keycap>Ctrl</keycap> key changes each of these
tools to a <link linkend="gimp-tool-color-picker">Color
- Picker</link>: clicking on any pixel of any layer sets the
- foreground color (as displayed in the Toolbox Color Area) to the
- color of the pixel.
+ Picker</link>: clicking on any pixel of any layer sets the
+ foreground color (as displayed in the
+ <link linkend="gimp-toolbox-color-area">Toolbox Color Area</link>)
+ to the color of the pixel.
</para>
</listitem>
</varlistentry>
diff --git a/src/toolbox/transform-tools.xml b/src/toolbox/transform-tools.xml
index f6d7633..6ae1182 100644
--- a/src/toolbox/transform-tools.xml
+++ b/src/toolbox/transform-tools.xml
@@ -6,6 +6,21 @@
-->
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tools-transform">
<title>Transform Tools</title>
+
+ <indexterm>
+ <primary>Tools</primary>
+ <secondary>Transform Tools</secondary>
+ </indexterm>
+
+ <figure>
+ <title>An overview of the transform tools</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/transform-tools.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
<xi:include href="transform/common-features.xml"/>
<xi:include href="transform/align.xml"/>
<xi:include href="transform/move.xml"/>
diff --git a/src/toolbox/transform/common-features.xml b/src/toolbox/transform/common-features.xml
index d82b818..f189108 100644
--- a/src/toolbox/transform/common-features.xml
+++ b/src/toolbox/transform/common-features.xml
@@ -17,19 +17,6 @@
<sect2 id="gimp-tool-transform">
<title>Common Features</title>
- <indexterm>
- <primary>Tools</primary>
- <secondary>Transform Tools</secondary>
- </indexterm>
-
- <figure>
- <title>An overview of the transform tools</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/transform-tools.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
<para>
Inside the Transformation tool dialog, you will find eight tools to modify
the presentation of the image or the presentation of an element of the
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
