Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: gpm.xml
Date: Tue, 26 Jul 2005 18:17:30
Message-Id: 200507261817.j6QIHDV6019590@robin.gentoo.org
1 neysx 05/07/26 18:17:07
2
3 Modified: xml/htdocs/doc/en gpm.xml
4 Log:
5 Coding style, removed installCD mention
6
7 Revision Changes Path
8 1.2 +51 -54 xml/htdocs/doc/en/gpm.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gpm.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gpm.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gpm.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
13
14 Index: gpm.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gpm.xml,v
17 retrieving revision 1.1
18 retrieving revision 1.2
19 diff -u -r1.1 -r1.2
20 --- gpm.xml 26 Jul 2005 17:56:59 -0000 1.1
21 +++ gpm.xml 26 Jul 2005 18:17:07 -0000 1.2
22 @@ -1,6 +1,6 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gpm.xml,v 1.1 2005/07/26 17:56:59 jkt Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gpm.xml,v 1.2 2005/07/26 18:17:07 neysx Exp $ -->
27
28 <guide link="/doc/en/gpm.xml">
29 <title>Using a Mouse within the Console</title>
30 @@ -10,10 +10,9 @@
31 </author>
32
33 <abstract>
34 -This guide shows you how to set up and use gpm (the General
35 -Purpose Mouse server) from within a command line interface.
36 -This is especially useful for new Gentoo installations or
37 -for systems that cannot or do not use an X server.
38 +This guide shows you how to set up and use gpm (the General Purpose Mouse
39 +server) from within a command line interface. This is especially useful for new
40 +Gentoo installations or for systems that cannot or do not use an X server.
41 </abstract>
42
43 <!-- The content of this document is licensed under the CC-BY-SA license -->
44 @@ -21,7 +20,7 @@
45 <license/>
46
47 <version>1.0</version>
48 -<date>2005-07-19</date>
49 +<date>2005-07-26</date>
50
51 <chapter>
52 <title>Getting gpm</title>
53 @@ -29,10 +28,10 @@
54 <body>
55
56 <p>
57 -If you've just installed Gentoo, you almost certainly don't have your mouse
58 -set up to work within a command line interface (CLI) yet. Or perhaps you
59 -can't use or don't need an X server, yet you still need to use a mouse. The
60 -solution is simple: <c>gpm</c>, the General Purpose Mouse server.
61 +If you've just installed Gentoo, you almost certainly don't have your mouse set
62 +up to work within a command line interface (CLI) yet. Or perhaps you can't use
63 +or don't need an X server, yet you still need to use a mouse. The solution is
64 +simple: <c>gpm</c>, the General Purpose Mouse server.
65 </p>
66
67 <p>
68 @@ -44,8 +43,8 @@
69 </pre>
70
71 <p>
72 -You might have noticed a few messages during the compilation that warned
73 -about configuring the server. You must do this before starting gpm.
74 +You might have noticed a few messages during the compilation that warned about
75 +configuring the server. You must do this before starting gpm.
76 </p>
77
78 </body>
79 @@ -58,9 +57,9 @@
80 <body>
81
82 <p>
83 -Before you can use gpm, you will need to uncomment the lines
84 -corresponding to the location and protocol of your mouse. You do this by
85 -editing the gpm configuration file:
86 +Before you can use gpm, you will need to uncomment the lines corresponding to
87 +the location and protocol of your mouse. You do this by editing the gpm
88 +configuration file:
89 </p>
90
91 <pre caption="Setting up gpm">
92 @@ -68,17 +67,17 @@
93 </pre>
94
95 <p>
96 -In my case, I have a USB mouse on <path>/dev/input/mouse0</path>. So, I
97 -have uncommented <path>/dev/input/mice</path>, as this is the cumulative
98 -device for all mice on the system, and the appropriate protocol.
99 -Try using <path>/dev/input/mice</path> before <path>/dev/psaux</path>, as
100 -the latter is deprecated and can be disabled in the latest 2.6 kernels. If
101 -<path>/dev/input/mice</path> fails, then fall back to other devices. Here is
102 -my example <path>/etc/conf.d/gpm</path>:
103 +In my case, I have a USB mouse on <path>/dev/input/mouse0</path>. So, I have
104 +uncommented <path>/dev/input/mice</path>, as this is the cumulative device for
105 +all mice on the system, and the appropriate protocol. Try using
106 +<path>/dev/input/mice</path> before <path>/dev/psaux</path>, as the latter is
107 +deprecated and can be disabled in the latest 2.6 kernels. If
108 +<path>/dev/input/mice</path> fails, then fall back to other devices. Here is my
109 +example <path>/etc/conf.d/gpm</path>:
110 </p>
111
112 <pre caption="Example gpm config">
113 -<comment># Please uncomment the type of mouse you have and the appropriate MOUSEDEV entry</comment>
114 +<comment>(Please uncomment the type of mouse you have and the appropriate MOUSEDEV entry)</comment>
115
116 #MOUSE=ps2
117 MOUSE=imps2
118 @@ -87,26 +86,25 @@
119 </pre>
120
121 <p>
122 -If you have a wheelmouse, you will want to use the imps2 protocol, so
123 -uncomment that line. If imps2 and ps2 both fail to work for you, please
124 -refer to the gpm info page (<c>info gpm</c>) for other protocols to try.
125 -Also, if you want to be able to click on hyperlinks in terminals to
126 -navigate to a website, it is a good idea to follow the suggestion in the
127 -<c>/etc/conf.d/gpm</c> file:
128 +If you have a wheelmouse, you will want to use the imps2 protocol, so uncomment
129 +that line. If imps2 and ps2 both fail to work for you, please refer to the gpm
130 +info page (<c>info gpm</c>) for other protocols to try. Also, if you want to be
131 +able to click on hyperlinks in terminals to navigate to a website, it is a good
132 +idea to follow the suggestion in the <c>/etc/conf.d/gpm</c> file:
133 </p>
134
135 <pre caption="Other options">
136 -<comment># Please uncomment this line if you want gpm to understand charsets</comment>
137 -<comment># used in URLs and names with ~ or : in them, etc.</comment>
138 -<comment># This is a good idea to turn on!</comment>
139 +<comment>(Please uncomment this line if you want gpm to understand charsets
140 +used in URLs and names with ~ or : in them, etc.
141 +This is a good idea to turn on!)</comment>
142
143 APPEND="-l \"a-zA-Z0-9_.:~/\300-\326\330-\366\370-\377\""
144 </pre>
145
146 <p>
147 -The rest of the conf.d file contains other suggestions for your mouse server;
148 -uncomment the various options according to your needs. See <c>man gpm</c>
149 -for more information.
150 +The rest of the conf.d file contains other suggestions for your mouse server;
151 +uncomment the various options according to your needs. See <c>man gpm</c> for
152 +more information.
153 </p>
154
155 </body>
156 @@ -119,7 +117,7 @@
157 <body>
158
159 <p>
160 -Now that your mouse server is installed and configured, it's time to start
161 +Now that your mouse server is installed and configured, it's time to start
162 using it:
163 </p>
164
165 @@ -128,9 +126,9 @@
166 </pre>
167
168 <p>
169 -You should see a block cursor appear. Remember that only root can run the gpm
170 -init script. However, to avoid having to <c>su</c> and run the script every
171 -single time you begin a new session, why not set gpm to begin every time you
172 +You should see a block cursor appear. Remember that only root can run the gpm
173 +init script. However, to avoid having to <c>su</c> and run the script every
174 +single time you begin a new session, why not set gpm to begin every time you
175 turn on your computer?
176 </p>
177
178 @@ -139,8 +137,8 @@
179 </pre>
180
181 <p>
182 -Now, whenever you start your computer, you'll be greeted by the console cursor
183 -by the time you get to the login prompt. The mouse server will continue to run
184 +Now, whenever you start your computer, you'll be greeted by the console cursor
185 +by the time you get to the login prompt. The mouse server will continue to run
186 even if you're not logged in as root.
187 </p>
188
189 @@ -155,13 +153,13 @@
190 <body>
191
192 <p>
193 -Copying and pasting large blocks of text with a working mouse server is very
194 -easy. Simply highlight the text with the left mouse button (it will stay
195 -highlighted when you release the button), switch to a different terminal if you
196 -wish, position the cursor, and press the middle mouse button to paste the text
197 -where you placed the cursor. Note that you can copy and paste without ever
198 +Copying and pasting large blocks of text with a working mouse server is very
199 +easy. Simply highlight the text with the left mouse button (it will stay
200 +highlighted when you release the button), switch to a different terminal if you
201 +wish, position the cursor, and press the middle mouse button to paste the text
202 +where you placed the cursor. Note that you can copy and paste without ever
203 leaving the terminal you started. This makes posting the output of error
204 -messages to the <uri link="http://forums.gentoo.org">Gentoo forums</uri>
205 +messages to the <uri link="http://forums.gentoo.org">Gentoo forums</uri>
206 extremely simple.
207 </p>
208
209 @@ -173,19 +171,18 @@
210
211 <p>
212 If you have a message on one screen and a text-mode web browser on the other,
213
214
215
216 --
217 gentoo-doc-cvs@g.o mailing list