Merge lp:~clissold345/ubuntu-docs/fix-for-964727 into lp:~ubuntu-core-doc/ubuntu-docs/trunk2017-07-10

Proposed by Chris Perry
Status: Merged
Merged at revision: 573
Proposed branch: lp:~clissold345/ubuntu-docs/fix-for-964727
Merge into: lp:~ubuntu-core-doc/ubuntu-docs/trunk2017-07-10
Diff against target: 206 lines (+146/-25)
1 file modified
ubuntu-help/C/mouse-mousekeys.page (+146/-25)
To merge this branch: bzr merge lp:~clissold345/ubuntu-docs/fix-for-964727
Reviewer Review Type Date Requested Status
Gunnar Hjalmarsson Approve
Review via email: mp+312974@code.launchpad.net

Description of the change

Please see the comment I added to the bug report:

https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+bug/964727

To post a comment you must log in.
Revision history for this message
Gunnar Hjalmarsson (gunnarhj) wrote :

Thanks for your work with this, Chris.

You addressed the bug reporter's request by dropping the "most keyboards..." para, and the change of step 4 was apparently necessary (probably the last tab was not present when the page was written originally).

I have a few thoughts.

This sentence: "With mouse keys there are three buttons: primary, alternate, and modifier." confuses me. Which buttons? I don't see any buttons. Shouldn't it rather be three modes or three levels? Or am I missing something? (I see on the Wikipedia page that the term "button" is used, but it doesn't make me understand it better.) Can you somehow explain/justify the use of the term "button" in this context?

Personally I think the table is redundant. The clarifications you added through the bullet points already covers it, don't they?

review: Needs Information
Revision history for this message
Chris Perry (clissold345) wrote :

Hi Gunnar

Have you tried mouse keys out? I found it made more sense when I tried it out. One of my laptops has a (real) numeric keypad, which was useful.

My take on mouse keys is that it simulates a pointing and clicking device with three buttons (eg a three-button mouse - but not necessarily a mouse - other pointing and clicking devices are available). The wikipedia page just uses the term button (without quotes), so I've copied that. Of course there is no physical button/buttons, so it could perhaps be termed a virtual button?

I'd say that the page needs to give the meaning/action of all the mouse keys. My examples just cover the main examples, they don't cover all the the mouse keys actions. Eg the examples don't cover all the navigation keys. Also - though this is a bit specialized - mouse keys provides three kinds of drag and drop and my examples only cover one kind (though I'm not sure if any applications distinguish between the different drags and drops). I've given the meaning/action of the keys using a table (adapting the table in the wikipedia page) but I think the info could be given a different way (eg in a diagram?).

Does the above make sense?

Revision history for this message
Gunnar Hjalmarsson (gunnarhj) wrote :

Yep, I tried it out. Not extensively, though. You are right, it does simulate the mouse buttons. I withdraw my objection on that one.

Still hesitating wrt to the table, but you did the work and I trust your feeling for how much info is motivated.

