[kde-doc-english] [wacomtablet] doc/user: further additions to the docbook

[Jörg Ehrichs]

Git commit a52163902f70cf78c2e72860c02479bd5e17f3c1 by Jörg Ehrichs.
Committed on 17/03/2013 at 09:50.
Pushed by jehrichs into branch 'master'.

further additions to the docbook

M  +33   -24   doc/user/index.docbook

http://commits.kde.org/wacomtablet/a52163902f70cf78c2e72860c02479bd5e17f3c1

diff --git a/doc/user/index.docbook b/doc/user/index.docbook
index 88d137f..038bb8b 100644
--- a/doc/user/index.docbook
+++ b/doc/user/index.docbook
@@ -203,7 +203,7 @@
        <sect2 id="tablet-area-mapping">
            <title>Tablet Mapping</title>
            <para>
-               This mapping allows to specify the proportions of the tablet that will be used for each screen. This is necessary to keep the tablet area proportional to the used screen space in absolute stylus tracking mode.
+               This mapping allows to specify the proportions of the tablet that will be used for each screen. This is necessary to keep the tablet area proportional to the used screen space in absolute stylus tracking mode. For more information check the <link linkend="area-selection">Area Selection Dialog</link> section.
            </para>
            <note>
                <para>
@@ -275,7 +275,7 @@
        <sect2 id="touch-area-mapping">
            <title>Touch Mapping</title>
            <para>
-               This mapping allows to specify the proportions of the touch device that will be used for each screen. This is necessary to keep the tablet area proportional to the used screen space in absolute stylus tracking mode.
+               This mapping allows to specify the proportions of the touch device that will be used for each screen. This is necessary to keep the tablet area proportional to the used screen space in absolute stylus tracking mode. For more information check the <link linkend="area-selection">Area Selection Dialog</link> section.
            </para>
            <note>
                <para>
@@ -291,6 +291,20 @@
         <title>Presscurve Dialog</title>
 
         <para>
+            <screenshot>
+                <screeninfo>Here's a screenshot of the Presscurve Dialog</screeninfo>
+                <mediaobject>
+                    <imageobject>
+                        <imagedata fileref="presscurve.png" format="PNG"/>
+                    </imageobject>
+                    <textobject>
+                        <phrase>Changing the Presscurve</phrase>
+                    </textobject>
+                </mediaobject>
+            </screenshot>
+        </para>
+
+        <para>
             The Presscurve defines how the pressure of the stylus is translated. The Presscurve is defined via four points of a Bézier curve.
             To change this curve you can alter the red dots and move the curve around.
         </para>
@@ -300,24 +314,24 @@
                 A blue area below the curve shows the applied pressure of the pen.
             </para>
         </note>
+    </sect1>
+
+    <sect1 id="area-selection">
+        <title>Area Selection Dialog</title>
 
         <para>
             <screenshot>
-                <screeninfo>Here's a screenshot of the Presscurve Dialog</screeninfo>
+                <screeninfo>Here's a screenshot of the Tablet Area Dialog</screeninfo>
                 <mediaobject>
                     <imageobject>
-                        <imagedata fileref="presscurve.png" format="PNG"/>
+                        <imagedata fileref="tabletarea.png" format="PNG"/>
                     </imageobject>
                     <textobject>
-                        <phrase>Changing the Presscurve</phrase>
+                        <phrase>Defining the Tablet Area</phrase>
                     </textobject>
                 </mediaobject>
             </screenshot>
         </para>
-    </sect1>
-
-    <sect1 id="area-selection">
-        <title>Area Selection Dialog</title>
 
         <para>
             This dialog allows to specify the available tablet area for each selected screen space. In order to keep the aspect ratio of the tablet it
@@ -325,7 +339,16 @@
         </para>
         <para>
             Use the <guilabel>Toggle Screen</guilabel> button to switch between fullscreen (all connected monitors) and each individual monitor.
-            The settings will be saved for each screen configuration and applied to the tablet whenever the screen are switched by the global shortcut action.
+            The settings will be saved for each screen configuration and applied to the tablet whenever the screen selection is switched by the global shortcut action.
+        </para>
+        <para>
+            If you want to keep the aspect ratio of the tablet with the current screen selection you can press the <guilabel>Set Screen Proportions</guilabel> button. The tablet area will be calculated and changed automatically.
+        </para>
+        <para>
+        In addition you can open the <guilabel>Calibrate</guilabel> dialog to calibrate your tablet with the help of four points on the screen.
+        </para>
+        <para>
+            When the dialog is closed, the last selected screen will be used. If you want to switch the screen later on, you can use the <link linkend="tablet-general">Global Shortcut</link>.
         </para>
         <note>
             <para>
@@ -333,20 +356,6 @@
                 In relative mode the full tablet is used.
             </para>
         </note>
-
-        <para>
-            <screenshot>
-                <screeninfo>Here's a screenshot of the Tablet Area Dialog</screeninfo>
-                <mediaobject>
-                    <imageobject>
-                        <imagedata fileref="tabletarea.png" format="PNG"/>
-                    </imageobject>
-                    <textobject>
-                        <phrase>Defining the Tablet Area</phrase>
-                    </textobject>
-                </mediaobject>
-            </screenshot>
-        </para>
     </sect1>
     </chapter>