1 |
jkt 05/07/26 17:56:59 |
2 |
|
3 |
Modified: xml/htdocs/doc/en metadoc.xml |
4 |
Added: xml/htdocs/doc/en gpm.xml |
5 |
Log: |
6 |
#99490, new guide: using a mouse within a console (gpm) |
7 |
|
8 |
Revision Changes Path |
9 |
1.82 +7 -2 xml/htdocs/doc/en/metadoc.xml |
10 |
|
11 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.82&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
12 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.82&content-type=text/plain&cvsroot=gentoo |
13 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml.diff?r1=1.81&r2=1.82&cvsroot=gentoo |
14 |
|
15 |
Index: metadoc.xml |
16 |
=================================================================== |
17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v |
18 |
retrieving revision 1.81 |
19 |
retrieving revision 1.82 |
20 |
diff -u -r1.81 -r1.82 |
21 |
--- metadoc.xml 26 Jul 2005 10:53:26 -0000 1.81 |
22 |
+++ metadoc.xml 26 Jul 2005 17:56:59 -0000 1.82 |
23 |
@@ -1,9 +1,9 @@ |
24 |
<?xml version='1.0' encoding="UTF-8"?> |
25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.81 2005/07/26 10:53:26 jkt Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.82 2005/07/26 17:56:59 jkt Exp $ --> |
27 |
<!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd"> |
28 |
|
29 |
<metadoc lang="en"> |
30 |
-<version>1.18</version> |
31 |
+<version>1.19</version> |
32 |
<members> |
33 |
<lead>swift</lead> |
34 |
<lead>neysx</lead> |
35 |
@@ -272,6 +272,7 @@ |
36 |
<file id="colinux-howto">/doc/en/colinux-howto.xml</file> |
37 |
<file id="gentoo-sparc-obpreference">/doc/en/gentoo-sparc-obpreference.xml</file> |
38 |
<file id="gnome-config">/doc/en/gnome-config.xml</file> |
39 |
+ <file id="gpm">/doc/en/gpm.xml</file> |
40 |
<file id="macos-guide">/doc/en/macos-guide.xml</file> |
41 |
<file id="gentoo-security">/doc/en/gentoo-security.xml</file> |
42 |
<file id="home-router-howto">/doc/en/home-router-howto.xml</file> |
43 |
@@ -711,6 +712,10 @@ |
44 |
<memberof>desktop_config</memberof> |
45 |
<fileid>power-management-guide</fileid> |
46 |
</doc> |
47 |
+ <doc id="gpm"> |
48 |
+ <memberof>desktop_config</memberof> |
49 |
+ <fileid>gpm</fileid> |
50 |
+ </doc> |
51 |
<doc id="kde-split-ebuilds"> |
52 |
<memberof>desktop_install</memberof> |
53 |
<fileid>kde-split-ebuilds</fileid> |
54 |
|
55 |
|
56 |
|
57 |
1.1 xml/htdocs/doc/en/gpm.xml |
58 |
|
59 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gpm.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
60 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gpm.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo |
61 |
|
62 |
Index: gpm.xml |
63 |
=================================================================== |
64 |
<?xml version="1.0" encoding="UTF-8"?> |
65 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
66 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gpm.xml,v 1.1 2005/07/26 17:56:59 jkt Exp $ --> |
67 |
|
68 |
<guide link="/doc/en/gpm.xml"> |
69 |
<title>Using a Mouse within the Console</title> |
70 |
|
71 |
<author title="Author"> |
72 |
<mail link="jackdark@×××××.com">Joshua Saddler</mail> |
73 |
</author> |
74 |
|
75 |
<abstract> |
76 |
This guide shows you how to set up and use gpm (the General |
77 |
Purpose Mouse server) from within a command line interface. |
78 |
This is especially useful for new Gentoo installations or |
79 |
for systems that cannot or do not use an X server. |
80 |
</abstract> |
81 |
|
82 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
83 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
84 |
<license/> |
85 |
|
86 |
<version>1.0</version> |
87 |
<date>2005-07-19</date> |
88 |
|
89 |
<chapter> |
90 |
<title>Getting gpm</title> |
91 |
<section> |
92 |
<body> |
93 |
|
94 |
<p> |
95 |
If you've just installed Gentoo, you almost certainly don't have your mouse |
96 |
set up to work within a command line interface (CLI) yet. Or perhaps you |
97 |
can't use or don't need an X server, yet you still need to use a mouse. The |
98 |
solution is simple: <c>gpm</c>, the General Purpose Mouse server. |
99 |
</p> |
100 |
|
101 |
<p> |
102 |
First, you will need to get gpm: |
103 |
</p> |
104 |
|
105 |
<pre caption="Obtaining gpm"> |
106 |
# <i>emerge gpm</i> |
107 |
</pre> |
108 |
|
109 |
<p> |
110 |
You might have noticed a few messages during the compilation that warned |
111 |
about configuring the server. You must do this before starting gpm. |
112 |
</p> |
113 |
|
114 |
</body> |
115 |
</section> |
116 |
</chapter> |
117 |
|
118 |
<chapter> |
119 |
<title>Configuring gpm</title> |
120 |
<section> |
121 |
<body> |
122 |
|
123 |
<p> |
124 |
Before you can use gpm, you will need to uncomment the lines |
125 |
corresponding to the location and protocol of your mouse. You do this by |
126 |
editing the gpm configuration file: |
127 |
</p> |
128 |
|
129 |
<pre caption="Setting up gpm"> |
130 |
# <i>nano /etc/conf.d/gpm</i> |
131 |
</pre> |
132 |
|
133 |
<p> |
134 |
In my case, I have a USB mouse on <path>/dev/input/mouse0</path>. So, I |
135 |
have uncommented <path>/dev/input/mice</path>, as this is the cumulative |
136 |
device for all mice on the system, and the appropriate protocol. |
137 |
Try using <path>/dev/input/mice</path> before <path>/dev/psaux</path>, as |
138 |
the latter is deprecated and can be disabled in the latest 2.6 kernels. If |
139 |
<path>/dev/input/mice</path> fails, then fall back to other devices. Here is |
140 |
my example <path>/etc/conf.d/gpm</path>: |
141 |
</p> |
142 |
|
143 |
<pre caption="Example gpm config"> |
144 |
<comment># Please uncomment the type of mouse you have and the appropriate MOUSEDEV entry</comment> |
145 |
|
146 |
#MOUSE=ps2 |
147 |
MOUSE=imps2 |
148 |
#MOUSEDEV=/dev/psaux |
149 |
MOUSEDEV=/dev/input/mice |
150 |
</pre> |
151 |
|
152 |
<p> |
153 |
If you have a wheelmouse, you will want to use the imps2 protocol, so |
154 |
uncomment that line. If imps2 and ps2 both fail to work for you, please |
155 |
refer to the gpm info page (<c>info gpm</c>) for other protocols to try. |
156 |
Also, if you want to be able to click on hyperlinks in terminals to |
157 |
navigate to a website, it is a good idea to follow the suggestion in the |
158 |
<c>/etc/conf.d/gpm</c> file: |
159 |
</p> |
160 |
|
161 |
<pre caption="Other options"> |
162 |
<comment># Please uncomment this line if you want gpm to understand charsets</comment> |
163 |
<comment># used in URLs and names with ~ or : in them, etc.</comment> |
164 |
<comment># This is a good idea to turn on!</comment> |
165 |
|
166 |
APPEND="-l \"a-zA-Z0-9_.:~/\300-\326\330-\366\370-\377\"" |
167 |
</pre> |
168 |
|
169 |
<p> |
170 |
The rest of the conf.d file contains other suggestions for your mouse server; |
171 |
uncomment the various options according to your needs. See <c>man gpm</c> |
172 |
for more information. |
173 |
</p> |
174 |
|
175 |
</body> |
176 |
</section> |
177 |
</chapter> |
178 |
|
179 |
<chapter> |
180 |
<title>Running gpm</title> |
181 |
<section> |
182 |
<body> |
183 |
|
184 |
<p> |
185 |
Now that your mouse server is installed and configured, it's time to start |
186 |
using it: |
187 |
</p> |
188 |
|
189 |
<pre caption="The gpm init script"> |
190 |
# <i>/etc/init.d/gpm start</i> |
191 |
</pre> |
192 |
|
193 |
<p> |
194 |
You should see a block cursor appear. Remember that only root can run the gpm |
195 |
init script. However, to avoid having to <c>su</c> and run the script every |
196 |
single time you begin a new session, why not set gpm to begin every time you |
197 |
turn on your computer? |
198 |
</p> |
199 |
|
200 |
<pre caption="Adding gpm to the default runlevel"> |
201 |
# <i>rc-update add gpm default</i> |
202 |
</pre> |
203 |
|
204 |
<p> |
205 |
Now, whenever you start your computer, you'll be greeted by the console cursor |
206 |
by the time you get to the login prompt. The mouse server will continue to run |
207 |
even if you're not logged in as root. |
208 |
</p> |
209 |
|
210 |
</body> |
211 |
</section> |
212 |
</chapter> |
213 |
|
214 |
<chapter> |
215 |
<title>Working with gpm</title> |
216 |
<section> |
217 |
<title>Copying and pasting</title> |
218 |
<body> |
219 |
|
220 |
<p> |
221 |
Copying and pasting large blocks of text with a working mouse server is very |
222 |
easy. Simply highlight the text with the left mouse button (it will stay |
223 |
highlighted when you release the button), switch to a different terminal if you |
224 |
wish, position the cursor, and press the middle mouse button to paste the text |
225 |
where you placed the cursor. Note that you can copy and paste without ever |
226 |
leaving the terminal you started. This makes posting the output of error |
227 |
messages to the <uri link="http://forums.gentoo.org">Gentoo forums</uri> |
228 |
extremely simple. |
229 |
</p> |
230 |
|
231 |
</body> |
232 |
</section> |
233 |
<section> |
234 |
<title>Text-mode browsing and gpm</title> |
235 |
<body> |
236 |
|
237 |
<p> |
238 |
If you have a message on one screen and a text-mode web browser on the other, |
239 |
you can copy the error message by highlighting it, then change to the other |
240 |
terminal, left-click the appropriate text entry box to select it, and then press |
241 |
the middle mouse button. Voila! Your error message can now be posted to the |
242 |
forums. |
243 |
</p> |
244 |
|
245 |
<p> |
246 |
Though discussion of text-only browsers is somewhat beyond the scope of this |
247 |
guide, inevitably users will need to find a compatible console browser. Though |
248 |
<c>lynx</c> is most likely the oldest and well established browser, its |
249 |
interface has poor mouse support and recognition. Instead, try using |
250 |
<c>links</c>, the same browser which is also included in the Gentoo Installation |
251 |
CDs. <c>links</c> has excellent mouse integration: |
252 |
</p> |
253 |
|
254 |
<pre caption="Obtaining links"> |
255 |
# <i>emerge links</i> |
256 |
</pre> |
257 |
|
258 |
<p> |
259 |
This concludes the guide to using a mouse within the console. Happy mousing! |
260 |
</p> |
261 |
|
262 |
</body> |
263 |
|
264 |
|
265 |
|
266 |
-- |
267 |
gentoo-doc-cvs@g.o mailing list |