Your changes improve the page significantly, btw. Thanks again!

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'ubuntu-help/C/mouse-mousekeys.page'
2--- ubuntu-help/C/mouse-mousekeys.page 2013-09-15 00:45:58 +0000
3+++ ubuntu-help/C/mouse-mousekeys.page 2016-12-10 19:51:44 +0000
4@@ -34,11 +34,13 @@
5 control the mouse pointer using the numeric keypad on your keyboard. This
6 feature is called <em>mouse keys</em>.</p>
7
8+<p>To enable mouse keys using the keyboard:</p>
9+
10 <steps>
11 <item><p>Tap the <key><link xref="windows-key">Super</link></key> key to open the <gui>Dash</gui>.</p></item>
12 <item><p>Type <input>Universal Access</input> and press <key>Enter</key> to open the Universal Access settings.</p></item>
13 <item><p>Press <key>Tab</key> once to select the <gui>Seeing</gui> tab.</p></item>
14- <item><p>Press <key>←</key> once to switch to the <gui>Pointing and Clicking</gui> tab.</p></item>
15+ <item><p>Press <key>←</key> twice to switch to the <gui>Pointing and Clicking</gui> tab.</p></item>
16 <item><p>Press <key>↓</key> once to select the <gui>Mouse Keys</gui> switch then press <key>Enter</key> to switch it on.</p></item>
17 <item>
18 <p>
19@@ -49,39 +51,157 @@
20 </steps>
21
22 <note style = "tip">
23- <p>These instructions provide the shortest way to enable mouse keys using
24- only the keyboard. Select <gui>Universal Access Settings</gui> to see more
25+ <p>The above instructions provide the shortest way to enable mouse keys using
26+ only the keyboard. See <gui>Universal Access</gui> settings for more
27 accessibility options.</p>
28 </note>
29
30-<p>
31-The keypad is a set of numerical buttons on your keyboard, usually arranged
32-into a square grid. If you have a keyboard without a keypad (such as a laptop
33-keyboard), you may need to hold down the function (<key>Fn</key>)
34+<p></p>
35+
36+<p>
37+The numeric keypad is a set of numerical buttons on your keyboard, usually arranged
38+into a square grid. With mouse keys there are three buttons: primary, alternate, and modifier. Initially the primary button is selected.
39+Here are some examples of how to use mouse keys:</p>
40+
41+<list type="circle">
42+
43+ <item><p>
44+Each number on the keypad (except 0 and 5) corresponds to a direction. For example, pressing
45+<key>8</key> will move the pointer upwards and pressing <key>2</key> will move
46+it downwards.
47+</p></item>
48+
49+ <item><p>
50+To click the selected button, press <key>5</key>.
51+</p></item>
52+
53+ <item><p>
54+To double-click the selected button, quickly press
55+<key>5</key> twice or press <key>+</key> once.
56+</p></item>
57+
58+ <item><p>
59+To right click,
60+press <key>-</key> to select the alternate button (if it is not already selected) and press <key>5</key>.
61+</p></item>
62+
63+ <item><p>
64+To middle click,
65+press <key>*</key> to select the modifier button (if it is not already selected) and press <key>5</key>.
66+</p></item>
67+
68+
69+ <item><p>
70+To drag and drop using the primary button,
71+press <key>/</key> to select the primary button (if it is not already selected),
72+press <key>0</key> to depress the button, drag the pointer to the required position, and
73+press <key>.</key> to release the button.
74+</p></item>
75+
76+
77+</list>
78+
79+<p>
80+ </p>
81+<p>Here is a table of mouse keys and their actions:</p>
82+
83+
84+<table frame="top bottom" rules="rows">
85+
86+ <tr>
87+ <td><p><em>Key</em></p></td>
88+ <td><p><em>Action</em></p></td>
89+ </tr>
90+ <tr>
91+ <td><p><key>8</key></p></td>
92+ <td><p>Pointer up</p></td>
93+ </tr>
94+ <tr>
95+ <td><p><key>2</key></p></td>
96+ <td><p>Pointer down</p></td>
97+ </tr>
98+ <tr>
99+ <td><p><key>6</key></p></td>
100+ <td><p>Pointer right</p></td>
101+ </tr>
102+ <tr>
103+ <td><p><key>4</key></p></td>
104+ <td><p>Pointer left</p></td>
105+ </tr>
106+
107+ <tr>
108+ <td><p><key>7</key></p></td>
109+ <td><p>Pointer up and left</p></td>
110+ </tr>
111+ <tr>
112+ <td><p><key>9</key></p></td>
113+ <td><p>Pointer up and right</p></td>
114+ </tr>
115+ <tr>
116+ <td><p><key>3</key></p></td>
117+ <td><p>Pointer down and right</p></td>
118+ </tr>
119+ <tr>
120+ <td><p><key>1</key></p></td>
121+ <td><p>Pointer down and left</p></td>
122+ </tr>
123+
124+ <tr>
125+ <td><p><key>/</key></p></td>
126+ <td><p>Select the primary button. On a mouse the primary button is usually the left button</p></td>
127+ </tr>
128+ <tr>
129+ <td><p><key>*</key></p></td>
130+ <td><p>Select the modifier button. On a mouse the modifier button (if present) is usually the middle button</p></td>
131+ </tr>
132+ <tr>
133+ <td><p><key>-</key></p></td>
134+ <td><p>Select the alternate button. On a mouse the alternate button is usually the right button</p></td>
135+ </tr>
136+ <tr>
137+ <td><p><key>5</key></p></td>
138+ <td><p>Click selected button</p></td>
139+ </tr>
140+
141+ <tr>
142+ <td><p><key>+</key></p></td>
143+ <td><p>Double click selected button</p></td>
144+ </tr>
145+ <tr>
146+ <td><p><key>0</key></p></td>
147+ <td><p>Depress selected button</p></td>
148+ </tr>
149+ <tr>
150+ <td><p><key>.</key></p></td>
151+ <td><p>Release selected button</p></td>
152+ </tr>
153+
154+</table>
155+
156+<p>
157+</p>
158+
159+<note>
160+<p>If you have a keyboard without a keypad (as with some laptops),
161+you may need to hold down the function (<key>Fn</key>)
162 key and use certain other keys on your keyboard as a keypad. If you use this
163-feature often on a laptop, you can purchase external USB keypads.
164-</p>
165-
166-<p>
167-Each number on the keypad corresponds to a direction. For example, pressing
168-<key>8</key> will move the pointer upwards and pressing <key>2</key> will move
169-it downwards. Press the <key>5</key> key to click once with the mouse, or
170-quickly press it twice to double-click.
171-</p>
172-
173-<p>
174-Most keyboards have a special key which
175-allows you to right-click; it is often near to the space bar. Note, however,
176-that this key responds to where your keyboard focus is, not where your mouse
177-pointer is. See <link xref="a11y-right-click"/> for information on how to
178-right-click by holding down <key>5</key> or the left mouse button.
179-</p>
180-
181+feature often, you may wish to purchase an external USB keypad.
182+</p>
183+</note>
184+
185+<p>
186+</p>
187+
188+<note>
189 <p>
190 If you want to use the keypad to type numbers while mouse keys is enabled, turn
191 <key>Num Lock</key> on. The mouse cannot be controlled with the keypad when
192 <key>Num Lock</key> is turned on, though.
193 </p>
194+</note>
195+
196+<p>
197+</p>
198
199 <note>
200 <p>
201@@ -90,4 +210,5 @@
202 </p>
203 </note>
204
205+
206 </page>

Subscribers

People subscribed via source and target branches