[gnome-user-docs/wip/mdh] gnome-help: update wacom pages (fixes #145)



commit 28715fc1b9ed1a45cf396ab60afd192c3b7b82ff
Author: Michael Hill <mdhillca gmail com>
Date:   Sat Apr 2 18:14:22 2022 -0400

    gnome-help: update wacom pages (fixes #145)

 gnome-help/C/wacom-left-handed.page      | 17 +++----
 gnome-help/C/wacom-map-buttons.page      | 56 ++++++++++++++++++++++
 gnome-help/C/wacom-map-buttons.page.stub | 40 ----------------
 gnome-help/C/wacom-mode.page             | 31 +++++-------
 gnome-help/C/wacom-multi-monitor.page    | 38 ++++++---------
 gnome-help/C/wacom-stylus.page           | 82 +++++++++++++-------------------
 gnome-help/Makefile.am                   |  1 +
 7 files changed, 124 insertions(+), 141 deletions(-)
---
diff --git a/gnome-help/C/wacom-left-handed.page b/gnome-help/C/wacom-left-handed.page
index 4dac004f..838143a7 100644
--- a/gnome-help/C/wacom-left-handed.page
+++ b/gnome-help/C/wacom-left-handed.page
@@ -4,12 +4,8 @@
       id="wacom-left-handed">
 
   <info>
-    <revision pkgversion="3.10" date="2013-11-02" status="review"/>
-    <revision pkgversion="3.12" date="2014-03-23" status="candidate"/>
-    <revision pkgversion="3.14" date="2014-10-12" status="candidate"/>
-    <revision pkgversion="3.18" date="2015-09-28" status="final"/>
-    <revision pkgversion="3.28" date="2018-07-22" status="review"/>
     <revision pkgversion="3.33" date="2019-07-21" status="candidate"/>
+    <revision version="gnome:42" status="final" date="2022-04-02"/>
 
     <link type="guide" xref="wacom"/>
 
@@ -37,14 +33,13 @@
   </item>
   <item>
     <p>Click on <gui>Wacom Tablet</gui> to open the panel.</p>
-  </item>  <item>
-    <p>Click the <gui>Tablet</gui> button in the header bar.</p>
     <note style="tip"><p>If no tablet is detected, you’ll be asked to
-    <gui>Please plug in or turn on your Wacom tablet</gui>. Click the
-    <gui>Bluetooth Settings</gui> link to connect a wireless tablet.</p></note>
+    <gui>Please plug in or turn on your Wacom tablet</gui>. Click
+    <gui>Bluetooth</gui> in the sidebar to connect a wireless tablet.</p></note>
+  </item>
+  <item>
+    <p>Set the <gui>Left-Handed Orientation</gui> switch to on.</p>
   </item>
-  <item><p>Switch the <gui>Left-Handed Orientation</gui> switch to
-  on.</p></item>
 </steps>
 
 </page>
diff --git a/gnome-help/C/wacom-map-buttons.page b/gnome-help/C/wacom-map-buttons.page
new file mode 100644
index 00000000..3f4405e5
--- /dev/null
+++ b/gnome-help/C/wacom-map-buttons.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="wacom-map-buttons">
+      
+  <info>
+    <revision pkgversion="3.7.1" version="0.1" date="2012-11-16" status="stub"/>
+    <revision version="gnome:42" status="final" date="2022-04-02"/>
+
+    <link type="guide" xref="wacom"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
+
+    <desc>Assign functions to the hardware buttons on the graphics tablet.</desc>
+  </info>
+
+  <title>Map the tablet buttons</title>
+
+  <p>The hardware buttons on a table can be configured for various functions.</p>
+
+<steps>
+  <item>
+    <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
+    overview and start typing <gui>Wacom Tablet</gui>.</p>
+  </item>
+  <item>
+    <p>Click on <gui>Wacom Tablet</gui> to open the panel.</p>
+    <note style="tip"><p>If no tablet is detected, you’ll be asked to
+    <gui>Please plug in or turn on your Wacom tablet</gui>. Click
+    <gui>Bluetooth</gui> in the sidebar to connect a wireless tablet.</p></note>
+  </item>
+  <item>
+    <p>Click <gui>Map Buttons</gui>.</p>
+  </item>
+  <item>
+    <p>An on screen display shows the layout of the tablet's buttons. Press each
+    button on the tablet and choose one of these functions:</p>
+    <list>
+      <item><p><gui>Application defined</gui></p></item>
+      <item><p><gui>Show on-screen help</gui></p></item>
+      <item><p><gui>Switch monitor</gui></p></item>
+      <item><p><gui>Assign keystroke</gui></p></item>
+   </list>
+  </item>
+  <item>
+    <p>Click <gui>Done</gui> when each button is configured, and press
+    <key>Esc</key> to exit.</p>
+  </item>
+</steps>
+
+
+</page>
diff --git a/gnome-help/C/wacom-mode.page b/gnome-help/C/wacom-mode.page
index 9f6d6fe6..75570fbc 100644
--- a/gnome-help/C/wacom-mode.page
+++ b/gnome-help/C/wacom-mode.page
@@ -4,12 +4,8 @@
       id="wacom-mode">
 
   <info>
-    <revision pkgversion="3.10" date="2013-11-02" status="review"/>
-    <revision pkgversion="3.12" date="2014-03-23" status="candidate"/>
-    <revision pkgversion="3.14" date="2014-10-12" status="candidate"/>
-    <revision pkgversion="3.18" date="2015-09-29" status="final"/>
-    <revision pkgversion="3.28" date="2018-07-22" status="review"/>
     <revision pkgversion="3.33" date="2019-07-21" status="candidate"/>
+    <revision version="gnome:42" status="final" date="2022-04-02"/>
 
     <link type="guide" xref="wacom"/>
 
@@ -26,7 +22,7 @@
 
   <title>Set the Wacom tablet’s tracking mode</title>
 
-<p><gui>Tracking Mode</gui> determines how the stylus is mapped to the screen.</p>
+<p><gui>Tablet Mode</gui> determines how the stylus is mapped to the screen.</p>
 
 <steps>
   <item>
@@ -35,23 +31,22 @@
   </item>
   <item>
     <p>Click on <gui>Wacom Tablet</gui> to open the panel.</p>
-  </item>
-  <item>
-    <p>Click the <gui>Tablet</gui> button in the header bar.</p>
     <note style="tip"><p>If no tablet is detected, you’ll be asked to
     <gui>Please plug in or turn on your Wacom tablet</gui>. Click the
-    <gui>Bluetooth Settings</gui> link to connect a wireless tablet.</p></note>
+    <gui>Bluetooth</gui> in the sidebar to connect a wireless tablet.</p></note>
+  </item>
+  <item>
+    <p>Choose between tablet (or absolute) mode and touchpad (or relative)
+    mode. For tablet mode, switch <gui>Tablet Mode</gui> to on.</p>
   </item>
-  <item><p>Next to <gui>Tracking Mode</gui>, select <gui>Tablet (absolute)</gui>
-   or <gui>Touchpad (relative)</gui>.</p></item>
 </steps>
 
-<note style="info"><p>In <em>absolute</em> mode, each point on the tablet maps
- to a point on the screen. The top left corner of the screen, for instance,
- always corresponds to the same point on the tablet.</p>
- <p>In <em>relative</em> mode, if you lift the stylus off the tablet and put it
- down in a different position, the pointer on the screen doesn’t move. This is
-    the way a mouse operates.</p>
+  <note style="info"><p>In <em>absolute</em> mode, each point on the tablet maps
+  to a point on the screen. The top left corner of the screen, for instance,
+  always corresponds to the same point on the tablet.</p>
+  <p>In <em>relative</em> mode, if you lift the stylus off the tablet and put it
+  down in a different position, the pointer on the screen doesn’t move. This is
+  the way a mouse operates.</p>
   </note>
 
 </page>
diff --git a/gnome-help/C/wacom-multi-monitor.page b/gnome-help/C/wacom-multi-monitor.page
index 0b22e238..c61332d1 100644
--- a/gnome-help/C/wacom-multi-monitor.page
+++ b/gnome-help/C/wacom-multi-monitor.page
@@ -4,12 +4,8 @@
       id="wacom-multi-monitor">
 
   <info>
-    <revision pkgversion="3.10" date="2013-11-02" status="review"/>
-    <revision pkgversion="3.12" date="2014-03-23" status="candidate"/>
-    <revision pkgversion="3.14" date="2014-10-12" status="candidate"/>
-    <revision pkgversion="3.18" date="2015-09-29" status="final"/>
-    <revision pkgversion="3.28" date="2018-07-22" status="review"/>
     <revision pkgversion="3.33" date="2019-07-21" status="candidate"/>
+    <revision version="gnome:42" status="final" date="2022-04-02"/>
 
     <link type="guide" xref="wacom"/>
 
@@ -44,29 +40,25 @@
   </item>
   <item>
     <p>Click on <gui>Wacom Tablet</gui> to open the panel.</p>
-  </item>
-  <item>
-    <p>Click the <gui>Tablet</gui> button in the header bar.</p>
     <note style="tip"><p>If no tablet is detected, you’ll be asked to
-    <gui>Please plug in or turn on your Wacom tablet</gui>. Click the
-    <gui>Bluetooth Settings</gui> link to connect a wireless tablet.</p></note>
+    <gui>Please plug in or turn on your Wacom tablet</gui>. Click
+    <gui>Bluetooth</gui> in the sidebar to connect a wireless tablet.</p></note>
   </item>
-  <item><p>Click <gui>Map to Monitor…</gui></p></item>
-  <item><p>Check <gui>Map to single monitor</gui>.</p></item>
-  <item><p>Next to <gui>Output</gui>, select the monitor you wish to receive
-   input from your graphics tablet.</p>
-     <note style="tip"><p>Only the monitors that are configured will be
-      selectable.</p></note>
+  <item>
+    <p>Next to <gui>Map to Monitor</gui>, select the monitor you wish to
+    receive input from your graphics tablet, or choose
+    <gui>All Displays</gui>.</p>
+    <note style="tip"><p>Only the monitors that are configured will be
+    selectable.</p></note>
   </item>
   <item>
-    <p>Switch the <gui>Keep aspect ratio (letterbox)</gui> switch to on to
-    match the drawing area of the tablet to the proportions of the monitor.
-      This setting, also called <em>force proportions</em>,
-      “letterboxes” the drawing area on a tablet to correspond more
-      directly to a display. For example, a 4∶3 tablet would be mapped so that
-      the drawing area would correspond to a widescreen display.</p>
+    <p>Switch <gui>Keep aspect ratio</gui> to on to match the drawing
+    area of the tablet to the proportions of the monitor. This setting, also
+    called <em>force proportions</em>, “letterboxes” the drawing area on a
+    tablet to correspond more directly to a display. For example, a 4∶3 tablet
+    would be mapped so that the drawing area would correspond to a widescreen
+    display.</p>
   </item>
-  <item><p>Click <gui>Close</gui>.</p></item>
 </steps>
 
 </page>
diff --git a/gnome-help/C/wacom-stylus.page b/gnome-help/C/wacom-stylus.page
index 17e11453..283bf040 100644
--- a/gnome-help/C/wacom-stylus.page
+++ b/gnome-help/C/wacom-stylus.page
@@ -4,11 +4,8 @@
       id="wacom-stylus">
 
   <info>
-    <revision pkgversion="3.10" date="2013-11-02" status="review"/>
-    <revision pkgversion="3.12" date="2014-03-23" status="candidate"/>
-    <revision pkgversion="3.14" date="2014-10-12" status="candidate"/>
-    <revision pkgversion="3.18" date="2015-09-29" status="final"/>
     <revision pkgversion="3.28" date="2018-07-22" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-04-02"/>
 
     <link type="guide" xref="wacom"/>
 
@@ -25,50 +22,37 @@
 
   <title>Configure the stylus</title>
 
-  <comment>
-    <cite date="2012-04-21" href="mailto:mdhillca gmail com">Michael Hill</cite>
-    <p>Describe the config options for the stylus and how to configure more than
-     one stylus.</p>
-  </comment>
-
-<steps>
-  <item>
-    <p>Open the <gui xref="shell-introduction#activities">Activities</gui> overview and
-    start typing <gui>Settings</gui>.</p>
-  </item>
-  <item>
-    <p>Click on <gui>Settings</gui>.</p>
-  </item>
-  <item>
-    <p>Click <gui>Wacom Tablet</gui> in the sidebar to open the panel.</p>
-  </item>
-  <item>
-    <p>Click the <gui>Stylus</gui> button in the header bar.</p>
-    <note style="tip"><p>If no stylus is detected, you’ll be asked to
-    <gui>Please move your stylus to the proximity of the tablet to configure
-    it</gui>.</p></note>
-  </item>
-  <item><p>The panel contains details and settings specific to your stylus,
-   with the device name (the stylus class) and diagram to the left. These
-   settings can be adjusted:</p>
-    <list>
-      <item><p><gui>Eraser Pressure Feel:</gui> use the slider to adjust the
-       “feel” (how physical pressure is translated to digital values) between
-       <gui>Soft</gui> and <gui>Firm</gui>.</p></item>
-      <item><p><gui>Button/Scroll Wheel</gui> configuration (these change to
-       reflect the stylus). Click the menu next to each label to select one of
-       these functions: No Action, Left Mouse Button Click, Middle Mouse Button
-       Click, Right Mouse Button Click, Scroll Up, Scroll Down, Scroll Left,
-       Scroll Right, Back, or Forward.</p></item>
-      <item><p><gui>Tip Pressure Feel:</gui> use the slider to adjust the
-       “feel” between <gui>Soft</gui> and <gui>Firm</gui>.</p></item>
-    </list>
-  </item>
-</steps>
-
-<note style="info">
-  <p>If you have more than one stylus, use the pager next to
-  the stylus device name to choose which stylus to configure.</p>
-</note>
+  <steps>
+    <item>
+      <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
+      overview and start typing <gui>Wacom Tablet</gui>.</p>
+    </item>
+    <item>
+      <p>Click on <gui>Wacom Tablet</gui> to open the panel.</p>
+      <note style="tip"><p>If no tablet is detected, you’ll be asked to
+      <gui>Please plug in or turn on your Wacom tablet</gui>. Click
+      <gui>Bluetooth</gui> in the sidebar to connect a wireless tablet.</p></note>
+    </item>
+    <item>
+      <p>There is a section containing settings specific to each stylus,
+      with the device name (the stylus class) and diagram at the top.</p>
+      <note style="tip"><p>If no stylus is detected, you’ll be asked to
+      <gui>Please move your stylus to the proximity of the tablet to configure
+      it</gui>.</p></note>
+      <p>These settings can be adjusted:</p>
+      <list>
+        <item><p><gui>Tip Pressure Feel:</gui> use the slider to adjust the
+        “feel” between <gui>Soft</gui> and <gui>Firm</gui>.</p></item>
+        <item><p><gui>Button/Scroll Wheel</gui> configuration (these change to
+        reflect the stylus). Click the menu next to each label to select one of
+        these functions: Middle Mouse Button Click, Right Mouse Button Click,
+        Back, or Forward.</p></item>
+     </list>
+    </item>
+    <item>
+      <p>Click <gui>Test Your Settings</gui> in the header bar to pop down a
+      sketchpad where you can test your stylus settings.</p>
+    </item>
+  </steps>
 
 </page>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index eb579568..6645a6e7 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -440,6 +440,7 @@ HELP_FILES = \
        video-dvd.page \
        video-sending.page \
        wacom-left-handed.page \
+       wacom-map-buttons.page \
        wacom-mode.page \
        wacom-multi-monitor.page \
        wacom-stylus.page \


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